C# Windows 7任务栏开发之进度条(Progress Bar)

      Windows 7 任务栏为我们增添了许多其他功能：Jump Lists，Window Preview，Progress Bar，Overlay Icon 等等。

      新任务栏的功能使我们的操作更加方便快捷，微软提供了方便的工具Windows API Code Pack for .NET Framework 来帮助我们完成这些开发,程序中增加Microsoft.WindowsAPICodePack.dll 和Microsoft.WindowsAPICodePack.Shell.dll。

      在使用IE 下载文件时，任务栏图标会同步显示当前下载进度（如下图）。那么在应用程序中如何实现这个效果呢？

TaskbarManager.SetProgressValue 方法

      在TaskbarManager 类中有三种不同方式使用SetProgressValue 方法来设置进度条当前位置，其中currentValue 为进度条当前位置的参数，maximumValue 为最大参数：

//设置当前窗口
public void SetProgressValue(int currentValue, int maximumValue)
{
    CoreHelpers.ThrowIfNotWin7();
    TaskbarList.SetProgressValue(OwnerHandle, Convert.ToUInt32(currentValue), 
                                 Convert.ToUInt32(maximumValue));
}

//设置指定窗口
public void SetProgressValue(int currentValue, int maximumValue, 
                             IntPtr windowHandle)
{
    CoreHelpers.ThrowIfNotWin7();
    TaskbarList.SetProgressValue(windowHandle, Convert.ToUInt32(currentValue), 
                                 Convert.ToUInt32(maximumValue));
}

//设置指定WPF窗口
public void SetProgressValue(int currentValue, int maximumValue, 
                             System.Windows.Window window)
{
    CoreHelpers.ThrowIfNotWin7();

    TaskbarList.SetProgressValue(
        (new WindowInteropHelper(window)).Handle,
        Convert.ToUInt32(currentValue),
        Convert.ToUInt32(maximumValue));
}

TaskbarProgressBarState 进度条状态

       除了常见的绿色（Normal 正常状态）外，还可以通过调用枚举TaskbarProgressBarState 使用其他几种状态，请参看下表：

名称	描述
NoProgress	不显示进度条
Indeterminate	不定值进度条（处于滚动状态）
Normal	正常状态（绿色）
Error	错误状态（红色）
Paused	暂停状态（黄色）

TaskbarManager.SetProgressState 方法

      如何为进度条设置以上状态呢？当然TaskbarManager 也同样提供了三种不同的方式使用SetProgressState 方法，对进度条状态进行相应的设置：

//设置当前窗口状态
public void SetProgressState(TaskbarProgressBarState state)
{
    CoreHelpers.ThrowIfNotWin7();
    TaskbarList.SetProgressState(OwnerHandle, (TBPFLAG)state);
}

//设置指定窗口状态
public void SetProgressState(TaskbarProgressBarState state, IntPtr windowHandle)
{
    CoreHelpers.ThrowIfNotWin7();
    TaskbarList.SetProgressState(windowHandle, (TBPFLAG)state);
}

//设置指定WPF窗口状态
public void SetProgressState(TaskbarProgressBarState state, 
                             System.Windows.Window window)
{
    CoreHelpers.ThrowIfNotWin7();
    TaskbarList.SetProgressState(
        (new WindowInteropHelper(window)).Handle,
        (TBPFLAG)state);
}

效果演示

       下面只需要在程序中使用以上方法便可实现对进度条的控制，下面代码通过Slider 调节进度条当前数值：

/// <summary>
/// 初始化进度条状态
/// </summary>
private void InitProgressStates()
{
    _progressBarStatus.Items.Add(TaskbarProgressBarState.NoProgress);
    _progressBarStatus.Items.Add(TaskbarProgressBarState.Indeterminate);
    _progressBarStatus.Items.Add(TaskbarProgressBarState.Normal);
    _progressBarStatus.Items.Add(TaskbarProgressBarState.Error);
    _progressBarStatus.Items.Add(TaskbarProgressBarState.Paused);
    _progressBarStatus.SelectedIndex = 2;
}

/// <summary>
/// 进度条值改变时，改变TaskBar的进度和状态
/// </summary>
private void _progressSlider_ValueChanged(object sender, EventArgs e)
{
    TaskbarManager.Instance.SetProgressValue(_progressSlider.Value, _progressSlider.Maximum);
    TaskbarManager.Instance.SetProgressState((TaskbarProgressBarState)_progressBarStatus.SelectedItem);
}

 正常状态      错误状态       暂停状态