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
類型： UINT
按鈕的應用程式定義識別碼，在工具列內是唯一的。
iBitmap
類型： UINT
透過 ITaskbarList3：：ThumbBarSetImageList設定之影像清單中的按鈕影像之以零起始的索引。
hIcon
類型： HICON
要作為按鈕影像之圖示的控制碼。
szTip[260]
類型： WCHAR[260]
寬字元陣列，其中包含按鈕工具提示的文字，當滑鼠指標停留在按鈕上方時顯示。
dwFlags
類型： THUMBBUTTONFLAGS
THUMBBUTTONFLAGS值的組合，可控制按鈕的特定狀態和行為。
備註
按一下按鈕時，會將包含按鈕識別碼 的WM_COMMAND 訊息傳送至相關聯的應用程式視窗。 應用程式會處理它指派給按鈕的任何動作。
按鈕影像
使用透過 hIcon 成員指定的圖示時，工作列會製作自己的圖示複本。 呼叫者必須負責釋放不再需要 時傳入 hIcon 的控制碼。如果同時指定按鈕影像的圖示和影像清單，則會盡可能使用圖示。 如果因為某些原因而嘗試擷取圖示失敗，則會使用影像清單中的影像。
應用程式必須提供這些按鈕影像：
- 處於預設作用中狀態的按鈕。
- 適合與高 DPI (點) 顯示器搭配使用的影像。
影像必須是 32 位且維度為 GetSystemMetrics (SM_CXICON) x GetSystemMetrics (SM_CYICON) 。 工具列本身會提供按鈕已點選、停用和暫留狀態的視覺效果。
規格需求
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [僅限桌面應用程式] |
| 標頭 | shobjidl_core.h (包含 Shobjidl.h) |
另請參閱
ITaskbarList3：：ThumbBarAddButtons