Description
Specifies the style and width of a series' lines in a graph.
Applies to
PowerBuilder DataWindow
DataWindow control
Syntax
PowerBuilder
integer dwcontrol.SetSeriesStyle ( string graphcontrol, string seriesname, LineStyle linestyle {, integer linewidth } )
|
Argument |
Description |
|---|---|
|
dwcontrol |
A reference to the DataWindow control containing the graph. |
|
graphcontrol |
A string whose value is the name of the graph in the DataWindow control. |
|
seriesname |
A string whose value is the name of the series for which you want to set the line style and width. |
|
linestyle |
A value of the LineStyle enumerated datatype (in PowerBuilder) specifying the line style. For a list of values, see LineStyle. |
|
linewidth (optional for PowerBuilder) |
An integer specifying the width of the line in pixels. |
Return value
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.
You can specify the appearance of a series in the graph before the application 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.
Examples
PowerBuilder
This statement sets the line style and width for the series named Costs in the graph gr_product_data in the DataWindow dw_prod:
dw_prod.SetSeriesStyle("gr_product_data", "Costs", &
Dot!, 5)See also
