GetDataPieExplode

Description

Reports the percentage of the pie graph’s radius that a pie slice is moved away from the center of the pie graph. An exploded slice is moved away from the center of the pie in order to draw attention to the data.

Applies to

PowerBuilder DataWindow DataWindow control

DataWindow Web ActiveX DataWindow control

Syntax

PowerBuilder

integer dwcontrol.GetDataPieExplode ( string graphcontrol, integer series, integer datapoint, REF integer percentage )

Web ActiveX

number dwcontrol.GetDataPieExplode ( string graphcontrol, number series, number datapoint )

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
series	The number that identifies the series
datapoint	The number of the exploded data point (that is, the pie slice)
percentage	An integer variable in which you want to store the percentage that the pie slice is exploded

Returns

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

Examples

Example 1

This example reports the percentage that a pie slice is exploded when the user clicks on that slice. The code checks whether the graph is a pie graph using the property GraphType. 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 a graph control:

integer series, datapoint

grObjectType clickedtype

integer percentage

percentage = 50

IF (This.GraphType <> PieGraph! and &

		This.GraphType <> Pie3D!) THEN RETURN

clickedtype = This.ObjectAtPointer(series, &

		datapoint)

IF (series > 0 and datapoint > 0) THEN

		This.GetDataPieExplode("gr_sales_yr", series, &

			datapoint, percentage)

		MessageBox("Explosion Percentage", &

			"Data point " + This.CategoryName(datapoint) &

			+ " in series " + This.SeriesName(series) &

			+ " is exploded " + String(percentage) + "%")

END IF