Syntax 3 For the fill pattern and symbol of a data point

Description

Specifies the fill pattern and symbol for a data point in
a graph.

Controls

Graph controls in windows and user objects, and graphs in
DataWindow controls

Syntax

<span>controlname</span>.<span>SetDataStyle</span> ( { <span>graphcontrol</span>, } <span>seriesnumber</span>,  <br>    <span>datapointnumber</span>, <span>enumvalue</span> )

1	<span>controlname</span>.<span>SetDataStyle</span> ( { <span>graphcontrol</span>, } <span>seriesnumber</span>, <br> <span>datapointnumber</span>, <span>enumvalue</span> )

Argument	Description
controlname	The name of the graph in which you want to set the appearance of a data point, or the name of the DataWindow containing the graph.
graphcontrol (DataWindow control only) (optional)	A string whose value is the name of the graph in the DataWindow control in which you want to set the appearance.
seriesnumber	The number of the series in which you want to set the appearance of a data point.
datapointnumber	The number of the data point for which you want to set the appearance.
enumvalue	An enumerated datatype specifying the appearance setting for the data point. You can specify a FillPattern or grSymbolType value. To change the fill pattern, use a FillPattern value: Bdiagonal! – Lines from lower left to upper right Diamond! Fdiagonal! – Lines from upper left to lower right Horizontal! Solid! Square! Vertical! To change the symbol type, use a grSymbolType value: NoSymbol! SymbolHollowBox! SymbolX! SymbolStar! SymbolHollowUpArrow! SymbolHollowCircle! SymbolHollowDiamond! SymbolSolidDownArrow! SymbolSolidUpArrow! SymbolSolidCircle! SymbolSolidDiamond! SymbolPlus! SymbolHollowDownArrow! SymbolSolidBox!

Return Values

Integer. Returns 1 if it succeeds and
-1 if an error occurs. If any argument’s value is null, SetDataStyle returns null.

Usage

To change the appearance of a series, use SetSeriesStyle.
The settings you make for the series are the defaults for all data
points in the series.

For a graph in a DataWindow, you can specify the appearance
of a data point in the graph before PowerBuilder draws the graph.
To do so, define a user event for pbm_dwngraphcreate and
call SetDataStyle in the script for that event.
The event pbm_dwngraphcreate is triggered
just before a graph is created in a DataWindow object.

Using SetDataStyle with DirectX 3D Graphs

You cannot use a fill pattern or specify specific symbols
for the data point.

Examples

This example checks the fill pattern used for data
point 10 in the series named Costs in the graph gr_product_data.
If it is diamond, then SetDataStyle changes it
to solid:

integer SeriesNbr

1	integer SeriesNbr

FillPattern data_pattern

1	FillPattern data_pattern

// Get the number of the series

1	// Get the number of the series

SeriesNbr = gr_product_data.FindSeries("Costs")

1	SeriesNbr = gr_product_data.FindSeries("Costs")

// Get the current fill pattern

1	// Get the current fill pattern

gr_product_data.GetDataStyle(SeriesNbr, 10, &amp;

1	gr_product_data.GetDataStyle(SeriesNbr, 10, &

        data_pattern)

1	data_pattern)

// If the pattern is diamond, change it to solid

1	// If the pattern is diamond, change it to solid

IF data_pattern = Diamond! THEN &amp;

1	IF data_pattern = Diamond! THEN &

        gr_product_data.<span>SetDataStyle</span>(SeriesNbr, &amp;

1	gr_product_data.<span>SetDataStyle</span>(SeriesNbr, &

            10, Solid!)

1	10, Solid!)

Syntax 3 For the fill pattern and symbol of a data point – PB Docs 126