THUMBBUTTON 结构 (shobjidl_core.h)

  • 项目

由 ITaskbarList3 接口的方法用于定义嵌入在窗口缩略图表示形式的工具栏中使用的按钮。

语法

typedef struct THUMBBUTTON {
  THUMBBUTTONMASK  dwMask;
  UINT             iId;
  UINT             iBitmap;
  HICON            hIcon;
  WCHAR            szTip[260];
  THUMBBUTTONFLAGS dwFlags;
} THUMBBUTTON, *LPTHUMBBUTTON;

成员

dwMask

类型： THUMBBUTTONMASK

THUMBBUTTONMASK 值的组合，用于指定此结构的哪些成员包含有效数据;将忽略其他成员，但 iId 除外，iId 始终是必需的。

iId

类型： UINT

按钮的应用程序定义的标识符，在工具栏中是唯一的。

iBitmap

类型： UINT

通过 ITaskbarList3：：ThumbBarSetImageList 设置的图像列表中按钮图像的从零开始的索引。

hIcon

类型： HICON

要用作按钮图像的图标的句柄。

szTip[260]

类型： WCHAR[260]

包含按钮工具提示文本的宽字符数组，当鼠标指针悬停在按钮上时显示。

dwFlags

类型： THUMBBUTTONFLAGS

控制按钮的特定状态和行为的 THUMBBUTTONFLAGS 值的组合。

注解

单击按钮时，会将包含按钮 ID 的WM_COMMAND 消息发送到关联的应用程序窗口。 应用程序处理分配给按钮的任何操作。

按钮图像

使用通过 hIcon 成员指定的图标时，任务栏会创建自己的图标副本。 当不再需要 hIcon 时，调用方有责任释放它在 hIcon 中传递的句柄。

如果为按钮的图像指定了图标和图像列表，则尽可能使用该图标。 如果出于某种原因检索图标的尝试失败，则使用映像列表中的图像。

应用程序必须提供以下按钮图像：

  • 处于其默认活动状态的按钮。
  • 适合用于高 dpi (每英寸点数) 显示器的图像。

图像必须为 32 位，尺寸必须为 GetSystemMetrics (SM_CXICON) x GetSystemMetrics (SM_CYICON) 。 工具栏本身为按钮的单击、禁用和悬停状态提供视觉对象。

要求

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

另请参阅

ITaskbarList3：：ThumbBarAddButtons

ITaskbarList3：：ThumbBarUpdateButtons

任务栏扩展

任务栏缩略图工具栏示例