TaskbarItemInfo.ProgressState Свойство

Определение

Пространство имен:

System.Windows.Shell

Сборка:

PresentationFramework.dll

Получает или задает значение, указывающее способ отображения индикатора хода выполнения на кнопке панели задач.

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

Значение свойства

TaskbarItemProgressState

Значение перечисления, указывающее способ отображения индикатора хода выполнения на кнопке панели задач. Значение по умолчанию — None.

Примеры

В следующем примере кода показана установка свойства ProgressState в коде. Состояние задается в обработчике BackgroundWorker.RunWorkerCompleted события, чтобы указать, была ли фоновая задача остановлена пользователем, завершена ли с ошибкой или выполнена обычным образом. Этот пример является частью более крупного примера, предоставленного TaskbarItemInfo для класса .

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

Комментарии

Вы можете сообщить о ходе выполнения длительных задач, отображая индикатор хода выполнения на кнопке панели задач Windows 7. Цвет индикатора определяется свойством ProgressState , которое содержит одно из значений TaskbarItemProgressState перечисления. ProgressState Если имеет значение Normal, индикатор имеет зеленый цвет. Если Pausedзадано значение , индикатор имеет желтый цвет. Если Errorзадано значение , индикатор имеет красный цвет. Для этих состояний ProgressValue свойство определяет, какая часть кнопки панели задач заполняется индикатором хода выполнения. ProgressValue игнорируется для других значений ProgressState. Indeterminate отображает пульсирующий зеленый индикатор на всей кнопке панели задач. Индикатор для Noneне отображается.

На следующем рисунке показан индикатор хода выполнения панели задач в Normal состоянии .

Индикатор хода выполнения панели задач Windows