Gauge

In styles with four-way navigation, the user interaction with interactive Gauge is done with left and right arrow keys.

• Pressing arrow left reduces the Gauge value by one, and respectively, pressing arrow right adds to the Gauge value by one.

• If the key press on scroll key is long, the key repeat function adds or subtracts repeatedly.

In styles with only two-way navigation, a separate editing screen can be used for Gauge value editing.

The interactive Gauge value may also be directly edited; this may be possible, for example, with direct manipulation of Gauge with a pointer or a numeric keypad if number entry is allowed.

INDEFINITE Gauge defines a stateless progress bar or progress animation. It can be set in one of the four modes:

• CONTINUOUS_IDLE

  Doesn’t present animation but the visual appearance clearly indicates that there is no work in progress.

• INCREMENTAL_IDLE

• CONTINUOUS_RUNNING

  Automatically animated progress animation without state information.

• INCREMENTAL_UPDATING

  Allows applications to control the animation directly. Each call to Gauge setValue(Gauge.INCREMENTAL_UPDATING) must step one frame forward in the animation. Animation loops if the end of it is reached.

The states CONTINUOUS_IDLE and INCREMENTAL_IDLE look exactly the same if CONTINUOUS_RUNNING and INCREMENTAL_UPDATING use the same animation. The only difference is that in continuous running, the animation is automatically updated by implementation and in incremental updating, the animation is updated by the MIDlet via calls to Gauge.setValue.

From S60 3rd Edition FP 2 onwards, the progress bar of non-interactive Gauge is centered on the Form.