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 1 つを含む プロパティによってProgressState決まります。 プロパティが ProgressState 、、Pausedまたは Errorの場合、NormalProgressValue進行状況インジケーターの完全性が決定されます。 ProgressValue の一部の ProgressState値は無視されます。 Indeterminate は、タスク バー ボタン全体に点滅する緑色のインジケーターを示しています。 のインジケーターは表示 Noneされません。

次の図は、 が 82% のタスク バー進行状況インジケーター ProgressValue を示しています。

Windows タスク バーの進行状況インジケーター