TaskbarItemInfo.ProgressState Tulajdonság

Definíció

Névtér:

System.Windows.Shell

Szerelvény:

PresentationFramework.dll

Lekéri vagy beállít egy értéket, amely jelzi, hogy a folyamatjelző hogyan jelenik meg a tálcán gombon.

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

Tulajdonság értéke

TaskbarItemProgressState

Enumerálási érték, amely azt jelzi, hogy a folyamatjelző hogyan jelenik meg a tálcán gombon. Az alapértelmezett érték a None.

Példák

Az alábbi példa bemutatja, hogyan állíthatja be a tulajdonságot kódban ProgressState . Az állapot egy BackgroundWorker.RunWorkerCompleted esemény kezelőjében van beállítva, amely jelzi, hogy a háttérfeladatot a felhasználó leállította-e, hibával fejeződött-e be, vagy normál módon fejeződött-e be. Ez a példa egy nagyobb, az TaskbarItemInfo osztályhoz tartozó példa része.

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)
    {
        // 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

Megjegyzések

A hosszú ideig futó tevékenységek előrehaladását egy Windows 7 tálcán megjelenő állapotjelzővel közölheti. A mutató színét a ProgressState tulajdonság határozza meg, amely az TaskbarItemProgressState enumerálási értékek egyikét tartalmazza. Ha igen ProgressStateNormal, a mutató zöld. Amikor Pauseda mutató sárga. Amikor Errora mutató piros. Ezekben az állapotokban a ProgressValue tulajdonság határozza meg, hogy a tálcagomb mekkora részét tölti ki a folyamatjelző. ProgressValuea rendszer figyelmen kívül hagyja a . többi értékére vonatkozóan.ProgressState Indeterminate egy lüktető zöld jelzést jelenít meg a teljes tálcagombon. Nem jelenik meg mutató a következőhöz None: .

Az alábbi ábrán a tálca állapotjelzője Normal látható.

Windows Tálca állapotjelzője