ProgressBar QML Type

Indique la progression d'une opération. En savoir plus…

• 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 la progression 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 « indeterminate » spécial, 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 à l’indicateur « BusyIndicator ». Les deux peuvent être utilisés pour signaler une activité en arrière-plan. La principale différence est d’ordre visuel, et tient au fait que la barre de progression peut également afficher un niveau de progression concret (lorsqu’il est possible de le déterminer). En raison de cette différence visuelle, les barres de progression indéterminées et les indicateurs d’activité occupent des emplacements différents dans les interfaces utilisateur. Emplacements typiques d’une barre de progression indéterminée :

• au bas d’un ToolBar
• intégrée au contenu d’une Page
• dans une zone d’ ItemDelegate pour afficher la progression d’un élément particulier

Voir également Personnalisation des contrôlesProgressBar, BusyIndicator et Indicator.

Documentation sur les propriétés

from : real

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

Voir également to et value.

indeterminate : bool

Cette propriété s'applique que la barre de progression soit ou non en mode indéterminé. Une barre de progression en mode indéterminé indique qu'une opération est en cours, mais ne précise pas le degré d'avancement.

position : real [read-only]

Cette propriété indique la position logique de la barre de progression.

Cette position est exprimée sous forme de fraction de la valeur, dans l'intervalle 0.0 - 1.0. Pour visualiser la progression, il est préférable d'utiliser la propriété « visualPosition », qui prend en compte la lecture de droite à gauche.

Voir également value et visualPosition.

to : real

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

Voir également from et value.

value : real

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

Voir également from, to et position.

visualPosition : real [read-only]

Cette propriété définit la position visuelle de la barre de progression.

La position est exprimée sous forme de fraction de la valeur, comprise entre 0.0 - 1.0. Lorsque le contrôle est en mode « mirrored », visuaPosition est égal à 1.0 - position. Cela permet à visualPosition de visualiser correctement la progression, en tenant compte de la prise en charge de l'écriture de droite à gauche.

Voir également position et value.