SAS/AF Software: Class Dictionary

Setting the Action Mode in a Histogram Control

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

histogram1.actionMode = 'zoom';

The following table describes the actions available for a Histogram 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.

Refline Move a reference line. Movement is controlled by clicking and dragging the mouse. Available only at runtime, and only 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.
Refline	Move a reference line. Movement is controlled by clicking and dragging the mouse. Available only at runtime, and only 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 Histogram Control.

Chapter Contents
Previous
Next
Top of Page