Compartir a través de


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

Actualización: noviembre 2007

Nota importante:

El control ToolStripProgressBar viene a reemplazar y a agregar funcionalidad al control ProgressBar; sin embargo, el control ProgressBar se conserva a efectos de compatibilidad con versiones anteriores y uso futuro, según sea el caso.

El control ProgressBar de formularios Windows Forms indica el progreso de un proceso, mediante la presentación de un número adecuado de rectángulos dispuestos en una barra horizontal. Cuando se completa el proceso, la barra se llena. Las barras de progreso suelen utilizarse para dar al usuario una idea de cuánto deberá esperar hasta que se complete un proceso como, por ejemplo, la carga de un archivo grande.

Nota:

El control ProgressBar sólo se puede orientar horizontalmente en el formulario.

Propiedades y métodos principales

Las propiedades principales 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 realizado para completar la operación. Puesto que la barra mostrada en el control se compone de bloques, el valor que muestra el control ProgressBar sólo se aproxima al valor actual de la propiedad Value. En función del tamaño del control ProgressBar, la propiedad Value determina cuándo se muestra el siguiente bloque.

El modo más común de actualizar el valor de progreso actual es escribir código para definir la propiedad Value. En el ejemplo de la carga de un archivo grande, podría establecer el máximo en el tamaño del archivo en kilobytes. Por ejemplo, si la propiedad Maximum se establece en 100, la propiedad Minimum se establece en 10 y la propiedad Value se establece en 50, se mostrarán 5 rectángulos. Este valor es la mitad del número que se puede mostrar.

Sin embargo, hay otros modos de modificar el valor que muestra el control ProgressBar, aparte de establecer la propiedad Value directamente. La propiedad Step se puede utilizar para especificar un valor con el que incrementar la propiedad Value. Así, al llamar al método PerformStep, se incrementará el valor. Para variar el valor del incremento, puede utilizar el método Increment y especificar un valor con el que incrementar la propiedad Value.

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

Nota importante:

Los controles StatusStrip y ToolStripStatusLabel reemplazan a los controles StatusBar y StatusBarPanel, y les agregan funcionalidad; sin embargo, los controles StatusBar y StatusBarPanel se conservan para obtener la compatibilidad con versiones anteriores y para su uso futuro, si se desea.

Vea también

Referencia

ProgressBar

Otros recursos

ProgressBar (Control de formularios Windows Forms)