ProgressBar QML Type

Zeigt den Fortschritt eines Vorgangs an. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• from : real
• indeterminate : bool
• position : real
• to : real
• value : real
• visualPosition : real

Ausführliche Beschreibung

ProgressBar zeigt den Fortschritt eines Vorgangs an. Der Wert sollte regelmäßig aktualisiert werden. Der Bereich wird durch „ from “ und „ to “ definiert, die beide beliebige Werte enthalten können.

ProgressBar {
    value: 0.5
}

ProgressBar unterstützt außerdem einen speziellen „ indeterminate “-Modus, der beispielsweise nützlich ist, wenn die Größe des heruntergeladenen Elements nicht bestimmt werden kann oder wenn der Download-Fortschritt aufgrund einer Netzwerkunterbrechung unterbrochen wird.

ProgressBar {
    indeterminate: true
}

Der unbestimmte Modus ähnelt einem „ BusyIndicator “. Beide können verwendet werden, um Hintergrundaktivitäten anzuzeigen. Der Hauptunterschied liegt in der Darstellung, und darin, dass die ProgressBar auch einen konkreten Fortschritt anzeigen kann (sofern dieser ermittelt werden kann). Aufgrund des visuellen Unterschieds eignen sich unbestimmte Fortschrittsbalken und „Busy“-Anzeigen für unterschiedliche Stellen in Benutzeroberflächen. Typische Stellen für einen unbestimmten Fortschrittsbalken:

• am unteren Rand einer ToolBar
• innerhalb des Inhalts einer Seite Page
• in einem „ ItemDelegate “, um den Fortschritt eines bestimmten Elements anzuzeigen

Siehe auch „Anpassen von ProgressBar“, „ BusyIndicator “ und „Indicator-Steuerelemente“.

Dokumentation zu den Eigenschaften

from : real

Diese Eigenschaft enthält den Startwert für den Fortschritt. Der Standardwert lautet „ 0.0 “.

Siehe auch „ to “ und „ value “.

indeterminate : bool

Diese Eigenschaft gilt unabhängig davon, ob sich der Fortschrittsbalken im unbestimmten Modus befindet. Ein Fortschrittsbalken im unbestimmten Modus zeigt an, dass ein Vorgang gerade ausgeführt wird, gibt jedoch keinen Aufschluss darüber, wie weit dieser bereits fortgeschritten ist.

position : real [read-only]

Diese Eigenschaft gibt die logische Position des Fortschritts an.

Die Position wird als Bruchteil des Werts im Bereich 0.0 - 1.0 ausgedrückt. Zur Visualisierung des Fortschritts sollte stattdessen die rechts-nach-links-orientierte Eigenschaft „ visualPosition “ verwendet werden.

Siehe auch value und visualPosition.

to : real

Diese Eigenschaft enthält den Endwert für den Fortschritt. Der Standardwert lautet „ 1.0 “.

Siehe auch from und value.

value : real

Diese Eigenschaft enthält den Fortschrittswert. Der Standardwert lautet „ 0.0 “.

Siehe auch „ from “, „ to “ und „ position “.

visualPosition : real [read-only]

Diese Eigenschaft gibt die visuelle Position des Fortschrittsbalkens an.

Die Position wird als Bruchteil des Werts im Bereich von 0.0 - 1.0 ausgedrückt. Wenn das Steuerelement auf „ mirrored “ gesetzt ist, entspricht visuaPosition dem Wert 1.0 - position. Dadurch eignet sich visualPosition zur Visualisierung des Fortschritts unter Berücksichtigung der Unterstützung für die Schreibrichtung von rechts nach links.

Siehe auch position und value.