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

有効な情報を含むメンバーを示すフラグのセット。 このメンバーは、関連付けられたメッセージを送信する前に入力する必要があります。 次の値のうち 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 を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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