TBBUTTONINFOW 構造体 (commctrl.h)

  • [アーティクル]

ツール バーの特定のボタンの情報を格納または受信します。

構文

typedef struct {
  UINT      cbSize;
  DWORD     dwMask;
  int       idCommand;
  int       iImage;
  BYTE      fsState;
  BYTE      fsStyle;
  WORD      cx;
  DWORD_PTR lParam;
  LPWSTR    pszText;
  int       cchText;
} TBBUTTONINFOW, *LPTBBUTTONINFOW;

メンバー

cbSize

型: UINT

構造体のサイズ (バイト単位)。 関連付けられたメッセージを送信する前に、このメンバーを入力する必要があります。

dwMask

種類: DWORD

有効な情報を含むメンバーを示すフラグのセット。 関連付けられたメッセージを送信する前に、このメンバーを入力する必要があります。 これには、次の値のうち 1 つ以上を指定できます。

値 意味
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

ボタンの状態フラグ。 これは、[ ツール バー ボタンの状態] に一覧表示されている値の 1 つ以上を指定できます。

fsStyle

型: BYTE

ボタンのスタイル フラグ。 これは、 ツールバー コントロールとボタンのスタイルに表示される値の 1 つ以上を指定できます。

cx

種類: WORD

ボタンの幅 (ピクセル単位)。

lParam

種類: DWORD_PTR

ボタンに関連付けられているアプリケーション定義の値。

pszText

種類: LPTSTR

ボタン テキストを格納または受信する文字バッファーのアドレス。

cchText

型: int

pszText のバッファーのサイズ。 ボタン情報が設定されている場合、このメンバーは無視されます。

解説

注意

commctrl.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして TBBUTTONINFO を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header commctrl.h