Información general sobre ProgressBar (Control, formularios Windows Forms)

  • Artículo

Importante

El control ToolStripProgressBar reemplaza y agrega funcionalidad al control ProgressBar; sin embargo, el control ProgressBar se conserva a efectos de compatibilidad con versiones anteriores y uso futuro, en su caso.

El control ProgressBar de Windows Forms indica el avance de un proceso mostrando un número adecuado de rectángulos dispuestos en una barra horizontal. Una vez finalizado el proceso, la barra estará llena. Las barras de progreso se usan normalmente para dar una idea al usuario de cuánto tiempo debe esperar a que un proceso finalice (por ejemplo, cuando se carga un archivo grande).

Nota

El control ProgressBar solo se puede orientar horizontalmente en el formulario.

Métodos y propiedades clave

Las propiedades clave del control ProgressBar son Value, Minimum y Maximum. Las propiedades Minimum y Maximum establecen los valores mínimo y máximo que puede mostrar la barra de progreso. La propiedad Value representa el progreso que se ha avanzado hacia la finalización de la operación. La barra que se muestra en el control se compone de bloques, de manera que el valor mostrado por el control ProgressBar es solo una aproximación del valor actual de la propiedad Value. Según el tamaño del control ProgressBar, la propiedad Value determina cuándo mostrar el siguiente bloque.

La forma más común de actualizar el valor de progreso actual es escribir código para establecer la propiedad Value. En el ejemplo de carga de un archivo grande, el valor máximo puede establecerse en el tamaño del archivo en kilobytes. Por ejemplo, si la propiedad Maximum está establecida en 100, la propiedad Minimum, en 10 y la propiedad Value, en 50, se mostrarán cinco rectángulos, que es la mitad del número que se puede mostrar.

Aparte de establecer la propiedad Value directamente, existen otras formas de modificar el valor mostrado por el control ProgressBar. La propiedad Step se puede usar para especificar un valor según el que la propiedad Value va incrementándose. A continuación, llamar al método PerformStep incrementará ese valor. Para variar el valor de incremento, puede usar el método Increment y especificar un valor de incremento de la propiedad Value.

Otro control que informa gráficamente al usuario de una acción actual es el control StatusBar.

Importante

Los controles StatusStrip y ToolStripStatusLabel reemplazan a los controles StatusBar y StatusBarPanel agregan funcionalidad, pero los controles StatusBar y StatusBarPanel se conservan por razones de compatibilidad con versiones anteriores y uso en el futuro, si así lo decide.

Consulte también