다음을 통해 공유


TaskbarItemInfo.ProgressValue 속성

정의

작업 표시줄 단추에 진행률 표시기의 진행 정도를 나타내는 값을 가져오거나 설정합니다.

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

속성 값

작업 표시줄 단추에서 진행률 표시기의 진행 정도를 나타내는 값입니다. 기본값은 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 작업 표시줄 진행률 표시기

적용 대상