ITaskbarList3 接口 (shobjidl_core.h)

通过公开支持 Windows 7 中添加的统一启动和切换任务栏按钮功能的方法扩展 ITaskbarList2 。 此功能包括基于选项卡式应用程序中的各个选项卡的缩略图表示形式和切换目标、缩略图工具栏、通知和状态覆盖以及进度指示器。

继承

ITaskbarList3 接口继承自 ITaskbarList2。 ITaskbarList3 还具有以下类型的成员：

方法

ITaskbarList3 接口包含以下方法。

ITaskbarList3：：RegisterTab 通知任务栏已提供新的选项卡或文档缩略图，以便在应用程序的任务栏组浮出控件中显示。
ITaskbarList3：：SetOverlayIcon 将覆盖应用于任务栏按钮，以指示应用程序状态或给用户的通知。
ITaskbarList3：：SetProgressState 设置任务栏按钮上显示的进度指示器的类型和状态。
ITaskbarList3：：SetProgressValue 显示或更新任务栏按钮中托管的进度栏，以显示完成完整操作的特定百分比。
ITaskbarList3：：SetTabActive 通知任务栏选项卡或文档窗口已设置为活动窗口。
ITaskbarList3：：SetTabOrder 将新的缩略图插入选项卡式文档界面 (TDI) 或多文档界面 (MDI) 应用程序的组浮出控件，或将现有缩略图移动到应用程序组中的新位置。
ITaskbarList3：：SetThumbnailClip 选择要在任务栏中显示为窗口缩略图的窗口工作区的一部分。
ITaskbarList3：：SetThumbnailTooltip 指定或更新当鼠标指针停留在任务栏按钮浮出控件中的单个预览缩略图上时显示的工具提示文本。
ITaskbarList3：：ThumbBarAddButtons 将具有指定按钮集的缩略图工具栏添加到任务栏按钮浮出控件中窗口的缩略图图像。
ITaskbarList3：：ThumbBarSetImageList 指定一个图像列表，其中包含任务栏按钮浮出控件中窗口缩略图中嵌入的工具栏的按钮图像。
ITaskbarList3：：ThumbBarUpdateButtons 根据窗口的当前状态的要求，在缩略图工具栏中显示、启用、禁用或隐藏按钮。 缩略图工具栏是嵌入任务栏按钮浮出控件中窗口缩略图中的工具栏。
ITaskbarList3：：UnregisterTab 当选项卡或文档在应用程序中关闭时，从应用程序的预览组中删除缩略图。

注解

此接口还提供从中继承的 ITaskbarList 和 ITaskbarList2 接口的方法。

何时实现

此接口的实现在 Windows 中作为CLSID_TaskbarList提供。 此接口不由第三方实现。

何时使用

使用此接口的方法执行以下操作：

• 使用 TDI 应用程序 (（如 Windows Internet Explorer) ）或 MDI 应用程序 (（如 Microsoft Excel) ）在任务栏上将其窗口显示为一个组时：
  • 为任务栏提供表示单个选项卡或文档视图的缩略图。
  • 从组中删除单个选项卡或文档的缩略图。
  • 更改组中缩略图的顺序。
  • 在显示缩略图时，将选项卡缩略图设置为所选项。
• 将覆盖应用于任务栏图标（如通知）时。
• 显示操作进度时，例如复制或安装项。
• 将工具栏添加到缩略图时。

当应用程序显示窗口时，系统会创建其任务栏按钮。 按钮就位后，任务栏会向窗口发送 TaskbarButtonCreated 消息。 应用程序应调用 RegisterWindowMessage (L“TaskbarButtonCreated”) 并在其 wndproc 中处理该消息。 应用程序必须在调用任何 ITaskbarList3 方法之前接收该消息。

注意 应用程序无法以编程方式将自身固定到任务栏。 该功能严格保留给用户。

 

要求

最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
目标平台	Windows
标头	shobjidl_core.h (包括 Shobjidl.h)

另请参阅

ITaskbarList2

任务栏扩展