Syntax 3 For the fill pattern and symbols in a graph
Description
Specifies the fill pattern and symbol for data markers in
a series.
Controls
Graph controls in windows and user objects, and graphs in
DataWindow controls
Syntax
|
1 |
<span>controlname</span>.<span>SetSeriesStyle</span> ( { <span>graphcontrol</span>, } <span>seriesname</span>, <span>enumvalue</span> ) |
|
Argument |
Description |
|---|---|
|
controlname |
The name of the graph in which you want |
|
graphcontrol (DataWindow control |
A string whose value is the name of the |
|
seriesname |
A string whose value is the name of the |
|
enumvalue |
A value of an enumerated datatype specifying |
|
To change the fill pattern, use a FillPattern
To change the symbol type, use a grSymbolType value:
|
Return Values
Integer. Returns 1 if it succeeds and
-1 if an error occurs. If any argument’s value is null, SetSeriesStyle returns null.
Usage
Data points in a series can have their own style settings.
Settings made with SetDataStyle set the style
of individual data points and override series settings.
The graph stores style information for properties that do
not apply to the current graph type. For example, you can set the
fill pattern in a two–dimensional line graph or the line
style in a bar graph, but that fill pattern or line style will not
be visible.
For a graph in a DataWindow, you can specify the appearance
of a series in the graph before PowerBuilder draws the graph. To
do so, define a user event for pbm_dwngraphcreate and
call SetSeriesStyle in the script for that event.
The event pbm_dwngraphcreate is triggered
just before a graph is created in a DataWindow object.
Using SetSeriesStyle with DirectX 3D Graphs
You cannot use a fill pattern or specify specific symbols
for a series.
Examples
This statement sets the symbol used for the series
named Costs in the graph gr_product_data to
a plus sign:
|
1 |
gr_product_data.<span>SetSeriesStyle</span>("Costs", & |
|
1 |
SymbolPlus!) |
This statement sets the symbol used for the series
named Costs in the graph gr_computers in
the DataWindow control dw_equipment to
X:
|
1 |
dw_equipment.<span>SetSeriesStyle</span>("gr_computers", & |
|
1 |
"Costs", SymbolX!) |