TaskbarItemInfo.ProgressState Propiedad

Definición

Espacio de nombres:

System.Windows.Shell

Ensamblado:

PresentationFramework.dll

Obtiene o establece un valor que especifica el modo en que el indicador de progreso se muestra en el botón de la barra de tareas.

public:
 property System::Windows::Shell::TaskbarItemProgressState ProgressState { System::Windows::Shell::TaskbarItemProgressState get(); void set(System::Windows::Shell::TaskbarItemProgressState value); };

public System.Windows.Shell.TaskbarItemProgressState ProgressState { get; set; }

member this.ProgressState : System.Windows.Shell.TaskbarItemProgressState with get, set

Public Property ProgressState As TaskbarItemProgressState

Valor de propiedad

TaskbarItemProgressState

Valor de enumeración que especifica el modo en que el indicador de progreso se muestra en el botón de la barra de tareas. De manera predeterminada, es None.

Ejemplos

En el siguiente ejemplo, se muestra cómo establecer la propiedad ProgressState en código. El estado se establece en el controlador de un BackgroundWorker.RunWorkerCompleted evento para indicar si el usuario detuvo la tarea en segundo plano, finalizó con un error o se completó normalmente. Este ejemplo forma parte de un ejemplo más grande proporcionado para la TaskbarItemInfo clase .

void bw_RunWorkerCompleted(object sender, RunWorkerCompletedEventArgs e)
{
    // When the task ends, change the ProgressState and Overlay
    // of the taskbar item to indicate a stopped task.
    if (e.Cancelled == true)
    {
        // The task was stopped by the user. Show the progress indicator
        // in the paused state.
        this.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.Paused;
    }
    else if (e.Error != null)
    {
        // The task ended with an error. Show the progress indicator
        // in the error state.
        this.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.Error;
    }
    else
    {
        // The task completed normally. Remove the progress indicator.
        this.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.None;
    }
    // In all cases, show the 'Stopped' overlay.
    this.taskBarItemInfo1.Overlay = (DrawingImage)this.FindResource("StopImage");
}

Private Sub bw_RunWorkerCompleted(ByVal sender As Object, ByVal e As RunWorkerCompletedEventArgs)
    ' When the task ends, change the ProgressState and Overlay
    ' of the taskbar item to indicate a stopped task.
    If e.Cancelled = True Then
        ' The task was stopped by the user. Show the progress indicator
        ' in the paused state.
        Me.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.Paused
    ElseIf e.Error IsNot Nothing Then
        ' The task ended with an error. Show the progress indicator
        ' in the error state.
        Me.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.Error
    Else
        ' The task completed normally. Remove the progress indicator.
        Me.taskBarItemInfo1.ProgressState = TaskbarItemProgressState.None
        ' In all cases, show the 'Stopped' overlay.
        Me.taskBarItemInfo1.Overlay = Me.FindResource("StopImage")
    End If
End Sub

Comentarios

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. ProgressState Cuando es Normal, el indicador es verde. Cuando Paused, el indicador es amarillo. Cuando Error, el indicador es rojo. Para estos estados, la ProgressValue propiedad determina la cantidad del botón de la barra de tareas rellenada por el indicador de progreso. ProgressValue se omite para otros 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 en el Normal estado .

de tareas Ejemplo
Indicador de progreso de la barra de tareas de Windows