TaskbarItemInfo.ProgressState Propriedade

Definição

Namespace:

System.Windows.Shell

Assembly:

PresentationFramework.dll

Obtém ou define um valor que indica como o indicador de progresso é exibido no botão da barra de tarefas.

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 da propriedade

TaskbarItemProgressState

Um valor de enumeração que indica como o indicador de progresso é exibido no botão da barra de tarefas. O padrão é None.

Exemplos

O exemplo a seguir mostra como definir a propriedade ProgressState no código. O estado é definido no manipulador de um BackgroundWorker.RunWorkerCompleted evento para indicar se a tarefa em segundo plano foi interrompida pelo usuário, terminou com um erro ou foi concluída normalmente. Este exemplo faz parte de um exemplo maior fornecido para a TaskbarItemInfo classe .

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

Comentários

Você pode comunicar o progresso de tarefas de execução prolongada exibindo um indicador de progresso em um botão da barra de tarefas do Windows 7. A cor do indicador é determinada pela ProgressState propriedade , que contém um dos TaskbarItemProgressState valores de enumeração. Quando o ProgressState é Normal, o indicador é verde. Quando Paused, o indicador é amarelo. Quando Error, o indicador fica vermelho. Para esses estados, a ProgressValue propriedade determina quanto do botão da barra de tarefas é preenchido pelo indicador de progresso. ProgressValue é ignorado para outros valores de ProgressState. Indeterminate mostra um indicador verde pulsante em todo o botão da barra de tarefas. Nenhum indicador é mostrado para None.

A ilustração a seguir mostra o indicador de progresso da barra de tarefas no Normal estado .

Exemplo de informações de de tarefas Exemplo de
Indicador de Progresso da Barra de Tarefas do Windows