다음을 통해 공유


TaskbarItemInfo.ProgressState 속성

정의

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

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

속성 값

작업 표시줄 단추에 진행률 표시기가 표시되는 방법을 나타내는 열거형 값입니다. 기본값은 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 == true)
    {
        // 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 열거형 값입니다. 경우는 ProgressStateNormal, 표시기가 녹색입니다. 때 Paused, 표시기가 노란색입니다. 때 Error에 빨간색 표시기가 있습니다. 이러한 상태에 대 한는 ProgressValue 속성 진행률 표시기가 채워질 작업 표시줄 단추 정도 결정 합니다. ProgressValue 다른 값에 대해 무시 됩니다 ProgressState합니다. Indeterminate 전체 작업 표시줄 단추가 깜박이 녹색 표시기를 보여 줍니다. 에 없는 표시기를 표시할지 None합니다.

다음 그림의 작업 표시줄 진행률 표시기를 Normal 상태입니다.

작업 표시줄 항목 정보 샘플
Windows 작업 표시줄 진행률 표시기

적용 대상