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)
    {
        // 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