Syntax 4: For creating an overlay in a graph
Description
Specifies whether a series is an overlay, meaning that the series
is represented by a line on top of another graph type.
Applies to
Graph controls in windows and user objects, and graphs in
DataWindow controls
Syntax
|
1 |
controlname.SetSeriesStyle ( { graphcontrol, } seriesname, overlaystyle ) |
|
Argument |
Description |
|---|---|
|
controlname |
The name of the graph in which you want to set the |
|
graphcontrol (DataWindow control only) (optional) |
A string whose value is the name of the graph in the |
|
seriesname |
A string whose value is the name of the series whose |
|
overlaystyle |
A boolean value indicating whether you want the series |
Return value
Integer.
Returns 1 if it succeeds and -1 if an error occurs. If any
argument’s value is null, SetSeriesStyle returns null.
Usage
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 the overlay style for a series.
Examples
This statement sets the style of the series named Costs in the
graph gr_product_data to overlay:
|
1 |
gr_product_data.SetSeriesStyle("Costs", TRUE) |
These statements in the Clicked event of the DataWindow control
dw_employees store the style of the series under the pointer in the
graph gr_depts in the variable style_type. If the style of the series is
overlay (true), the script changes the style to normal (false):
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
string SeriesName integer SeriesNbr, Data_Point boolean overlay_style grObjectType MouseHit MouseHit = dw_employees.ObjectAtPointer( & "gr_depts", SeriesNbr, Data_Point) IF MouseHit = TypeSeries! THEN SeriesName = & dw_employees.SeriesName("gr_depts",SeriesNbr) dw_employees.GetSeriesStyle("gr_depts", & SeriesName, overlay_style) IF overlay_style THEN & dw_employees.SetSeriesStyle("gr_depts", & SeriesName, FALSE) END IF |
See also