XdevProgressBar

Anfang  Zurück  Vor

Letzte Änderung 21.01.2014

 

Mit Hilfe der Komponente XdevProgressbar können Sie dem Anwender in Form eines grafischen Fortschrittbalkens  ein Feedback geben, wie weit ein interner, i.d.R. für den Anwender unsichtbarer Vorgang bereits fortgeschritten ist. Die Komponente Progressbar kommt nahezu in jeder Anwendung vor, denn sie zählt zu den Features, die enorm wichtig für die Anwenderfreundlichkeit einer Software-Anwendung sind und deren Bedeutung man keinesfalls unterschätzen sollte.

 

clip0132

 

 

Wichtige Eigenschaften

 

Beschriftung - Der Text wird direkt im Fortschrittsbalken angezeigt.

Minimum - Der Fortschrittsbalken startet bereits bei diesem Wert.

Maximum - Der Fortschrittsbalken läuft nur bis zu diesem Wert.

Unbestimmte Anzeige - Der Balken zeigt nur an, dass er beschäftigt ist, nicht aber den Status.

Beschriftung Anzeigen - Beschriftung wird in der Mitte des Balkens angezeigt. Standard ist die Prozentangabe.

 

 

 

Wichtigste Methoden

 

getValue() : int

 

Gibt den aktuellen Wert des der XdevProgressBar zurück.

Rückgabewert: Der Wert, der XdevProgressBar als int.

// Gibt den akuell ausgewählten Wert des der XdevProgressBar zurück
int pBValue = progressBar.getValue();

 

setValue(int n)

 

Legt den angezeigten Wert der XdevProgressBar fest. Wird ein Wert übergeben, der größer als der Maximale, bzw. kleiner als der minmale Anzeigewert des XdevProgressBar ist, so wird entweder der kleinste bzw. größte mögliche Wert gesetzt.

n - Der Wert, der auf der XdevProgressBar-Komponente angezeigt werden soll.

// Setzt den angezeigten Wert der XdevProgressBar auf 50
progressBar.setValue(50);

 

setMinimum(int n)

 

Legt den minimalen Wert für den Slider fest. Falls der bisherige Wert bzw. das Maximum nicht richtig übereinstimmen, werden diese Werte an das neue Minimum angepasst.

n - Der Wert, der den kleinstmöglichen Anzeigewert definiert.

// Setzt den minimalen Wert der XdevProgressBar auf 20
progressBar.setMinimum(20);

 

setMaximum(int n)

 

Legt den maximalen Wert für die XdevProgressBar fest. Falls der bisherige Wert bzw. das Minimum nicht richtig übereinstimmen, werden diese Werte an das neue Maximum angepasst.

n - Der Wert, der den höchstmöglichen Anzeigewert definiert.

// Setzt den maximalen Wert der XdevProgressBar auf 200
progressBar.setMaximum(200);

 

setString(String s)

 

Legt den übergebenen String als angezeigten Text der XdevProgressBar fest.

s - Der Wert, der auf der XdevProgressBar-Komponente angezeigt werden soll.

// Legt "100%" als angezeigten Text für die XdevProgressBar fest
progressBar.setString("100%");

 

setIndeterminate(boolean newValue)

 

Legt fest, ob die XdevProgressBar eine unbestimmte Anzeige ist, d.h. dass kein spezifischer Wert, sondern eine sich wiederholende Balkenanimation angezeigt wird.

newValue - Der boolsche Wert, der angibt, ob die XdevProgressBar unbestimmt oder bestimmt angezeigt wird. Der Wert true setzt die Komponente auf unbestimmt, false auf bestimmt.

// Legt fest, dass die XdevProgressBar als unbestimmte Anzeige fungiert
progressBar.setIndeterminate(true);