TaskbarItemInfo.ProgressState TaskbarItemInfo.ProgressState TaskbarItemInfo.ProgressState TaskbarItemInfo.ProgressState Property

Definição

Obtém ou define um valor que indica como o indicador de progresso é exibido no botão da barra de tarefas.Gets or sets a value that indicates how the progress indicator is displayed in the taskbar button.

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

Um valor de enumeração que indica como o indicador de progresso é exibido no botão da barra de tarefas.An enumeration value that indicates how the progress indicator is displayed in the taskbar button. O padrão é None.The default is None.

Exemplos

O exemplo a seguir mostra como definir a ProgressState Propriedade no código.The following example shows how to set the ProgressState property in code. O estado é definido no manipulador de um BackgroundWorker.RunWorkerCompleted evento para indicar se a tarefa em segundo plano foi interrompida pelo usuário, finalizada com um erro ou concluída normalmente.The state is set in the handler of a BackgroundWorker.RunWorkerCompleted event to indicate whether the background task was stopped by the user, ended with an error, or completed normally. Este exemplo faz parte de um exemplo maior fornecido para a TaskbarItemInfo classe.This example is part of a larger example provided for the TaskbarItemInfo class.

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 longa exibindo um indicador de progresso em Windows 7Windows 7 um botão da barra de tarefas.You can communicate the progress of long-running tasks by displaying a progress indicator in a Windows 7Windows 7 taskbar button. A cor do indicador é determinada pela ProgressState Propriedade, que contém um TaskbarItemProgressState dos valores de enumeração.The color of the indicator is determined by the ProgressState property, which contains one of the TaskbarItemProgressState enumeration values. Quando o ProgressState estiver Normal, o indicador ficará verde.When the ProgressState is Normal, the indicator is green. Quando Paused, o indicador é amarelo.When Paused, the indicator is yellow. Quando Error, o indicador é vermelho.When Error, the indicator is red. Para esses Estados, a ProgressValue propriedade determina o quanto o botão da barra de tarefas é preenchido pelo indicador de progresso.For these states, the ProgressValue property determines how much of the taskbar button is filled by the progress indicator. ProgressValueé ignorado para outros valores de ProgressState.ProgressValue is ignored for other values of ProgressState. Indeterminatemostra um indicador verde de Pulsing em todo o botão da barra de tarefas.Indeterminate shows a pulsing green indicator across the entire taskbar button. Nenhum indicador é mostrado para None.No indicator is shown for None.

A ilustração a seguir mostra o indicador de progresso da Normal barra de tarefas no estado.The following illustration shows the taskbar progress indicator in the Normal state.

Exemplo de informações de item da barra de tarefasTaskbar Item Info Sample
Indicador de progresso da barra de tarefas do WindowsWindows Taskbar Progress Indicator

Aplica-se a