Winforms: Windows 7中Taskbar的新效果（3）——进度条

在Win7中，当我们从网上下载一个比较大的文件的时候，我们发现下载对应的窗口在Taskbar上对应的按钮有进度条来显示下载的进展情况。Win7为了方便开发这种新的UI效果，Windows提供了两个API：

·         void SetProgressValue(IntPtr hwnd, UInt64 ullCompleted, UInt64 ullTotal);

·         void SetProgressState(IntPtr hwnd, TBPFLAG tbpFlags);

 

                SetProgressValue有三个参数：第一个参数hwnd是进程主窗口的句柄，第二个参数ullCompleted是当前已经完成的进度，第三个参数ullTotal就是进度总值。根据后两个参数，Win7就可以确定进度条显示的比例。

SetProgressState有两个参数：第一个参数hwnd同样也是进程主窗口的句柄，第二个参数表示进度状态。Win7提供了如下几种状态：没有进展（NoProgress）、不确定进度（Indeterminate）、正常（Normal）、出错（Error）和暂停（Paused）。我们可以定义如下枚举类型表示这几种状态：

    public enum TaskbarProgressBarState

    {

        NoProgress = 0,

        Indeterminate = 0x1,

        Normal = 0x2,

        Error = 0x4,

        Paused = 0x8

    }

 

接下来我们用一个例子来详细说明如果调用上面两个API来实现Win7中Taskbar的进度条效果：

1.       在form上添加一个Text属性为State的Label，在它的右边添加ComboBox并命名为comboBoxProgressBarStates ；

2.       在form上添加一个Text属性为Value的Label，在它的右边添加TackBar并命名为tackBarProgressBarValue；

 

此时程序的界面效果如下图所示：

 

3.       在类TaskManager中添加一个方法SetProgressBarState如下：

        public void SetProgressState(IntPtr windowHandle, TaskbarProgressBarState state)

        {

            ThrowIfNotSupport();

 

            TaskbarList.SetProgressState(windowHandle, (TBPFLAG)state);

        }

 

4.       在类TaskManager中添加一个方法SetProgressBarValue如下：

        public void SetProgressValue(IntPtr windowHandle, int currentValue, int maximumValue)

        {

            ThrowIfNotSupport();

 

            TaskbarList.SetProgressValue(windowHandle, Convert.ToUInt32(currentValue), Convert.ToUInt32(maximumValue));

        }

 

5.       在form中获取TaskManager的一个实例：

        // Keep a reference to the Taskbar instance

        private TaskbarManager windowsTaskbar = TaskbarManager.Instance;

 

6.       为form添加Show事件响应器，初始化ComboBox和Taskbar进度条状态如下：

        private void FormProgressBar_Shown(object sender, EventArgs e)

        {

            // Add each item into comboBoxProgressBarStates

            foreach (string state in Enum.GetNames(typeof(TaskbarProgressBarState)))

                comboBoxProgressBarStates.Items.Add(state);

 

            comboBoxProgressBarStates.SelectedItem = "NoProgress";

 

            // Set our default

            TaskbarManager.Instance.SetProgressState(this.Handle, TaskbarProgressBarState.NoProgress);

        }

 

7.       为ComboBox添加IndexChanged事件响应器如下：

        private void comboBoxProgressBarStates_SelectedIndexChanged(object sender, EventArgs e)

        {

            // Update the status of the taskbar progress bar

            TaskbarProgressBarState state = (TaskbarProgressBarState)(Enum.Parse(typeof(TaskbarProgressBarState), (string)comboBoxProgressBarStates.SelectedItem));

 

            windowsTaskbar.SetProgressState(this.Handle, state);

 

            // Update the application progress bar,

            // as well disable the trackbar in some cases

            switch (state)

            {

                case TaskbarProgressBarState.Normal:

                    windowsTaskbar.SetProgressValue(this.Handle, trackBarProgressBarValue.Value, 100);

                    trackBarProgressBarValue.Enabled = true;

                    break;

                case TaskbarProgressBarState.Paused:

                    windowsTaskbar.SetProgressValue(this.Handle, trackBarProgressBarValue.Value, 100);

                    trackBarProgressBarValue.Enabled = true;

                    break;

                case TaskbarProgressBarState.Error:

                    windowsTaskbar.SetProgressValue(this.Handle, trackBarProgressBarValue.Value, 100);

                    trackBarProgressBarValue.Enabled = true;

                    break;

                case TaskbarProgressBarState.Indeterminate:

                    trackBarProgressBarValue.Enabled = false;

                    break;

                case TaskbarProgressBarState.NoProgress:

                    trackBarProgressBarValue.Value = 0;

                    trackBarProgressBarValue.Enabled = false;

                    break;

            }

        }

 

8.       为TackBar添加Scroll事件响应器如下：

        private void trackBarProgressBarValue_Scroll(object sender, EventArgs e)

        {

            TaskbarManager.Instance.SetProgressValue(this.Handle, trackBarProgressBarValue.Value, 100);

        }

 

9.       编译运行。

当进度条的状态为NoProgress时，该程序在Taskbar上显示为：

当进度条的状态为Indeterminate时，该程序在Taskbar不能确定其进度，所以进度条循环显示。下面是其截屏：

当进度条的状态为Normal时，该程序在Taskbar的进度条已经完成的部分显示为绿色，显示为：

当进度条的状态为Error时，该程序在Taskbar的进度条已经完成的部分显示为红色，显示为：

当进度条的状态为Paused时，该程序在Taskbar的进度条已经完成的部分显示为黄色，显示为：