Getting information about the data – PB Docs 126

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.


Document get from Powerbuilder help
Thank you for watching.
Was this article helpful?
Subscribe
Notify of
guest
0 Comments
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x