BBjWindow::addPieChart

Description

In BBj 7.00 and higher, this method adds a pie chart control to the BBjWindow.

Syntax

Return Value

Method

BBjPieChart

addPieChart(int ID, number x, number y, number w, number h, boolean showLegend, boolean is3D)

BBjPieChart

addPieChart(int ID, number x, number y, number w, number h, boolean showLegend, boolean is3D, byte[] flags)

BBjPieChart

addPieChart(int controlID, boolean showLegend, boolean is3D)

BBjPieChart

addPieChart(int controlID, boolean showLegend, boolean is3D, byte[] flags)

BBjPieChart

addPieChart(boolean showLegend, boolean is3D)

BBjPieChart

addPieChart(boolean showLegend, boolean is3D, byte[] flags)

Parameters

Variable

Description

ID

Specifies the Control ID number. It must be an integer between 1 and 32767 and be unique within a given top level window.

x

Specifies the horizontal position of the upper-left corner of the control in current units.

y

Specifies the vertical position of the upper-left corner of the control in current units.

width

Specifies the width of the control in current units.

height

Specifies the height of the control in current units.

showLegend

Indicates whether a default legend should be displayed.
0 = Do not show legend
1 = Show legend

is3D

Indicates whether the chart should be rendered in 3 dimensions.
0 = Do not render in 3D
1 = Render in 3D

Note:

This parameter is ignored in BBj 23.00 and higher; 3d charts are not supported in JFreeChart 1.5.x.

flags

Set control flags, as follows:

Flag Description
$0001$ Sets the control to be initially disabled.
$0010$ Sets the control to be initially invisible.
$0800$ Draws a recessed client edge around the control.
$1000$ Draws a raised edge around the control.

Return Value

Returns the created BBjPieChart object.

Remarks

If the ID parameter is not specified, a control ID is assigned dynamically using getAvailableControlID().

If the x, y, width, and height parameters are not specified, they're all initialized to 0. This is typically for use with DWC windows that dynamically arrange their contents (window creation flag $00100000$).

Example

rem 'BBjPieChart demo: Graph time spent in the lead for the Soapbox Derby

declare BBjPieChart pieChart!
declare BBjWindow win!
declare BBjSysGui sysgui!
declare BBjNumber sysgui
declare BBjSystemMetrics sysMetrics!
declare BBjNumber height
declare BBjNumber width
declare BBjNumber numSlices
declare BBjNumber slices_ctr
declare BBjNumber value
declare BBjNumber total

declare java.awt.Dimension screenDimension!

rem 'instantiate the window and chart to take up a quarter screen
sysgui=unt
open (sysgui) "X0"
sysgui!=BBjAPI().getSysGui()

sysMetrics!=sysgui!.getSystemMetrics()
screenDimension!=sysMetrics!.getScreenSize()
width=int(screenDimension!.getWidth()/2)
height=int(screenDimension!.getHeight()/2)

win!=sysgui!.addWindow(10,10,width,height,"BBjPieChart Sample",$00090083$)
win!.setCallback(win!.ON_CLOSE,"end_demo")

numSlices=3
pieChart!=win!.addPieChart(101,10,10,width-20,height-20,sysgui!.TRUE,sysgui!.TRUE)

pieChart!.setTitle("Soapbox Derby: Time spent in the lead")

rem 'Populate the chart with data for each car
total=0
for slices_ctr=1 to numSlices-1
    value=(1-total)*rnd(0)
    total=total+value
    pieChart!.setSliceValue("Soapbox #"+str(slices_ctr),value)
next slices_ctr
pieChart!.setSliceValue("Soapbox #"+str(slices_ctr),1-total)

print "The Chart's title is ",$22$,pieChart!.getTitle(),$22$

process_events

end_demo:
release

See Also

BBjAPI

BBjSysGui

BBjControl

BBjPieChart

See the BBj Object Diagram for an illustration of the relationship between BBj Objects.