共用方式為


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

工作列延伸模組

工作列縮圖工具列範例