TBBUTTON 結構 (commctrl.h)

  • 發行項

包含工具列中按鈕的相關信息。

語法

typedef struct _TBBUTTON {
  int       iBitmap;
  int       idCommand;
  BYTE      fsState;
  BYTE      fsStyle;
#if ...
  BYTE      bReserved[6];
#else
  BYTE      bReserved[2];
#endif
  DWORD_PTR dwData;
  INT_PTR   iString;
} TBBUTTON, *PTBBUTTON, *LPTBBUTTON;

成員

iBitmap

類型： int

按鈕影像以零起始的索引。 將此成員設定為I_IMAGECALLBACK，工具列會在需要時傳送 TBN_GETDISPINFO 通知程式代碼來擷取影像索引。

5.81 版。 將此成員設定為 I_IMAGENONE，表示按鈕沒有影像。 按鈕配置不會包含位圖的任何空間，只包含文字。

如果按鈕是分隔符，也就是說，如果 fsStyle 設定為 BTNS_SEP，iBitmap 會以像素為單位決定分隔符的寬度。 如需從影像清單中選取按鈕影像的資訊，請參閱 TB_SETIMAGELIST 訊息。

idCommand

類型： int

與按鈕相關聯的命令標識碼。 選擇按鈕時，此標識碼會用於 WM_COMMAND 訊息中。

fsState

類型： BYTE

按鈕狀態旗標。 這個成員可以是 工具列按鈕狀態中列出的值組合。

fsStyle

類型： BYTE

按鈕樣式。 這個成員可以是 工具列控件和按鈕樣式中列出的按鈕樣式值的組合。

bReserved[6]

類型： BYTE

保留的。

bReserved[2]

類型： BYTE

保留的。

dwData

類型： DWORD_PTR

應用程式定義的值。

iString

類型： INT_PTR

按鈕字串以零起始的索引，或包含按鈕文字之字串緩衝區的指標。

備註

iString 成員可以傳回字串指標或索引。 您可以使用 IS_INTRESOURCE 宏來判斷傳回的宏。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 commctrl.h