ProgressBar QML Type

Indique la progression d'une opération. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

Description détaillée

ProgressBar indique l'état d'avancement d'une opération. La valeur doit être mise à jour régulièrement. La plage est définie par from et to, qui peuvent tous deux contenir n'importe quelle valeur.

ProgressBar {
    value: 0.5
}

ProgressBar prend également en charge un mode spécial indeterminate, qui est utile, par exemple, lorsqu'il est impossible de déterminer la taille de l'élément en cours de téléchargement, ou si la progression du téléchargement est interrompue en raison d'une déconnexion du réseau.

ProgressBar {
    indeterminate: true
}

Le mode indéterminé est similaire au mode BusyIndicator. Les deux modes peuvent être utilisés pour indiquer une activité en arrière-plan. La principale différence est d'ordre visuel, et la barre de progression peut également présenter une progression concrète (lorsqu'elle peut être déterminée). En raison de cette différence visuelle, les barres de progression indéterminées et les indicateurs d'activité occupent des places différentes dans les interfaces utilisateur. Emplacements typiques d'une barre de progression indéterminée :

• au bas d'une page d'accueil ToolBar
• en ligne dans le contenu d'une page Page
• dans une page ItemDelegate pour montrer la progression d'un élément particulier

Voir aussi Personnaliser les contrôlesProgressBar, BusyIndicator et Indicator.

Documentation sur les propriétés

from : real

Cette propriété contient la valeur de départ de la progression. La valeur par défaut est 0.0.

Voir également to et value.

indeterminate : bool

Cette propriété indique si la barre de progression est en mode indéterminé. Une barre de progression en mode indéterminé indique qu'une opération est en cours, mais elle n'indique pas le degré d'avancement.

position : real [read-only]

Cette propriété contient la position logique de la progression.

La position est exprimée sous la forme d'une fraction de la valeur, dans la plage 0.0 - 1.0. Pour visualiser la progression, il convient d'utiliser plutôt la valeur de droite à gauche visualPosition.

Voir également value et visualPosition.

to : real

Cette propriété contient la valeur finale de la progression. La valeur par défaut est 1.0.

Voir également from et value.

value : real

Cette propriété contient la valeur de la progression. La valeur par défaut est 0.0.

Voir aussi from, to, et position.

visualPosition : real [read-only]

Cette propriété indique la position visuelle de la progression.

La position est exprimée sous la forme d'une fraction de la valeur, dans l'intervalle 0.0 - 1.0. Lorsque le contrôle est mirrored, visuaPosition est égal à 1.0 - position, ce qui permet à visualPosition de visualiser la progression en tenant compte du support de droite à gauche.

Voir également position et value.