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 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.
Scrolling behavior in Gauge is dependent on the
maximum allowed value of the Gauge. When the user holds
the scroll key down, the value of the Gauge is increased
/ decreased every 350 milliseconds but the amount that the value is changed
varies according to the following rules:
(maximum , whereGauge value / (total Gauge time
/ key repeat))
maximum Gauge value is the maxValue integer
of the Gauge
total Gauge time is the time it takes to scroll
from minimum to maximum value on the Gauge. The times
are as follows:
8 seconds for maximum values 51-100
12 seconds for maximum values 101-1000
20 seconds for maximum values 1001 or above
key repeat is constantly 350 milliseconds.
The value determined by the above equation is rounded to the nearest multiple of 2, 5, 10, 20, 50, 100, 200..., rounding up.