Información general del control ProgressBar (Formularios Windows Forms)

Importante

El ToolStripProgressBar control reemplaza y agrega funcionalidad al ProgressBar control; sin embargo, el ProgressBar control se conserva tanto para la compatibilidad con versiones anteriores como para el uso futuro, si lo desea.

El control de Windows Forms ProgressBar indica el progreso de un proceso mostrando un número adecuado de rectángulos organizados en una barra horizontal. Una vez completado el proceso, la barra está llena. Las barras de progreso se suelen usar para dar al usuario una idea de cuánto tiempo esperar a que se complete un proceso; por ejemplo, cuando se carga un archivo grande.

Nota:

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

Propiedades y métodos clave

Las propiedades clave del ProgressBar control son Value, Minimumy Maximum. Las Minimum propiedades y Maximum establecen los valores máximos y mínimos que puede mostrar la barra de progreso. La Value propiedad representa el progreso hacia la finalización de la operación. Dado que la barra mostrada en el control se compone de bloques, el valor mostrado por el ProgressBar control solo se aproxima al valor actual de la Value propiedad. En función del tamaño del ProgressBar control, la Value propiedad determina cuándo mostrar el siguiente bloque.

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

Sin embargo, hay otras formas de modificar el valor mostrado por el ProgressBar control, aparte de establecer la Value propiedad directamente. La Step propiedad se puede usar para especificar un valor para incrementar la Value propiedad por. A continuación, llamar al PerformStep método incrementará el valor. Para variar el valor de incremento, puede usar el Increment método y especificar un valor con el que incrementar la Value propiedad.

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

Importante

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

Consulte también

• ProgressBar
• ProgressBar Control