En esta página

ProgressBar QML Type

Indica el progreso de una operación. Más...

Import Statement: import QtQuick.Controls
Inherits:

Control

Propiedades

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.

Véase también to y value.

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.

Véase también from y value.

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.

Véase también position y value.

© 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.