SetDataPieExplode method (Graphs in DataWindows)

Description

Explodes a pie slice in a pie graph. The exploded slice is
moved away from the center of the pie, which draws attention to
the data. You can explode any number of slices of the pie.

Controls

PowerBuilder DataWindow DataWindow
control

DataWindow Web ActiveX DataWindow
control

Syntax

[PowerBuilder]

integer <span>dwcontrol</span>.<span>SetDataPieExplode</span> ( string <span>graphcontrol</span>, integer <span>seriesnumber</span>, integer <span>datapoint</span>, integer <span>percentage</span> )

1	integer <span>dwcontrol</span>.<span>SetDataPieExplode</span> ( string <span>graphcontrol</span>, integer <span>seriesnumber</span>, integer <span>datapoint</span>, integer <span>percentage</span> )

[Web ActiveX]

number <span>dwcontrol</span>.<span>SetDataPieExplode</span> ( string <span>graphcontrol</span>, number <span>seriesnumber</span>, number <span>datapoint</span>, number <span>percentage</span> )

1	number <span>dwcontrol</span>.<span>SetDataPieExplode</span> ( string <span>graphcontrol</span>, number <span>seriesnumber</span>, number <span>datapoint</span>, number <span>percentage</span> )

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 that identifies the series.
datapoint	The number of the data point (that is, the pie slice) to be exploded.
percentage	A number between 0 and 100 that is the percentage of the radius that the pie slice is moved away from the center. When percentage is 100, the tip of the slice is even with the circumference of the pie’s circle.

Return Values

Returns 1 if it succeeds and -1 if an error occurs. If any
argument’s value is null, SetDataPieExplode returns
null.

Usage

If the graph is not a pie graph, SetDataPieExplode has
no effect.

Examples

[PowerBuilder]

This example explodes the pie slice under the pointer to 50% when
the user double-clicks within the graph. The code checks the property GraphType
to make sure the graph is a pie graph. It then finds out whether
the user clicked on a pie slice by checking the series and data
point values set by ObjectAtPointer. The script
is for the DoubleClicked event of the DataWindow control:

integer series, datapoint

1	integer series, datapoint

grObjectType clickedtype

1	grObjectType clickedtype

integer percentage

1	integer percentage

percentage = 50

1	percentage = 50

IF (This.GraphType &lt;&gt; PieGraph! AND &amp;

1	IF (This.GraphType <> PieGraph! AND &

        This.GraphType &lt;&gt; Pie3D!) THEN RETURN

1	This.GraphType <> Pie3D!) THEN RETURN

clickedtype = This.ObjectAtPointer( "gr_equipment", &amp;

1	clickedtype = This.ObjectAtPointer( "gr_equipment", &

        series, datapoint)

1	series, datapoint)

IF (series &gt; 0 and datapoint &gt; 0) THEN

1	IF (series > 0 and datapoint > 0) THEN

        This.<span>SetDataPieExplode</span>("gr_equipment", series, &amp;

1	This.<span>SetDataPieExplode</span>("gr_equipment", series, &

            datapoint, percentage)

1	datapoint, percentage)

END IF

END IF

SetDataPieExplode – PB Docs 150