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

ITaskbarList3：：ThumbBarUpdateButtons

工作列延伸模組

工作列縮圖工具列範例