Description
Specifies the style and width of a data point's line in a graph.
Applies to
PowerBuilder DataWindow
DataWindow control
Syntax
PowerBuilder
integer dwcontrol.SetDataStyle ( string graphcontrol, integer seriesnumber, integer datapointnumber, 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. |
|
seriesnumber |
The number of the series in which you want to set the line style and width of a data point. |
|
datapointnumber |
The number of the data point for which you want to set the line style and width. |
|
linestyle |
A value of the LineStyle enumerated datatype (in PowerBuilder) specifying a line style pattern of dots, dashes, and solid lines. For a list of line style values, see LineStyle. |
|
linewidth (optional for PowerBuilder) |
An integer whose value is 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, 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.
You can specify the appearance of a data point in the graph before the application 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.
Examples
PowerBuilder
This example checks the line style used for data point 10 in the series named Costs in the graph gr_computers in the DataWindow control dw_equipment. If it is dash-dot, the SetDataStyle sets it to continuous. The line width stays the same:
integer SeriesNbr, line_width
LineStyle line_style
// Get the number of the series
SeriesNbr = dw_equipment.FindSeries( &
"gr_computers", "Costs")
// Get the current line style
dw_equipment.GetDataStyle("gr_computers", &
SeriesNbr, 10, line_style, line_width)
// If the pattern is dash-dot, change to continuous
IF line_style = DashDot! THEN &
dw_equipment.SetDataStyle("gr_computers", &
SeriesNbr, 10, Continuous!, line_width)See also
