ボタン (Windows コントロール)

  • [アーティクル]

このセクションでは、ボタン コントロールで使用されるプログラミング要素について説明します。 ボタンは、ユーザーがクリックすることでアプリケーションに入力を提供できるコントロールです。

概要

トピック 内容
ボタン メッセージ このトピックでは、ボタンで使用されるメッセージについて説明します。
Button の状態 このセクションでは、ボタンの選択によって状態がどのように変わるかと、アプリケーションでどのように応答するべきかについて説明します。
ボタンの種類 このトピックでは、さまざまな種類のボタンについて説明します。
ボタンの使用 このセクションでは、ボタンに関連付けられている特定のタスクを実行する方法について説明します。

関数

トピック 内容
CheckDlgButton ボタン コントロールのチェック状態を変更します。
CheckRadioButton グループ内の指定されたラジオ ボタンにチェック マークを追加 (チェック) し、グループ内の他のすべてのラジオ ボタンからチェック マークを削除 (クリア) します。
IsDlgButtonChecked IsDlgButtonChecked 関数は、ボタン コントロールがチェックされているかどうか、または 3 状態ボタン コントロールがチェックされているのか、チェック解除されているのか、または未確定なのかを判別します。

マクロ

トピック 内容
Button_Enable ボタンを有効または無効にします。
Button_GetCheck ラジオ ボタンまたはチェック ボックスのチェック状態を取得します。 このマクロを使用するか、BM_GETCHECK メッセージを明示的に送信します。
Button_GetIdealSize 画像リストが存在する場合に、テキストと画像に最適なボタンのサイズを取得します。 このマクロを使用するか、BCM_GETIDEALSIZE メッセージを明示的に送信します。
Button_GetImageList ボタン コントロールに対して設定された画像リストを記述する BUTTON_IMAGELIST 構造体を取得します。 このマクロを使用するか、BCM_GETIMAGELIST メッセージを明示的に送信します。
Button_GetNote コマンド リンク ボタンに関連付けられているメモのテキストを取得します。 このマクロを使用するか、BCM_GETNOTE メッセージを明示的に送信します。
Button_GetNoteLength コマンド リンクの説明に表示されるメモ テキストの長さを取得します。 このマクロを使用するか、BCM_GETNOTELENGTH メッセージを明示的に送信します。
Button_GetSplitInfo 指定された分割ボタン コントロールの情報を取得します。 このマクロを使用するか、BCM_GETSPLITINFO メッセージを明示的に送信します。
Button_GetState ラジオ ボタンまたはチェック ボックスのチェック状態を取得します。 このマクロを使用するか、BM_GETSTATE メッセージを明示的に送信します。
Button_GetText ボタンのテキストを取得します。
Button_GetTextLength ボタンのテキスト内の文字数を取得します。
Button_GetTextMargin ボタン コントロールにテキストを描画するために使用する余白を取得します。 このマクロを使用するか、BCM_GETTEXTMARGIN メッセージを明示的に送信します。
Button_SetCheck ラジオ ボタンまたはチェック ボックスのチェック状態を設定します。 このマクロを使用するか、BM_SETCHECK メッセージを明示的に送信します。
Button_SetDropDownState BS_SPLITBUTTON スタイルが設定されている、指定されたボタンのドロップダウン状態を設定します。 このマクロを使用するか、BCM_SETDROPDOWNSTATE メッセージを明示的に送信します。
Button_SetElevationRequiredState 浮き出たアイコンを表示するために、指定されたボタンまたはコマンド リンクのエレベーション必須状態を設定します。 このマクロを使用するか、BCM_SETSHIELD メッセージを明示的に送信します。
Button_SetImageList ボタン コントロールに画像リストを割り当てます。 このマクロを使用するか、BCM_SETIMAGELIST メッセージを明示的に送信します。
Button_SetNote 指定されたコマンド リンク ボタンに関連付けられているメモのテキストを設定します。 このマクロを使用するか、BCM_SETNOTE メッセージを明示的に送信します。
Button_SetSplitInfo 指定された分割ボタン コントロールの情報を設定します。 このマクロを使用するか、BCM_SETSPLITINFO メッセージを明示的に送信します。
Button_SetState ボタンの強調表示状態を設定します。 強調表示状態は、ユーザーがボタンを押したかのようにボタンが強調表示されているかどうかを示します。 このマクロを使用するか、BM_SETSTATE メッセージを明示的に送信します。
Button_SetStyle ボタンのスタイルを設定します。 このマクロを使用するか、BM_SETSTYLE メッセージを明示的に送信します。
Button_SetText ボタンのテキストを設定します。
Button_SetTextMargin ボタン コントロール内のテキストを描画するための余白を設定します。 このマクロを使用するか、BCM_SETTEXTMARGIN メッセージを明示的に送信します。

[メッセージ]

トピック 内容
BCM_GETIDEALSIZE 画像リストが存在する場合に、テキストと画像に最適なボタンのサイズを取得します。 このメッセージを明示的に送信するか、Button_GetIdealSize マクロを使用します。
BCM_GETIMAGELIST ボタン コントロールに割り当てられた画像リストを記述する BUTTON_IMAGELIST 構造体を取得します。 このメッセージを明示的に送信するか、Button_GetImageList マクロを使用します。
BCM_GETNOTE コマンド リンク ボタンに関連付けられているメモのテキストを取得します。 このメッセージを明示的に送信するか、Button_GetNote マクロを使用します。
BCM_GETNOTELENGTH コマンド リンク ボタンの説明に表示されるメモ テキストの長さを取得します。 このメッセージを明示的に送信するか、Button_GetNoteLength マクロを使用します。
BCM_GETSPLITINFO 分割ボタン コントロールの情報を取得します。 このメッセージを明示的に送信するか、Button_GetSplitInfo マクロを使用します。
BCM_GETTEXTMARGIN ボタン コントロールにテキストを描画するために使用する余白を取得します。 このメッセージを明示的に送信するか、Button_GetTextMargin マクロを使用します。
BCM_SETDROPDOWNSTATE TBSTYLE_DROPDOWN スタイルが設定されたボタンのドロップダウン状態を設定します。 このメッセージを明示的に送信するか、Button_SetDropDownState マクロを使用します。
BCM_SETIMAGELIST ボタン コントロールに画像リストを割り当てます。 このメッセージを明示的に送信するか、Button_SetImageList マクロを使用します。
BCM_SETNOTE コマンド リンク ボタンに関連付けられているメモのテキストを設定します。 このメッセージを明示的に送信するか、Button_SetNote マクロを使用します。
BCM_SETSHIELD 浮き出たアイコンを表示するために、指定されたボタンまたはコマンド リンクのエレベーション必須状態を設定します。 このメッセージを明示的に送信するか、Button_SetElevationRequiredState マクロを使用します。
BCM_SETSPLITINFO 分割ボタン コントロールの情報を設定します。 このメッセージを明示的に送信するか、Button_SetSplitInfo マクロを使用します。
BCM_SETTEXTMARGIN BCM_SETTEXTMARGIN メッセージは、ボタン コントロール内にテキストを描画するための余白を設定します。
BM_CLICK ボタンをクリックするユーザーをシミュレートします。 このメッセージにより、ボタンは WM_LBUTTONDOWN メッセージと WM_LBUTTONUP メッセージを受信し、ボタンの親ウィンドウは BN_CLICKED 通知コードを受信します。
BM_GETCHECK ラジオ ボタンまたはチェック ボックスのチェック状態を取得します。 このメッセージを明示的に送信するか、Button_GetCheck マクロを使用します。
BM_GETIMAGE ボタンに関連付けられている画像 (アイコンまたはビットマップ) のハンドルを取得します。
BM_GETSTATE ボタンまたはチェック ボックスの状態を取得します。 このメッセージを明示的に送信するか、Button_GetState マクロを使用します。
BM_SETCHECK ラジオ ボタンまたはチェック ボックスのチェック状態を設定します。 このメッセージを明示的に送信するか、Button_SetCheck マクロを使用します。
BM_SETDONTCLICK ボタンがフォーカスを取得したときに、BN_CLICKED メッセージの生成を制御するフラグをラジオ ボタンに設定します。
BM_SETIMAGE 新しい画像 (アイコンまたはビットマップ) をボタンに関連付けます。
BM_SETSTATE ボタンの強調表示状態を設定します。 強調表示状態は、ユーザーがボタンを押したかのようにボタンが強調表示されているかどうかを示します。 このメッセージを明示的に送信するか、Button_SetState マクロを使用します。
BM_SETSTYLE ボタンのスタイルを設定します。 このメッセージは明示的に送信することも、Button_SetStyle マクロを使用することもできます。

通知

トピック 内容
BCN_DROPDOWN ユーザーがボタンのドロップダウン矢印をクリックしたときに送信されます。 このコントロールの親ウィンドウは、この通知コードを WM_NOTIFY メッセージの形式で受信します。
BCN_HOTITEMCHANGE マウスがボタン コントロールのクライアント領域に入ったか、または出たことを、ボタン コントロールのオーナーに通知します。 ボタン コントロールは、この通知コードを WM_NOTIFY メッセージの形式で送信します。
BN_CLICKED ユーザーがボタンをクリックしたときに送信されます。
このボタンの親ウィンドウは、WM_COMMAND メッセージを通じて BN_CLICKED 通知コードを受信します。
BN_DBLCLK ユーザーがボタンをダブルクリックしたときに送信されます。 この通知コードは、BS_USERBUTTON、BS_RADIOBUTTON、および BS_OWNERDRAW ボタンに対して自動的に送信されます。 他の種類のボタンは、BS_NOTIFY スタイルが設定されている場合にのみ、BN_DBLCLK を送信します。
このボタンの親ウィンドウは、WM_COMMAND メッセージを通じて BN_DBLCLK 通知コードを受信します。
BN_DISABLE ボタンが無効になったときに送信されます。 注: この通知コードは、バージョン 3.0 より前の 16 ビット版 Windows との互換性のためにのみ提供されています。 アプリケーションでは、このタスクに BS_OWNERDRAW ボタン スタイルと DRAWITEMSTRUCT 構造体を使用する必要があります。
このボタンの親ウィンドウは、WM_COMMAND メッセージを通じて BN_DISABLE 通知コードを受信します。
BN_DOUBLECLICKED ユーザーがボタンをダブルクリックしたときに送信されます。 BS_USERBUTTON、BS_RADIOBUTTON、BS_OWNERDRAW ボタンに関しては、この通知コードは自動的に送信されます。 他の種類のボタンは、BS_NOTIFY スタイルが設定されている場合にのみ、BN_DOUBLECLICKED を送信します。
このボタンの親ウィンドウは、WM_COMMAND メッセージを通じて BN_DOUBLECLICKED 通知コードを受信します。
BN_HILITE ユーザーがボタンを選択したときに送信されます。 注: この通知コードは、バージョン 3.0 より前の 16 ビット版 Windows との互換性のためにのみ提供されています。 アプリケーションでは、このタスクに BS_OWNERDRAW ボタン スタイルと DRAWITEMSTRUCT 構造体を使用する必要があります。
このボタンの親ウィンドウは、WM_COMMAND メッセージを通じて BN_HILITE 通知コードを受信します。
BN_KILLFOCUS ボタンがキーボード フォーカスを失ったときに送信されます。 この通知コードを送信するには、ボタンに BS_NOTIFY スタイルが必要です。
このボタンの親ウィンドウは、WM_COMMAND メッセージを通じて BN_KILLFOCUS 通知コードを受信します。
BN_PAINT ボタンをペイントする必要がある場合に送信されます。 注: この通知コードは、バージョン 3.0 より前の 16 ビット版 Windows との互換性のためにのみ提供されています。 アプリケーションでは、このタスクに BS_OWNERDRAW ボタン スタイルと DRAWITEMSTRUCT 構造体を使用する必要があります。
このボタンの親ウィンドウは、WM_COMMAND メッセージを通じて BN_PAINT 通知コードを受信します。
BN_PUSHED ボタンのプッシュ状態がプッシュ済みに設定されたときに送信されます。 注: この通知コードは、バージョン 3.0 より前の 16 ビット版 Windows との互換性のためにのみ提供されています。 アプリケーションでは、このタスクに BS_OWNERDRAW ボタン スタイルと DRAWITEMSTRUCT 構造体を使用する必要があります。
このボタンの親ウィンドウは、WM_COMMAND メッセージを通じて BN_PUSHED 通知コードを受信します。
BN_SETFOCUS ボタンがキーボード フォーカスを受け取ったときに送信されます。 この通知コードを送信するには、ボタンに BS_NOTIFY スタイルが必要です。
このボタンの親ウィンドウは、WM_COMMAND メッセージを通じて BN_SETFOCUS 通知コードを受信します。
BN_UNHILITE 強調表示をボタンから削除する必要があるときに送信されます。 注: この通知コードは、バージョン 3.0 より前の 16 ビット版 Windows との互換性のためにのみ提供されています。 アプリケーションでは、このタスクに BS_OWNERDRAW ボタン スタイルと DRAWITEMSTRUCT 構造体を使用する必要があります。
このボタンの親ウィンドウは、WM_COMMAND メッセージを通じて BN_UNHILITE 通知コードを受信します。
BN_UNPUSHED ボタンのプッシュ状態がプッシュ解除に設定されたときに送信されます。 注: この通知コードは、バージョン 3.0 より前の 16 ビット版 Windows との互換性のためにのみ提供されています。 アプリケーションでは、このタスクに BS_OWNERDRAW ボタン スタイルと DRAWITEMSTRUCT 構造体を使用する必要があります。
このボタンの親ウィンドウは、WM_COMMAND メッセージを通じて BN_UNPUSHED 通知コードを受信します。
NM_CUSTOMDRAW (ボタン) ボタン コントロールの親ウィンドウに、ボタンでのカスタム描画操作について通知します。
ボタン コントロールは、この通知コードを WM_NOTIFY メッセージの形式で送信します。
WM_CTLCOLORBTN ボタンを描画する前に、ボタンの親ウィンドウに WM_CTLCOLORBTN メッセージが送信されます。 親ウィンドウでは、ボタンのテキストと背景色を変更できます。 ただし、このメッセージを処理する親ウィンドウに応答するのは、所有者描画ボタンのみです。

構造体

トピック 内容
BUTTON_IMAGELIST ボタン コントロールで使用されている画像リストに関する情報が含まれます。
BUTTON_SPLITINFO 分割ボタンを定義する情報 (BS_SPLITBUTTON スタイルと BS_DEFSPLITBUTTON スタイル) が含まれます。 BCM_GETSPLITINFO メッセージおよび BCM_SETSPLITINFO メッセージと共に使用されます。
NMBCDROPDOWN BCN_DROPDOWN 通知に関する情報が含まれます。
NMBCHOTITEM ボタン コントロール上でのマウスの動きに関する情報が含まれます。

定数

トピック 内容
ボタン スタイル ボタン スタイルの組み合わせを指定します。 BUTTON クラスを使用するボタンを、CreateWindow 関数または CreateWindowEx 関数で作成する場合は、以下の一覧に示したボタン スタイルのいずれかを指定できます。