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 regularmente. El rango está definido por from y to, que pueden contener cualquier valor.
ProgressBar { value: 0.5 }
ProgressBar también admite un modo especial 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 BusyIndicator. Ambos pueden utilizarse para indicar actividad en segundo plano. La principal diferencia es visual, y que ProgressBar también puede presentar una cantidad concreta de progreso (cuando se puede determinar). Debido a la diferencia visual, las barras de progreso indeterminado y los indicadores de actividad ocupan lugares distintos en las interfaces de usuario. Lugares típicos para una barra de progreso indeterminado
- en la parte inferior de una ToolBar
- en línea dentro del contenido de un Page
- en un ItemDelegate para mostrar el progreso de un elemento concreto
Véase también Personalización de los controlesProgressBar, BusyIndicator, e Indicador.
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 indica si la barra de progreso está en modo indeterminado. Una barra de progreso en modo indeterminado muestra que una operación está en progreso, pero no muestra cuánto se ha avanzado.
position : real [read-only]
Esta propiedad contiene 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, debe utilizarse en su lugar la consciente de derecha a izquierda visualPosition.
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 contiene la posición visual del progreso.
La posición se expresa como una fracción del valor, en el rango 0.0 - 1.0. Cuando el control es mirrored, visuaPosition es igual a 1.0 - position. Esto hace que visualPosition sea adecuado para visualizar el progreso, teniendo en cuenta el soporte 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.