WM_CTLCOLORBTN メッセージ
WM_CTLCOLORBTNメッセージは、ボタンを描画する前に、ボタンの親ウィンドウに送信されます。 親ウィンドウでは、ボタンのテキストと背景色を変更できます。 ただし、このメッセージを処理する親ウィンドウには、所有者が描画したボタンのみが応答します。
WM_CTLCOLORBTN
WPARAM wParam;
LPARAM lParam;
パラメーター
-
wParam
-
ボタンの表示コンテキストへのハンドルを指定する HDC 。
-
lParam
-
ボタンへのハンドルを指定する HWND 。
戻り値
アプリケーションがこのメッセージを処理する場合は、ブラシへのハンドルを返す必要があります。 システムでは、ブラシを使用してボタンの背景を描画します。
解説
アプリケーションが作成したブラシを返す場合 ( CreateSolidBrush または CreateBrushIndirect 関数を使用するなど)、アプリケーションはブラシを解放する必要があります。 アプリケーションがシステム ブラシ (たとえば、 GetStockObject または GetSysColorBrush 関数によって取得されたブラシ) を返す場合、アプリケーションはブラシを解放する必要はありません。
既定では、 DefWindowProc 関数はボタンの既定のシステム 色を選択します。 BS_PUSHBUTTON、BS_DEFPUSHBUTTON、またはBS_PUSHLIKEスタイルのボタンでは、返されたブラシは使用されません。 これらのスタイルのボタンは、常に既定のシステム カラーで描画されます。 プッシュ ボタンを描画するには、複数の異なるブラシ (顔、ハイライト、シャドウ) が必要ですが、 WM_CTLCOLORBTN メッセージでは、1 つのブラシのみが返されます。 プッシュ ボタンのカスタム外観を提供するには、所有者が描画したボタンを使用します。 詳細については、「 Owner-Drawn コントロールの作成」を参照してください。
WM_CTLCOLORBTN メッセージはスレッド間で送信されません。 1 つのスレッド内でのみ送信されます。
チェック ボックスまたはラジオ ボタンのテキストの色は、ボックスまたはボタン、そのチェック マーク、およびテキストに適用されます。 これらのボタンのフォーカス四角形は、システムの既定の色 (通常は黒) のままです。 グループ ボックスのテキストの色はテキストに適用されますが、ボックスを定義する行には適用されません。 プッシュ ボタンのテキストの色は、フォーカスの四角形にのみ適用されます。テキストの色には影響しません。
ダイアログ ボックス プロシージャがこのメッセージを処理する場合は、目的の戻り値を INT_PTR にキャストし、値を直接返す必要があります。 ダイアログ ボックス プロシージャが FALSE を返す場合は、既定のメッセージ処理が実行されます。 SetWindowLong 関数によって設定されたDWL_MSGRESULT値は無視されます。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| Header |
|
関連項目
-
その他のリソース