次の方法で共有

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 [デスクトップ アプリのみ]
ヘッダー commctrl.h