Getting information about the data

There are quite a few methods for getting information about data in a graph in a DataWindow control at execution time. For all methods, you provide the name of the graph within the DataWindow as the first argument. You can provide your own name for graph controls when you insert them in the DataWindow painter. If the presentation style is Graph, you do not need to name the graph.

PowerBuilder These methods get information about the data and its display. For several of them, an argument is passed by reference to hold the requested information:

**Table 5-1: Common methods for graph DataWindows in PowerBuilder**
Method	Information provided
CategoryCount	The number of categories in a graph
CategoryName	The name of a category, given its number
DataCount	The number of data points in a series
FindCategory	The number of a category, given its name
FindSeries	The number of a series, given its name
GetData	The value of a data point, given its series and position (superseded by GetDataValue, which is more flexible)
GetDataLabelling	The display setting for the data label at a given data point in a DirectX 3D graph
GetDataPieExplode	The percentage at which a pie slice is exploded
GetDataStyle	The color, fill pattern, or other visual property of a specified data point
GetDataTransparency	The transparency percentage of a data point in a DirectX 3D graph
GetDataValue	The value of a data point, given its series and position
GetSeriesLabelling	The display setting for the series label for a given series in a DirectX 3D graph
GetSeriesStyle	The color, fill pattern, or other visual property of a specified series
GetSeriesTransparency	The transparency percentage of a series in a DirectX 3D graph
ObjectAtPointer	The graph element the mouse was positioned over when it was clicked
SeriesCount	The number of series in a graph
SeriesName	The name of a series, given its number

Web ActiveX These methods get information about the data and its display. There are additional helper methods available whenever the equivalent PowerBuilder method uses an argument passed by reference. These helper methods are identified in the second column of the following table (and are described in the DataWindow Reference):

**Table 5-2: Common methods for graph DataWindows in Web ActiveX**
Method	Information provided
CategoryCount	The number of categories in a graph.
CategoryName	The name of a category, given its number.
DataCount	The number of data points in a series.
FindCategory	The number of a category, given its name.
FindSeries	The number of a series, given its name.
ObjectAtPointer	The graph element the mouse was positioned over when it was clicked. Call ObjectAtPointerSeries and ObjectAtPointerDataPoint to get additional information.
SeriesCount	The number of series in a graph.
SeriesName	The name of a series, given its number.
Getting information about a data point’s appearance
GetDataPieExplode	The percentage at which a pie slice is exploded. Call GetDataPieExplodePercentage to retrieve the requested value.
GetDataStyleColor	The color of a specified data point. Call GetDataStyleColorValue to retrieve the requested value.
GetDataStyleFill	The fill pattern of a specified data point. Call GetDataStyleFillPattern to retrieve the requested value.
GetDataStyleLine	The line style and width of a specified data point. Call GetDataStyleLineWidth and GetDataStyleLineStyle to retrieve the requested values.
GetDataStyleSymbol	The symbol of a specified data point. Call GetDataStyleSymbolValue to retrieve the requested value.
Getting a data point’s value
GetDataDate	The value of a data point that contains a date, given its series and position. Call GetDataDateVariable to retrieve the requested value.
GetDataNumber	The value of a numeric data point, given its series and position. Call GetDataNumberVariable to retrieve the requested value.
GetDataString	The value of a string data point, given its series and position. Call GetDataStringVariable to retrieve the requested value.
Getting information about a series’ appearance
GetSeriesStyleColor	The color of a specified series. Call GetSeriesStyleColorValue to retrieve the requested value.
GetSeriesStyleFill	The fill pattern of a specified series. Call GetSeriesStyleFillPattern to retrieve the requested value.
GetSeriesStyleLine	The line style and width used by a specified series. Call GetSeriesStyleLineWidth and GetSeriesStyleLineStyle to retrieve the requested values.
GetSeriesStyleOverlay	Indication whether a series in a graph is an overlay (that is, whether it is shown as a line on top of another graph type). Call GetSeriesStyleOverlayValue to retrieve the requested value.
GetSeriesStyleSymbol	The symbol of a specified series. Call GetSeriesStyleSymbolValue to retrieve the requested value.