次の方法で共有

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

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

概要

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

関数

話題 内容
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 ボタン コントロール上でのマウスの動きに関する情報を格納します。

定数

話題 内容
ボタンのスタイルの ボタン スタイルの組み合わせを指定します。 CreateWindow または CreateWindowEx関数を使用して BUTTON クラスを使用してボタンを作成する場合は、以下に示すボタン スタイルのいずれかを指定できます。
  • Last updated on