ProgressBar QML Type

Zeigt den Fortschritt einer Operation an. Mehr...

Import Statement: import QtQuick.Controls
Inherits:

Control

Eigenschaften

Ausführliche Beschreibung

ProgressBar zeigt den Fortschritt einer Operation an. Der Wert sollte regelmäßig aktualisiert werden. Der Bereich wird durch from und to definiert, die beide einen beliebigen Wert enthalten können.

ProgressBar {
    value: 0.5
}

ProgressBar unterstützt auch einen speziellen indeterminate -Modus, der z. B. nützlich ist, wenn die Größe des heruntergeladenen Objekts nicht bestimmt werden kann oder wenn der Download-Fortschritt aufgrund einer Netzwerkunterbrechung unterbrochen wird.

ProgressBar {
    indeterminate: true
}

Der unbestimmte Modus ist ähnlich wie BusyIndicator. Beide können verwendet werden, um Hintergrundaktivitäten anzuzeigen. Der Hauptunterschied liegt in der Optik und darin, dass ProgressBar auch einen konkreten Fortschritt anzeigen kann (wenn dieser ermittelt werden kann). Aufgrund des visuellen Unterschieds passen unbestimmte Fortschrittsbalken und Auslastungsanzeigen an unterschiedliche Stellen in Benutzeroberflächen. Typische Orte für einen unbestimmten Fortschrittsbalken:

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

Siehe auch Anpassen von ProgressBar, BusyIndicator und Indicator Controls.

Eigenschaft Dokumentation

from : real

Diese Eigenschaft enthält den Startwert für den Fortschritt. Der Standardwert ist 0.0.

Siehe auch to und value.


indeterminate : bool

Diese Eigenschaft gibt an, ob sich der Fortschrittsbalken im unbestimmten Modus befindet. Ein Fortschrittsbalken im unbestimmten Modus zeigt an, dass ein Vorgang im Gange ist, aber er zeigt nicht an, wie viel Fortschritt gemacht wurde.


position : real [read-only]

Diese Eigenschaft enthält die logische Position des Fortschritts.

Die Position wird als Bruchteil des Wertes im Bereich 0.0 - 1.0 ausgedrückt. Für die Visualisierung des Fortschritts sollte stattdessen die Rechts-nach-Links-Anzeige visualPosition verwendet werden.

Siehe auch value und visualPosition.


to : real

Diese Eigenschaft enthält den Endwert für den Fortschritt. Der Standardwert ist 1.0.

Siehe auch from und value.


value : real

Diese Eigenschaft enthält den Fortschrittswert. Der Standardwert ist 0.0.

Siehe auch from, to und position.


visualPosition : real [read-only]

Diese Eigenschaft gibt die visuelle Position des Fortschritts an.

Die Position wird als Bruchteil des Wertes im Bereich 0.0 - 1.0 ausgedrückt. Wenn das Steuerelement mirrored ist, ist visuaPosition gleich 1.0 - position. Dadurch eignet sich visualPosition für die Visualisierung des Verlaufs, wobei die Unterstützung von rechts nach links berücksichtigt wird.

Siehe auch position und value.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.