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или Error, ProgressValue свойство определяет полноту индикатора хода выполнения. ProgressValue игнорируется для некоторых значений ProgressState. Indeterminate отображает пульсирующий зеленый индикатор на всей кнопке панели задач. Индикатор для Noneне отображается.

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

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