SAS/AF Software: Class Dictionary

Setting the Action Mode in a Pie Control

Pie controls are interactive. For example, you can zoom the control in or out to change its displayed size, or rotate it to see a different view of it. To perform simple actions, like Pick and Probe, you simply click the control. To perform animation actions, like Zoom and Tilt, you click the control and drag it within its border.

Only one action at a time is available, and the action is set on the actionMode attribute. You can set the action in build mode using the Property sheet, or you can set it in SCL code. For example, for an control named pie1, the following code sets the actionMode attribute to Zoom:

pie1.actionMode = 'zoom';

The following table describes the actions available for a Pie control:

Mode Description

Pick Select a slice and add associated data to the pickList attribute. Selection is made by clicking the slice. Selection can be for a single slice, extended selection, or disabled, depending on setting for selectionMode attribute.

Probe Display data associated with a slices. The data display is controlled by clicking and holding down the mouse button. As the mouse moves over different slices, the display changes.

Move Move the graph within its borders. Movement is controlled by clicking and dragging the mouse.

Rotate Rotate the graph around its center. Movement is controlled by horizontal mouse movement during a click and drag.

Tilt Tilt the graph around its horizontal diameter. Movement is controlled by vertical mouse movement during a click and drag.

Spin Change both the tilt and the rotation angles. Movement is controlled by clicking and dragging the mouse.

Zoom Zooms the graph in or out. Movement is controlled by clicking and dragging the mouse.

Legend Moves legend, or changes legend size. To move, position mouse pointer over the legend's border; when pointer changes to a hand, click and drag. To size, position mouse pointer over the sizing lines on legend border; when pointer changes to a double-headed arrow, click and drag.

DataMove Scrolls the data within the control. Only works for dataDimensions=2D or 3D. Also, only works after zooming the data using DataZoom. Movement is controlled by clicking and dragging the mouse.

DataZoom Zooms into the data to see a subset of the slices more clearly. After a DataZoom, you can use DataMove. Movement is controlled by clicking and dragging the mouse.

Mode	Description
Pick	Select a slice and add associated data to the pickList attribute. Selection is made by clicking the slice. Selection can be for a single slice, extended selection, or disabled, depending on setting for selectionMode attribute.
Probe	Display data associated with a slices. The data display is controlled by clicking and holding down the mouse button. As the mouse moves over different slices, the display changes.
Move	Move the graph within its borders. Movement is controlled by clicking and dragging the mouse.
Rotate	Rotate the graph around its center. Movement is controlled by horizontal mouse movement during a click and drag.
Tilt	Tilt the graph around its horizontal diameter. Movement is controlled by vertical mouse movement during a click and drag.
Spin	Change both the tilt and the rotation angles. Movement is controlled by clicking and dragging the mouse.
Zoom	Zooms the graph in or out. Movement is controlled by clicking and dragging the mouse.
Legend	Moves legend, or changes legend size. To move, position mouse pointer over the legend's border; when pointer changes to a hand, click and drag. To size, position mouse pointer over the sizing lines on legend border; when pointer changes to a double-headed arrow, click and drag.
DataMove	Scrolls the data within the control. Only works for dataDimensions=2D or 3D. Also, only works after zooming the data using DataZoom. Movement is controlled by clicking and dragging the mouse.
DataZoom	Zooms into the data to see a subset of the slices more clearly. After a DataZoom, you can use DataMove. Movement is controlled by clicking and dragging the mouse.

The actions that are available depend on settings within the control. For example, you cannot use the Legend action unless there is a color variable assigned, which is required for displaying a legend.

When you perform an animation action (Move, Rotate, Tilt, Spin, or Zoom), the graph is displayed either as a wire frame or a filled graph. This animation mode affects performance while the user interacts with the control. To control the animation mode, see Setting the Animation Mode in a Pie Control.

Chapter Contents
Previous
Next
Top of Page