ActionScript 2.0 Components Language Reference |
|
|
|
| NumericStepper component | |||
The NumericStepper component allows a user to step through an ordered set of numbers. The component consists of a number in a text box displayed beside small up and down arrow buttons. When a user presses the buttons, the number is raised or lowered incrementally according to the unit specified in the stepSize parameter, until the user releases the buttons or until the maximum or minimum value is reached. The text in the NumericStepper component's text box is also editable.
|
NOTE |
A NumericStepper component is supported for both ActionScript 2.0 and ActionScript 3.0. This document discusses the version 2 component. If you are using the version 3 component, see Using the NumericStepper in Using ActionScript 3.0 Components. |
The NumericStepper component handles only numeric data. Also, you must resize the stepper while authoring to display more than two numeric places (for example, the numbers 5246 or 1.34).
A stepper can be enabled or disabled in an application. In the disabled state, a stepper doesn't receive mouse or keyboard input. An enabled stepper receives focus if you click it or tab to it and its internal focus is set to the text box. When a NumericStepper instance has focus, you can use the following keys control it:
|
Key |
Description |
|---|---|
|
Down Arrow |
Value changes by one unit. |
|
Left Arrow |
Moves the insertion point to the left within the text box. |
|
Right Arrow |
Moves the insertion point to the right within the text box. |
|
Shift+Tab |
Moves focus to the previous object. |
|
Tab |
Moves focus to the next object. |
|
Up Arrow |
Value changes by one unit. |
For more information about controlling focus, see FocusManager class or Creating custom focus navigation in Using ActionScript 2.0 Components.
A live preview of each stepper instance reflects the setting of the value parameter in the Property inspector or Component inspector during authoring. However, there is no mouse or keyboard interaction with the stepper's arrow buttons in the live preview.
When you add the NumericStepper component to an application, you can use the Accessibility panel to make it accessible to screen readers. First, you must add the following line of code to enable accessibility:
mx.accessibility.NumericStepperAccImpl.enableAccessibility();
You enable accessibility for a component only once, regardless of how many instances you have of the component. For more information, see "Creating accessible content" in Using Flash.
|
|
|
|