MFC ActiveX コントロール: Windows コントロールのサブクラス化

2025-06-21

この記事では、一般的な Windows コントロールをサブクラス化して ActiveX コントロールを作成するプロセスについて説明します。既存の Windows コントロールのサブクラス化は、ActiveX コントロールをすばやく開発する方法です。新しいコントロールには、描画やマウスクリックへの応答など、サブクラス化された Windows コントロールの機能があります。 MFC ActiveX コントロールのサンプル BUTTON は、Windows コントロールをサブクラス化する例です。

Von Bedeutung

ActiveX は、新しい開発には使用すべきではないレガシテクノロジです。 ActiveX に代わる最新のテクノロジの詳細については、「 ActiveX コントロール」を参照してください。

Windows コントロールをサブクラス化するには、次のタスクを実行します。

COleControl の IsSubclassedControl および PreCreateWindow メンバー関数をオーバーライドする
OnDraw メンバー関数を変更する
コントロールに反映された ActiveX コントロールメッセージ (OCM) を処理する

注

この作業の多くは、[コントロールの設定] ページの [親ウィンドウクラスの選択] ドロップダウンリストを使用してサブクラス化するコントロールを選択した場合、ActiveX コントロールウィザードによって行われます。

IsSubclassedControl と PreCreateWindow のオーバーライド

PreCreateWindowとIsSubclassedControlをオーバーライドするには、コントロールクラス宣言の protected セクションに次のコード行を追加します。

virtual BOOL PreCreateWindow(CREATESTRUCT& cs);
BOOL IsSubclassedControl();

コントロール実装ファイル (.CPP) に次のコード行を追加して、オーバーライドされた 2 つの関数を実装します。

// CMyAxSubCtrl::PreCreateWindow - Modify parameters for CreateWindowEx

BOOL CMyAxSubCtrl::PreCreateWindow(CREATESTRUCT& cs)
{
   cs.lpszClass = _T("BUTTON");
   return COleControl::PreCreateWindow(cs);
}

// CMyAxSubCtrl::IsSubclassedControl - This is a subclassed control

BOOL CMyAxSubCtrl::IsSubclassedControl()
{
   return TRUE;
}

この例では、Windows ボタンコントロールが PreCreateWindow で指定されていることに注意してください。ただし、標準の Windows コントロールはサブクラス化できます。標準の Windows コントロールの詳細については、「コントロール」を参照してください。

Windows コントロールをサブクラス化するときに、コントロールのウィンドウの作成に使用する特定のウィンドウスタイル (WS_) または拡張ウィンドウスタイル (WS_EX_) フラグを指定できます。 cs.styleとcs.dwExStyle構造体フィールドを変更することで、PreCreateWindow メンバー関数でこれらのパラメーターの値を設定できます。クラス COleControlによって設定される既定のフラグを保持するには、OR 操作を使用してこれらのフィールドを変更する必要があります。たとえば、コントロールが BUTTON コントロールをサブクラス化していて、コントロールをチェックボックスとして表示する場合は、return ステートメントの前に、 CSampleCtrl::PreCreateWindowの実装に次のコード行を挿入します。

cs.style |= BS_CHECKBOX;

この操作では、クラスの既定のスタイルフラグ (WS_CHILD) をそのまま残しながら、BS_CHECKBOX スタイルフラグ COleControl 追加します。

OnDraw メンバー関数の変更

サブクラス化されたコントロールの外観を、対応する Windows コントロールと同じにする場合、コントロールの OnDraw メンバー関数には、次の例のように、 DoSuperclassPaint メンバー関数の呼び出しのみを含める必要があります。

void CMyAxSubCtrl::OnDraw(CDC* pdc, const CRect& rcBounds, const CRect& /*rcInvalid*/)
{
   if (!pdc)
      return;

   DoSuperclassPaint(pdc, rcBounds);
}

COleControlによって実装される DoSuperclassPaint メンバー関数は、Windows コントロールのウィンドウプロシージャを使用して、指定されたデバイスコンテキスト内の境界四角形内にコントロールを描画します。これにより、アクティブでない場合でもコントロールが表示されます。

注

DoSuperclassPaint メンバー関数は、デバイスコンテキストをWM_PAINT メッセージの wParam として渡すことを許可するコントロール型でのみ機能します。これには、SCROLLBAR や BUTTON などの一部の標準的な Windows コントロールと、すべての一般的なコントロールが含まれます。この動作をサポートしていないコントロールの場合、非アクティブなコントロールを適切に表示するには、独自のコードを指定する必要があります。

反映されたウィンドウメッセージの処理

Windows コントロールは通常、特定のウィンドウメッセージを親ウィンドウに送信します。これらのメッセージの一部 (WM_COMMANDなど) は、ユーザーによるアクションの通知を提供します。 WM_CTLCOLORなどの他のユーザーは、親ウィンドウから情報を取得するために使用されます。通常、ActiveX コントロールは他の方法で親ウィンドウと通信します。通知はイベントの発生 (イベント通知の送信) によって伝達され、コントロールコンテナーに関する情報はコンテナーのアンビエントプロパティにアクセスすることによって取得されます。これらの通信手法が存在するため、ActiveX コントロールコンテナーは、コントロールによって送信されたウィンドウメッセージを処理することは想定されていません。

サブクラス化された Windows コントロールによって送信されたウィンドウメッセージをコンテナーが受信しないようにするために、 COleControl はコントロールの親として機能する追加のウィンドウを作成します。 "リフレクター" と呼ばれるこの追加ウィンドウは、Windows コントロールをサブクラス化し、コントロールウィンドウと同じサイズと位置を持つ ActiveX コントロールに対してのみ作成されます。リフレクターウィンドウは、特定のウィンドウメッセージをインターセプトし、コントロールに送り返します。コントロールは、ウィンドウプロシージャ内で、ActiveX コントロールに適したアクション (イベントの発生など) を実行することで、これらの反映されたメッセージを処理できます。インターセプトされたウィンドウメッセージとそれに対応する反映されたメッセージの一覧については、「反映されたウィンドウメッセージ ID」を参照してください。

ActiveX コントロールコンテナーは、メッセージリフレクション自体を実行するように設計されており、リフレクターウィンドウを作成する COleControl が不要になり、サブクラス化された Windows コントロールの実行時オーバーヘッドが削減されます。 COleControl は、値が TRUE の MessageReflect アンビエントプロパティをチェックすることで、コンテナーがこの機能をサポートしているかどうかを検出します。

反映されたウィンドウメッセージを処理するには、コントロールメッセージマップにエントリを追加し、ハンドラー関数を実装します。反映されたメッセージは Windows で定義されている標準のメッセージセットの一部ではないため、クラスビューではそのようなメッセージハンドラーの追加はサポートされていません。ただし、ハンドラーを手動で追加することは困難ではありません。

反映されたウィンドウメッセージのメッセージハンドラーを追加するには、次の操作を手動で行います。

コントロールクラスで.H ファイル、ハンドラー関数を宣言します。この関数の戻り値の型は LRESULT と 2 つのパラメーターで、それぞれ WPARAM 型と LPARAM 型が必要です。例えば次が挙げられます。
```
class CMyAxSubCtrl : public COleControl
{
```
```
protected:
   LRESULT OnOcmCommand(WPARAM wParam, LPARAM lParam);
};
```
コントロールクラスで.CPP ファイルで、メッセージマップにON_MESSAGEエントリを追加します。このエントリのパラメーターは、メッセージ識別子とハンドラー関数の名前である必要があります。例えば次が挙げられます。
```
BEGIN_MESSAGE_MAP(CMyAxSubCtrl, COleControl)
   ON_MESSAGE(OCM_COMMAND, &CMyAxSubCtrl::OnOcmCommand)
END_MESSAGE_MAP()
```
また、で.CPP ファイルでは、 OnOcmCommand メンバー関数を実装して、反映されたメッセージを処理します。 wParam パラメーターと lParam パラメーターは、元のウィンドウメッセージのパラメーターと同じです。

反映されたメッセージの処理方法の例については、MFC ActiveX コントロールのサンプル BUTTON を参照してください。 BN_CLICKED通知コードを検出し、Click イベントを発生 (送信) して応答するOnOcmCommand ハンドラーを示します。

こちらも参照ください

MFC ActiveX コントロール

次の方法で共有

MFC ActiveX コントロール: Windows コントロールのサブクラス化

IsSubclassedControl と PreCreateWindow のオーバーライド

OnDraw メンバー関数の変更

反映されたウィンドウ メッセージの処理

こちらも参照ください

フィードバック

その他のリソース

反映されたウィンドウメッセージの処理