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

Véase también to y value.

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.

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

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.