共用方式為

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