ProgressBar QML Type
Indica el progreso de una operación. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
- from : real
- indeterminate : bool
- position : real
- to : real
- value : real
- visualPosition : real
Descripción detallada
ProgressBar indica el progreso de una operación. El valor debe actualizarse periódicamente. El rango viene definido por from y to, que pueden contener cualquier valor.
ProgressBar {
value: 0.5
}ProgressBar también admite un modo especial de « indeterminate », que resulta útil, por ejemplo, cuando no se puede determinar el tamaño del elemento que se está descargando o si el progreso de la descarga se interrumpe debido a una desconexión de la red.
ProgressBar {
indeterminate: true
}El modo indeterminado es similar a un indicador de « BusyIndicator ». Ambos pueden utilizarse para indicar actividad en segundo plano. La principal diferencia es visual, y es que ProgressBar también puede mostrar un porcentaje concreto de progreso (cuando se pueda determinar). Debido a esta diferencia visual, las barras de progreso indeterminadas y los indicadores de actividad ocupan lugares distintos en las interfaces de usuario. Lugares típicos para una barra de progreso indeterminada:
- en la parte inferior de un ToolBar
- dentro del contenido de un Page
- en un « ItemDelegate » para mostrar el progreso de un elemento concreto
Véase también Personalización de ProgressBar, BusyIndicator y controles Indicator.
Documentación de propiedades
from : real
Esta propiedad contiene el valor inicial del progreso. El valor por defecto es 0.0.
indeterminate : bool
Esta propiedad se mantiene independientemente de si la barra de progreso se encuentra en modo indeterminado. Una barra de progreso en modo indeterminado indica que se está llevando a cabo una operación, pero no muestra el grado de avance alcanzado.
position : real [read-only]
Esta propiedad indica la posición lógica del progreso.
La posición se expresa como una fracción del valor, en el rango 0.0 - 1.0. Para visualizar el progreso, se debe utilizar en su lugar el elemento visualPosition, que tiene en cuenta la dirección de lectura de derecha a izquierda.
Véase también value y visualPosition.
to : real
Esta propiedad contiene el valor final del progreso. El valor por defecto es 1.0.
value : real
Esta propiedad contiene el valor de progreso. El valor por defecto es 0.0.
Véase también from, to y position.
visualPosition : real [read-only]
Esta propiedad indica la posición visual del indicador de progreso.
La posición se expresa como una fracción del valor, en el rango 0.0 - 1.0. Cuando el control está en modo « mirrored », visuaPosition es igual a 1.0 - position. Esto hace que visualPosition sea adecuado para visualizar el progreso, teniendo en cuenta la compatibilidad con la escritura de derecha a izquierda.
© 2026 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.