WM_CTLCOLORSTATIC メッセージ

[アーティクル]
06/22/2023

静的コントロール、または読み取り専用または無効になっている編集コントロールは、コントロールが描画されるときに 、WM_CTLCOLORSTATIC メッセージを親ウィンドウに送信します。このメッセージに応答することで、親ウィンドウでは、指定したデバイスコンテキストハンドルを使用して、静的コントロールのテキストの前景色と背景色を設定できます。

ウィンドウは、WindowProc 関数を介してこのメッセージを受け取ります。

WM_CTLCOLORSTATIC

    WPARAM wParam;
    LPARAM lParam;

パラメーター

wParam: 静的コントロールウィンドウのデバイスコンテキストを処理します。
lParam: 静的コントロールを処理します。

戻り値

アプリケーションがこのメッセージを処理する場合、戻り値は、システムが静的コントロールの背景を描画するために使用するブラシへのハンドルです。

注釈

アプリケーションが作成したブラシ (たとえば、 CreateSolidBrush または CreateBrushIndirect 関数を使用) を返す場合、アプリケーションはブラシを解放する必要があります。アプリケーションがシステムブラシ ( たとえば、GetStockObject または GetSysColorBrush 関数によって取得されたブラシ) を返す場合、アプリケーションはブラシを解放する必要はありません。

既定では、 DefWindowProc 関数は静的コントロールの既定のシステム色を選択します。

無効にした編集コントロールのテキストの背景色を設定できますが、テキストの前景色を設定することはできません。システムでは常にCOLOR_GRAYTEXTが使用されます。

読み取り専用または無効ではないコントロールを編集すると、 WM_CTLCOLORSTATIC メッセージは送信されません。代わりに、 WM_CTLCOLOREDIT メッセージを送信します。

WM_CTLCOLORSTATIC メッセージはスレッド間で送信されません。同じスレッド内でのみ送信されます。

ダイアログボックスプロシージャがこのメッセージを処理する場合は、目的の戻り値を INT_PTR にキャストし、値を直接返す必要があります。ダイアログボックスプロシージャが FALSE を返す場合、既定のメッセージ処理が実行されます。 SetWindowLong 関数によって設定されたDWL_MSGRESULT値は無視されます。

例

次の C++ の例は、 WM_CTLCOLORSTATIC メッセージに応答して静的コントロールのテキストの前景色と背景色を設定する方法を示しています。変数はhbrBkgnd、NULL に初期化され、WM_CTLCOLORSTATICの呼び出しの間にバックグラウンドブラシを格納する静的 HBRUSH 変数です。ブラシは、必要なくなったときに DeleteObject 関数の呼び出しによって破棄される必要があります。通常は、関連付けられたダイアログボックスが破棄されます。

   case WM_CTLCOLORSTATIC:
        {
        HDC hdcStatic = (HDC) wParam;
        SetTextColor(hdcStatic, RGB(255,255,255));
        SetBkColor(hdcStatic, RGB(0,0,0));

        if (hbrBkgnd == NULL)
        {
            hbrBkgnd = CreateSolidBrush(RGB(0,0,0));
        }
        return (INT_PTR)hbrBkgnd;
        }

必要条件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ]
ヘッダー	Winuser.h (Windows.h を含む)

WM_CTLCOLORSTATIC メッセージ

パラメーター

戻り値

注釈

例

必要条件

関連項目

フィードバック

フィードバック

その他のリソース