カスタムコントロール

[アーティクル]
03/05/2024

このセクションには、アプリケーション定義コントロールまたはカスタムコントロールに関する情報が含まれています。

次のトピックについて説明します。

オーナー描画コントロールの作成
既存のコントロールの Window クラスのサブクラス化
アプリケーション定義ウィンドウクラスの実装
コントロールからの通知の送信
アクセシビリティ
関連トピック

オーナー描画コントロールの作成

ボタン、メニュー、静的テキストコントロール、リストボックス、コンボボックスは、オーナー描画スタイルフラグを使用して作成できます。コントロールにオーナー描画スタイルがある場合、システムは、ユーザーがボタンを選択したことを検出してボタンの所有者にイベントを通知するなどのタスクを実行することで、コントロールとのユーザーの対話を通常どおりに処理します。ただし、コントロールはオーナー描画のため、コントロールの外観はコントロールの親ウィンドウが担当します。親ウィンドウは、コントロールを描画する必要があるときは必ずメッセージを受信します。

ボタンと静的テキストコントロールの場合、オーナー描画スタイルは、システムがコントロール全体を描画する方法に影響を与えます。リストボックスとコンボボックスの場合、親ウィンドウがコントロール内に項目を描画し、コントロールが独自のアウトラインを描画します。たとえば、アプリケーションは、リスト内の各項目の横に小さいビットマップが表示されるようリストボックスをカスタマイズできます。

次のコード例は、オーナー描画の静的テキストコントロールを作成する方法を示しています。 Unicode が定義されているとします。

// g_myStatic is a global HWND variable.
g_myStatic = CreateWindowEx(0, L"STATIC", L"Some static text", 
            WS_CHILD | WS_VISIBLE | SS_OWNERDRAW, 
            25, 125, 150, 20, hDlg, 0, 0, 0);

次の例では、前の例で作成されたコントロールを含むダイアログボックスのウィンドウプロシージャから、既定のフォントを使用してテキストをカスタム色で表示することにより WM_DRAWITEM メッセージが処理されます。 WM_DRAWITEM を処理するときに、BeginPaint と EndPaint を呼び出す必要はありません。

case WM_DRAWITEM:
{
    LPDRAWITEMSTRUCT pDIS = (LPDRAWITEMSTRUCT)lParam;
    if (pDIS->hwndItem == g_myStatic)
    {
        SetTextColor(pDIS->hDC, RGB(100, 0, 100));
        WCHAR staticText[99];
        int len = SendMessage(myStatic, WM_GETTEXT, 
            ARRAYSIZE(staticText), (LPARAM)staticText);
        TextOut(pDIS->hDC, pDIS->rcItem.left, pDIS->rcItem.top, staticText, len);
    }
    return TRUE;
}

オーナー描画コントロールについて詳しくは、「オーナー描画リストボックスの作成」と「オーナー描画コンボボックス」をご覧ください。

既存のコントロールの Window クラスのサブクラス化

カスタムコントロールを作成するもう 1 つの方法として、既存のコントロールをサブクラス化できます。サブクラスプロシージャは、選択された動作に影響を与えるメッセージを処理することにより、コントロールの選択された動作を変更できます。他のすべてのメッセージは、コントロールの元のウィンドウプロシージャに渡されます。たとえば、アプリケーションでは、コントロールをサブクラス化し、WM_PAINT メッセージを処理することにより、読み取り専用の単一行編集コントロールのテキストの横に小さなビットマップを表示できます。詳しくは、ウィンドウプロシージャとコントロールのサブクラス化に関するページをご覧ください。

アプリケーション定義ウィンドウクラスの実装

既存のコントロールに明示的に基づいていないコントロールを作成するには、アプリケーションでウィンドウクラスを作成して登録する必要があります。カスタムコントロールのアプリケーション定義ウィンドウクラスを登録するプロセスは、通常のウィンドウのクラスを登録するプロセスと同じです。カスタムコントロールを作成するには、CreateWindowEx 関数またはダイアログボックステンプレートでウィンドウクラスの名前を指定します。各クラスには、一意の名前、対応するウィンドウプロシージャ、その他の情報が必要です。

少なくとも、ウィンドウプロシージャはコントロールを描画します。ユーザーが情報を入力可能にするため、アプリケーションでコントロールが使用されている場合、ウィンドウプロシージャはキーボードとマウスからの入力メッセージも処理し、通知メッセージを親ウィンドウに送信します。さらに、コントロールがコントロールメッセージをサポートしている場合、ウィンドウプロシージャは、親ウィンドウまたは他のウィンドウによって送信されたメッセージを処理します。たとえば、コントロールは、多くの場合、ダイアログボックスによって送信された WM_GETDLGCODE メッセージを処理して、キーボード入力を特定の方法で処理するようダイアログボックスに指示します。

アプリケーション定義コントロールのウィンドウプロシージャは、メッセージがコントロールの操作に影響を与える場合、次の表の定義済みコントロールメッセージを処理する必要があります。

メッセージ	推奨
WM_GETDLGCODE	コントロールが ENTER、ESC、TAB、または方向キーを使用するかどうかを処理します。 IsDialogMessage 関数は、このメッセージをダイアログボックス内のコントロールに送信して、キーを処理するかコントロールに渡すかを決定します。
WM_GETFONT	WM_SETFONT メッセージも処理される場合に処理します。
WM_GETTEXT	コントロールテキストが CreateWindowEx 関数によって指定されたタイトルと同じでない場合に処理します。
WM_GETTEXTLENGTH	コントロールテキストが CreateWindowEx 関数によって指定されたタイトルと同じでない場合に処理します。
WM_KILLFOCUS	コントロールにキャレット、フォーカスの四角形、または入力フォーカスがあることを示す別の項目が表示される場合に処理します。
WM_SETFOCUS	コントロールにキャレット、フォーカスの四角形、または入力フォーカスがあることを示す別の項目が表示される場合に処理します。
WM_SETTEXT	コントロールテキストが CreateWindowEx 関数によって指定されたタイトルと同じでない場合に処理します。
WM_SETFONT	コントロールにテキストが表示される場合に処理します。このメッセージは、DS_SETFONT スタイルのダイアログボックスを作成するときに送信されます。

アプリケーション定義コントロールメッセージは特定のコントロールに固有であり、SendMessage または SendDlgItemMessage 関数を使用してコントロールに明示的に送信する必要があります。各メッセージの数値は一意でなければならず、他のウィンドウメッセージの値と競合してはなりません。アプリケーション定義メッセージ値が競合しないよう、アプリケーションは、WM_USER 値に一意の数値を追加することにより、各値を作成する必要があります。

コントロールからの通知の送信

ホストアプリケーションがこれらのイベントに応答できるよう、イベントの通知を親ウィンドウに送信するには、カスタムコントロールが必要になることがあります。たとえば、カスタムリストビューは、ユーザーが項目を選択したときに通知を送信し、項目がダブルクリックされたときに別の通知を送信する場合があります。

通知は、WM_COMMAND メッセージまたは WM_NOTIFY メッセージとして送信されます。 WM_NOTIFY メッセージには、WM_COMMAND メッセージよりも多くの情報が含まれています。

コントロール識別子は、メッセージを送信するコントロールを識別するためにアプリケーションが使用する一意の数値です。アプリケーションは、コントロールの作成時にコントロールの識別子を設定します。アプリケーションは、CreateWindowEx 関数の hMenu パラメーターまたは DLGITEMTEMPLATEEX 構造の id メンバーで識別子を指定します。

コントロール自体はコントロール識別子を設定しないため、コントロールは通知メッセージを送信する前に識別子を取得する必要があります。コントロールは、独自のコントロール識別子を取得するために GetDlgCtrlID 関数を使用する必要があります。コントロール識別子は、コントロールの作成時にメニューハンドルとして指定されますが、GetMenu 関数を使用して識別子を取得することはできません。または、コントロールは、WM_CREATE メッセージの処理時に CREATESTRUCT 構造の hMenu メンバーから識別子を取得することができます。

次の例では、hwndControl がコントロールウィンドウのハンドルになっており、CN_VALUECHANGED がカスタム通知定義になっています。コントロール固有の通知を送信する 2 つの方法を示しています。

 // Send as WM_COMMAND.
SendMessage(GetParent(hwndControl), 
    WM_COMMAND,
    MAKEWPARAM(GetDlgCtrlID(hwndControl), CN_VALUECHANGED),
    (LPARAM)hwndControl);

// Send as WM_NOTIFY.           
NMHDR nmh;
nmh.code = CN_VALUECHANGED;
nmh.idFrom = GetDlgCtrlID(hwndControl);
nmh.hwndFrom = hwndControl;
SendMessage(GetParent(hwndControl), 
    WM_NOTIFY, 
    (WPARAM)hwndControl, 
    (LPARAM)&nmh);

NMHDR 構造は、追加情報を含む、より大きなコントロール定義構造の一部になる可能性がある点に注意してください。この例では、コントロールの古い値と新しい値がこの構造に含まれている可能性があります。 (このような拡張構造は、多くの標準通知で使用されます。たとえば、NMLISTVIEW 構造を使用する LVN_INSERTITEM をご覧ください)。

アクセシビリティ

すべての一般的なコントロールでは、Microsoft Active Accessibility (MSAA) がサポートされています。これにより、スクリーンリーダーなどのアクセシビリティテクノロジアプリケーションからのプログラムによるアクセスが可能になります。 MSAA を使用すると、新しいテクノロジである UI オートメーションがコントロールと対話することもできます。

カスタムコントロールは、(MSAA をサポートするため) IAccessible インターフェイス、UI オートメーションインターフェイス、またはその両方を実装する必要があります。そうしないと、アクセシビリティテクノロジ製品が、コントロールウィンドウに関するごく限られた情報のみを取得可能になり、コントロールのプロパティにはアクセスできず、コントロール内のイベントをトリガーできなくなります。

コントロールをアクセシビリティ対応にする方法について詳しくは、「Windows Automation API」をご覧ください。

Conceptual
一般的なコントロールリファレンス
カスタム描画を使用してコントロールの外観をカスタマイズする
コントロールメッセージ
オーナー描画コントロールでビジュアルスタイルを使用する

次の方法で共有

カスタムコントロール

オーナー描画コントロールの作成

既存のコントロールの Window クラスのサブクラス化

アプリケーション定義ウィンドウクラスの実装

コントロールからの通知の送信

アクセシビリティ

フィードバック

その他のリソース

次の方法で共有

カスタム コントロール

オーナー描画コントロールの作成

既存のコントロールの Window クラスのサブクラス化

アプリケーション定義ウィンドウ クラスの実装

コントロールからの通知の送信

アクセシビリティ

関連トピック

フィードバック

その他のリソース

カスタムコントロール

アプリケーション定義ウィンドウクラスの実装