BUTTON_SPLITINFO 構造体 (commctrl.h)

  • [アーティクル]

分割ボタン (BS_SPLITBUTTONおよびBS_DEFSPLITBUTTON スタイル) を定義する情報 が 含まれます。 BCM_GETSPLITINFOメッセージと BCM_SETSPLITINFO メッセージと共 に 使用されます。

構文

typedef struct tagBUTTON_SPLITINFO {
  UINT       mask;
  HIMAGELIST himlGlyph;
  UINT       uSplitStyle;
  SIZE       size;
} BUTTON_SPLITINFO, *PBUTTON_SPLITINFO;

メンバー

mask

型: UINT

設定するデータを含むこの構造体のメンバー、または要求するメンバーを指定するフラグのセット。 このメンバーを次のフラグの 1 つ以上に設定します。

値 意味
BCSIF_GLYPH
 himlGlyph は有効です。
BCSIF_IMAGE
 himlGlyph は有効です。 uSplitStyle が BCSS_IMAGE に設定されている場合に使用します。
BCSIF_SIZE
 size は有効です。
BCSIF_STYLE
 uSplitStyle は有効です。

himlGlyph

種類: HIMAGELIST

イメージ リストへのハンドル。 プロバイダーはイメージ リストの所有権を保持し、最終的にはその破棄を担当します。

uSplitStyle

型: UINT

分割ボタンのスタイル。 値は、次のフラグの 1 つ以上である必要があります。

値 意味
BCSS_ALIGNLEFT
 画像またはグリフを左余白に水平方向に揃えます。
BCSS_IMAGE
 グリフとしてアイコンイメージを描画します。
BCSS_NOSPLIT
 分割なし。
BCSS_STRETCH
 グリフを引き伸ばしますが、縦横比を維持します。

size

種類: SIZE

himlGlyph 内のグリフのサイズを指定する SIZE 構造体。

解説

グリフは、ドロップダウン リストをアクティブにするボタンの部分に表示されるイメージです。 既定では、これは逆三角形です。 複数の画像を画像リストに追加して、ボタンの状態 (ホットや押しなど) ごとに異なるグリフを提供できます。

要件

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

関連項目

ボタンの概要