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

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

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

C# Windows 7任务栏开发之进度条(Progress Bar)_第1张图片


      在使用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);
}

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


你可能感兴趣的:(任务栏)