共用方式為

TBBUTTONINFOA 結構 (commctrl.h)

  • 發行項

包含或接收工具列中特定按鈕的資訊。

語法

typedef struct {
  UINT      cbSize;
  DWORD     dwMask;
  int       idCommand;
  int       iImage;
  BYTE      fsState;
  BYTE      fsStyle;
  WORD      cx;
  DWORD_PTR lParam;
  LPSTR     pszText;
  int       cchText;
} TBBUTTONINFOA, *LPTBBUTTONINFOA;

成員

cbSize

類型： UINT

結構的大小，以位元組為單位。 傳送相關聯的訊息之前，必須先填入此成員。

dwMask

類型： DWORD

指出哪些成員包含有效資訊的旗標集合。 傳送相關聯的訊息之前，必須先填入此成員。 這可以是下列一或多個值。

值 意義
TBIF_BYINDEX

5.80 版。 使用TB_GETBUTTONINFO或TB_SETBUTTONINFO訊息傳送的wParam是索引，而不是識別碼。
TBIF_COMMAND
 idCommand成員包含有效資訊或正在要求。
TBIF_IMAGE
 iImage成員包含有效的資訊或正在要求。
TBIF_LPARAM
 lParam成員包含有效的資訊或正在要求。
TBIF_SIZE
 cx成員包含有效的資訊或正在要求中。
TBIF_STATE
 fsState成員包含有效的資訊或正在要求。
TBIF_STYLE
 fsStyle成員包含有效資訊或正在要求。
TBIF_TEXT
 pszText成員包含有效的資訊或正在要求。

idCommand

類型： int

按鈕的命令識別碼。

iImage

類型： int

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

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

fsState

類型： BYTE

按鈕的狀態旗標。 這可以是 工具列按鈕狀態中列出的一或多個值。

fsStyle

類型： BYTE

按鈕的樣式旗標。 這可以是 工具列控制項和按鈕樣式中列出的一或多個值。

cx

類型： WORD

按鈕的寬度，以圖元為單位。

lParam

類型： DWORD_PTR

與按鈕相關聯的應用程式定義值。

pszText

類型： LPTSTR

包含或接收按鈕文字的字元緩衝區位址。

cchText

類型： int

pszText的緩衝區大小。 如果正在設定按鈕資訊，則會忽略此成員。

備註

注意

commctrl.h 標頭會將 TBBUTTONINFO 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

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