SAS/AF Software: Class Dictionary

Setting the Action Mode in a Chart Control

Chart 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 chart1, the following code sets the actionMode attribute to Zoom:

chart1.actionMode = 'zoom';

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

Mode Description

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

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

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

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

Tilt Tilt the graph around the horizontal axis. 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.

BoxRotate Rotates all the boxes in a box chart (available only for box charts)

DataMove Scrolls the data within the axes. For 3D and 3DPerspective, scrolls only in X-Axis. Also, only works after zooming the data using DataZoom or ViewPort. Movement is controlled by clicking and dragging the mouse.

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

Viewport Zooms into part of the data by dragging a rectangle around it. After a Viewport, you can use DataMove. Movement is controlled by clicking and dragging the mouse. Available only at runtime, and only for 2D X-Y charts and plots, if viewMode=2D or viewMode=3D.

Refline Move a reference line (not available in build mode). Movement is controlled by clicking and dragging the mouse. Available only at runtime, and only for 2D X-Y charts and plots, if viewMode=2D or viewMode=3D.

Mode	Description
Pick	Select a bar and add associated data to the pickList attribute. Selection is made by clicking the bar. Selection can be for a single bar, extended selection, or disabled, depending on setting for selectionMode attribute.
Probe	Display data associated with a bar. The data display is controlled by clicking and holding down the mouse button. As the mouse moves over different bars, the display changes.
Move	Move the graph within its borders. Movement is controlled by clicking and dragging the mouse.
Rotate	Rotate the graph around the vertical axis. Movement is controlled by horizontal mouse movement during a click and drag.
Tilt	Tilt the graph around the horizontal axis. 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.
BoxRotate	Rotates all the boxes in a box chart (available only for box charts)
DataMove	Scrolls the data within the axes. For 3D and 3DPerspective, scrolls only in X-Axis. Also, only works after zooming the data using DataZoom or ViewPort. Movement is controlled by clicking and dragging the mouse.
DataZoom	Zooms into the data to see a subset of the bars more clearly. After a DataZoom, you can use DataMove. Movement is controlled by clicking and dragging the mouse.
Viewport	Zooms into part of the data by dragging a rectangle around it. After a Viewport, you can use DataMove. Movement is controlled by clicking and dragging the mouse. Available only at runtime, and only for 2D X-Y charts and plots, if viewMode=2D or viewMode=3D.
Refline	Move a reference line (not available in build mode). Movement is controlled by clicking and dragging the mouse. Available only at runtime, and only for 2D X-Y charts and plots, if viewMode=2D or viewMode=3D.

The actions that are available depend on settings within the control. For example, you can rotate or tilt a graph, but it only makes sense to do so when the viewMode is 3DPerspective, which provides three true data dimensions. If the viewMode is set to 3D, the actions Tilt, Rotate, and Spin are not possible. However, rather than generate an error or be ignored, each action simply changes the projectionAngle attribute, which determines the angle of the projection that provides the illusion of a third dimension.

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 Chart Control.

Chapter Contents
Previous
Next
Top of Page