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 작업 표시줄 단추에 진행률 표시기를 표시하여 장기 실행 작업의 진행률을 전달할 수 있습니다. 표시기의 색은 열거형 값 중 하나를 포함하는 속성에 TaskbarItemProgressState 의해 ProgressState 결정됩니다. 속성이 ProgressState 또는 PausedError속성이 NormalProgressValue 진행률 표시기의 충만성을 결정하는 경우 ProgressValue 의 일부 값은 무시됩니다 ProgressState. Indeterminate 는 전체 작업 표시줄 단추에 걸쳐 펄스 녹색 표시기를 표시합니다. 에 대한 None표시기가 표시되지 않습니다.

다음 그림에서는 82%의 작업 표시줄 진행률 표시 ProgressValue 기를 보여 줍니다.

Windows 작업 표시줄 진행률 표시기