Gauge

A Gauge component implements a graphical display, such as a bar graph, of an integer value. The Gauge component contains a current value that is between zero and the maximum value. The application can control the current value and maximum value. The range of values specified by the application may be larger than the number of distinct visual states possible on the device, so more than one value may have the same visual representation. Gauge components reserve the whole screen width and no other components can exist on the same line.

Gauges are either interactive or non-interactive and their appearance reflects this. An interactive Gauge has a slider whereas a non-interactive Gauge is displayed as a progress bar.

Source code for the example:

import javax.microedition.midlet.*;
import javax.microedition.lcdui.*;

public class ExampleForm2 extends MIDlet implements CommandListener {
    private Form form;
    private Command exit;    

    public ExampleForm2() {
        form = new Form("Form example 2");
    //  Gauge(label, active, value, maxValue);
        Gauge aGauge = new Gauge("Active Gauge", true, 40, 31);
        Gauge pGauge = new Gauge("Passive Gauge", false, 20, 2);
        form.append(aGauge);
        form.append(pGauge);
        exit = new Command("Exit", Command.EXIT, 1);
        form.addCommand(exit);
		  form.setCommandListener(this);
    }
    
    public void startApp() {
        Display display = Display.getDisplay(this);
        display.setCurrent(form);
    }
    public void pauseApp() {
    }
    public void destroyApp(boolean unconditional) {
    }
    public void commandAction(Command command, Displayable displayable) {
        if (command == exit) {
            destroyApp(false);
            notifyDestroyed();
        }
    }
}

Another example of a Gauge is found in the LCDUI SimpleTest MIDlet.

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.

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