Windows 7 任务栏开发之进度条（Progress Bar）

今天药忘吃喽~ 2022-10-02 04:41 2阅读 0赞

[上一篇][Link 1]我们完成了“覆盖图标”（Overlay Icon）的相关开发，本篇我们将对进度条特性进行研究。在使用IE 下载文件时，任务栏图标会同步显示当前下载进度（如下图）。那么在应用程序中如何实现这个效果呢？

![iedownload][] *下载状态*

# 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 使用其他几种状态，请参看下表：

<table> 
 <tbody> 
  <tr> 
   <th><font>名称</font></th> 
   <th><font>描述</font></th> 
  </tr> 
  <tr> 
   <td><strong>NoProgress</strong></td> 
   <td>不显示进度条</td> 
  </tr> 
  <tr> 
   <td><strong>Indeterminate</strong></td> 
   <td>不定值进度条（处于滚动状态）</td> 
  </tr> 
  <tr> 
   <td><strong>Normal</strong></td> 
   <td>正常状态（绿色）</td> 
  </tr> 
  <tr> 
   <td><strong>Error</strong></td> 
   <td>错误状态（红色）</td> 
  </tr> 
  <tr> 
   <td><strong>Paused</strong></td> 
   <td>暂停状态（×××）</td> 
  </tr> 
 </tbody> 
</table>

# 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 调节进度条当前数值：

TaskbarManager.Instance.SetProgressValue((int)progressSlider.Value, 100);  TaskbarManager.Instance.SetProgressState(
                    (TaskbarProgressBarState)progressBarStatus.SelectedItem);

通过调整进度条呈现出三种不同的状态效果：

![slider][]

![normal][] *正常状态* ![error][] *错误状态* ![pause][] *暂停状态*

# 闪动效果 #

使用Live Messenger（LM）聊天时，如果对方发出了信息LM 图标会闪动提示，虽然Windows API 没有直接控制闪动效果的方法，但该效果在开发中可能会经常使用，下面代码为一个闪动效果类：

internal sealed class FlashWindowHelper  {      DispatcherTimer _timer;      int _count = 0;      int _maxTimes = 0;      Window _window;        public void Flash(int times, double millliseconds, Window window)      {          _timer = new DispatcherTimer();          _maxTimes = times;          _timer.Interval = TimeSpan.FromMilliseconds(millliseconds);          _timer.Tick += OnTick;          _window = window;          _timer.Start();      }        void OnTick(object sender, EventArgs e)      {          if (++_count < _maxTimes)          {              Win32.FlashWindow(new WindowInteropHelper(_window).Handle, (_count % 2) == 0);          }          else          {              _timer.Stop();          }      }  }    internal static class Win32  {      [DllImport("user32.dll")]      public static extern bool FlashWindow(IntPtr hwnd, bool bInvert);  }

通过FlashWindowHelper 类可以轻松的使任务栏图标闪动起来：

private void flashTaskbar_Click(object sender, RoutedEventArgs e)  {      FlashWindowHelper helper = new FlashWindowHelper();      helper.Flash(8, 400, Application.Current.MainWindow);  }

![flash][] *闪动效果*

# 相关参考资料 #

1. Windows 7 Taskbar Dynamic Overlay Icons and Progress Bars  
[http://windowsteamblog.com/blogs/developers/archive/2009/07/28/windows-7-taskbar-dynamic-overlay-icons-and-progress-bars.aspx][http_windowsteamblog.com_blogs_developers_archive_2009_07_28_windows-7-taskbar-dynamic-overlay-icons-and-progress-bars.aspx]

2. SetProgressValue Method  
[http://msdn.microsoft.com/en-us/library/dd391698(VS.85).aspx][http_msdn.microsoft.com_en-us_library_dd391698_VS.85_.aspx]

3. SetProgressState Method  
[http://msdn.microsoft.com/en-us/library/dd391697(VS.85).aspx][http_msdn.microsoft.com_en-us_library_dd391697_VS.85_.aspx]

转载于:https://blog.51cto.com/186067/1280667

[Link 1]: http://www.cnblogs.com/gnielee/archive/2010/03/05/windows7-taskbar-overlayicon.html
[iedownload]: /images/20220113/a30121e1a8e74e4ca6383e3b6132e1bb.png
[slider]: /images/20220113/65c6bebbffe240b687ff54ad7d5caa87.png
[normal]: http://images.cnblogs.com/cnblogs_com/gnielee/WindowsLiveWriter/Windows7ProgressBar_EB84/normal_thumb.png
[error]: http://images.cnblogs.com/cnblogs_com/gnielee/WindowsLiveWriter/Windows7ProgressBar_EB84/error_thumb.png
[pause]: /images/20220113/4163c5c00eaa4c1a8c2791513dd9aeea.png
[flash]: /images/20220113/554e7dd09d934f86b19885367e33ad8f.png
[http_windowsteamblog.com_blogs_developers_archive_2009_07_28_windows-7-taskbar-dynamic-overlay-icons-and-progress-bars.aspx]: http://windowsteamblog.com/blogs/developers/archive/2009/07/28/windows-7-taskbar-dynamic-overlay-icons-and-progress-bars.aspx
[http_msdn.microsoft.com_en-us_library_dd391698_VS.85_.aspx]: http://msdn.microsoft.com/en-us/library/dd391698%28VS.85%29.aspx
[http_msdn.microsoft.com_en-us_library_dd391697_VS.85_.aspx]: http://msdn.microsoft.com/en-us/library/dd391697%28VS.85%29.aspx