Syntax 1: For setting a series’ colors
Description
Specifies the colors of a series in a graph.
Applies to
Graph controls in windows and user objects, and graphs in
DataWindow controls
Syntax
|
1 |
controlname.SetSeriesStyle ( { graphcontrol, } seriesname, colortype, color ) |
|
Argument |
Description |
|---|---|
|
controlname |
The name of the graph in which you want to set the color |
|
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 for which |
|
colortype |
A value of the grColorType enumerated datatype
|
|
color |
A long specifying the new color for colortype. |
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
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 can only set the color for the foreground. Background, line
color, and shade are not supported.
Examples
This statement sets the text (foreground) color of the series
named Salary in the graph gr_emp_data to black:
|
1 2 |
gr_emp_data.SetSeriesStyle("Salary", & Foreground!, 0) |
This statement sets the background color of the series named
Salary in the graph gr_depts in the DataWindow control dw_employees to
black:
|
1 2 |
dw_employees.SetSeriesStyle("gr_depts", & "Salary", Background!, 0) |
These statements in the Clicked event of the graph control
gr_product_data coordinate line color between it and the graph
gr_sales_data. The script stores the line color for the series under the
mouse pointer in the graph gr_product_data in the variable line_color.
Then it sets the line color for the series northeast in the graph
gr_sales_data to that color:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
string SeriesName integer SeriesNbr, Series_Point long line_color grObjectType MouseHit MouseHit = ObjectAtPointer(SeriesNbr,Series_Point) IF MouseHit = TypeSeries! THEN SeriesName = & gr_product_data.SeriesName(SeriesNbr) gr_product_data.GetSeriesStyle(SeriesName, & LineColor!, line_color) gr_sales_data.SetSeriesStyle("Northeast", & LineColor!, line_color) END IF |
See also