Compartir a través de


TaskbarItemInfo.ProgressValue Propiedad

Definición

Obtiene o establece un valor que indica el llenado del indicador de progreso del botón de la barra de tareas.

public:
 property double ProgressValue { double get(); void set(double value); };
public double ProgressValue { get; set; }
member this.ProgressValue : double with get, set
Public Property ProgressValue As Double

Valor de propiedad

Valor que indica el llenado del indicador de progreso del botón de la barra de tareas. El valor predeterminado es 0.

Ejemplos

En el siguiente ejemplo, se muestra cómo establecer la propiedad ProgressValue en código. El valor se establece en el controlador de un BackgroundWorker.ProgressChanged evento para indicar el progreso actual de la tarea en segundo plano. Este ejemplo forma parte de un ejemplo más grande proporcionado para la TaskbarItemInfo clase .

void bw_ProgressChanged(object sender, ProgressChangedEventArgs e)
{
    this.tbCount.Text = e.ProgressPercentage.ToString();
    // Update the value of the task bar progress indicator.
    this.taskBarItemInfo1.ProgressValue = (double)e.ProgressPercentage / 100;
}
Private Sub bw_ProgressChanged(ByVal sender As Object, ByVal e As ProgressChangedEventArgs)
    Me.tbCount.Text = e.ProgressPercentage.ToString()
    ' Update the value of the task bar progress indicator.
    Me.taskBarItemInfo1.ProgressValue = e.ProgressPercentage / 100
End Sub

Comentarios

La ProgressValue propiedad se representa como un valor entre 0,0 y 1,0. Los números más pequeños y mayores se coercieron para estar dentro de esos límites. NaN se convierte en 0.

Puedes comunicar el progreso de las tareas de larga duración mostrando un indicador de progreso en un botón de barra de tareas de Windows 7. El color del indicador viene determinado por la ProgressState propiedad , que contiene uno de los TaskbarItemProgressState valores de enumeración. Si la ProgressState propiedad es Normal, Pausedo Error, la ProgressValue propiedad determina la totalidad del indicador de progreso. ProgressValue se omite para algunos valores de ProgressState. Indeterminate muestra un indicador verde pulsante en todo el botón de la barra de tareas. No se muestra ningún indicador para None.

En la ilustración siguiente se muestra el indicador de progreso de la barra de tareas con un ProgressValue 82 por ciento.

Ejemplo de información de elemento de la barra de tareas Ejemplo
Indicador de progreso de la barra de tareas de Windows

Se aplica a