TaskbarItemInfo.ProgressValue Свойство

Определение

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

System.Windows.Shell

Сборка:

PresentationFramework.dll

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

public:
 property double ProgressValue { double get(); void set(double value); };

public double ProgressValue { get; set; }

member this.ProgressValue : double with get, set

Public Property ProgressValue As Double

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

Double

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

Примеры

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

void bw_ProgressChanged(object sender, ProgressChangedEventArgs e)
{
    this.tbCount.Text = e.ProgressPercentage.ToString();
    // Update the value of the task bar progress indicator.
    this.taskBarItemInfo1.ProgressValue = (double)e.ProgressPercentage / 100;
}

Private Sub bw_ProgressChanged(ByVal sender As Object, ByVal e As ProgressChangedEventArgs)
    Me.tbCount.Text = e.ProgressPercentage.ToString()
    ' Update the value of the task bar progress indicator.
    Me.taskBarItemInfo1.ProgressValue = e.ProgressPercentage / 100
End Sub

Комментарии

Свойство ProgressValue представлено как значение от 0,0 до 1.0. Числа меньшего и большего размера принужаются к тому, чтобы находиться в пределах этих границ. NaN принудается к 0.

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

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

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