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

[アーティクル]
08/09/2011

ここでは、Windows コモンコントロールをサブクラス化して ActiveX コントロールを作成する手順について説明します。既存の Windows コントロールをサブクラス化すると、ActiveX コントロールを簡単に開発できます。作成した新しいコントロールでは、サブクラス化した Windows コントロールの機能 (描画やマウスクリックへの応答など) を使用できます。 Windows コントロールのサブクラス化の例については、MFC ActiveX コントロールのサンプル BUTTON を参照してください。

Windows コントロールをサブクラス化するには、以下の作業が必要になります。

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

注意

ActiveX コントロールウィザードの [コントロールの設定] ページの [Select Parent Window Class] ボックスでコントロールをサブクラス化するように指定すると、上記の作業のほとんどが自動的に処理されます。

コントロールのサブクラス化の詳細については、サポート技術情報の「PRB: MFC ActiveX Control with Subclassed ComboBox Does Not Drop Down Correctly in a VB Container (Q243454)」を参照してください。

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;
}

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

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

cs.style |= BS_CHECKBOX;

これにより、COleControl クラスの既定のスタイルフラグ (WS_CHILD) を維持したまま、BS_CHECKBOX スタイルフラグが追加されます。

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 コントロールコンテナーでは、コントロールによって送られるウィンドウメッセージを処理する必要がありません。

COleControl は、サブクラス化した Windows コントロールによって送られるウィンドウメッセージをコンテナーが受け取るのを防ぐために、コントロールの親として機能する補助ウィンドウを作成します。この補助ウィンドウは、"リフレクタ" と呼ばれます。リフレクタが作成されるのは、Windows コントロールをサブクラス化していて、コントロールウィンドウと同じサイズと位置の ActiveX コントロールの場合だけです。リフレクタウィンドウは、特定のウィンドウメッセージを受け取り、それをコントロールに送り返します。こうして返送されたメッセージは、コントロールのウィンドウプロシージャで、ActiveX コントロールに適した方法 (イベントを発生させるなど) で処理されます。リフレクタウィンドウによって受け取られるウィンドウメッセージとそれに応じて返送されるメッセージの一覧については、「返送されたウィンドウメッセージの ID」を参照してください。

ActiveX コントロールコンテナー自体がメッセージを返送するようにデザインされている場合もあります。この場合は、COleControl がリフレクタウィンドウを作成する必要がなくなるため、サブクラス化した Windows コントロールの実行時のオーバーヘッドが減少します。 COleControl は、MessageReflect アンビエントプロパティの値が TRUE かどうかを確認して、コンテナーがメッセージの返送をサポートしているかどうかを検出します。

返送されたウィンドウメッセージを処理するには、コントロールのメッセージマップにエントリを追加し、ハンドラー関数を実装します。返送されるメッセージは、Windows によって定義されている標準のメッセージではないため、クラスビューを使ってメッセージハンドラーを追加することはできません。ただし、ハンドラーはプログラマが簡単に追加できます。

返送されたウィンドウメッセージのメッセージハンドラーを直接追加するには、次の手順に従ってください。

コントロールクラスの .H ファイルで、ハンドラー関数を宣言します。関数の戻り値の型に LRESULT を指定し、WPARAM 型と LPARAM 型の 2 つのパラメーターを指定します。次に例を示します
```
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 を参照してください。この例では、OnOcmCommand ハンドラーが、BN_CLICKED 通知コードを検出し、それに応じて Click イベントを発生させます (送信します)。

参照

概念

MFC ActiveX コントロール

次の方法で共有

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

IsSubclassedControl と PreCreateWindow のオーバーライド

OnDraw メンバー関数の変更

返送されたウィンドウメッセージの処理

参照

概念

その他のリソース

次の方法で共有

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

IsSubclassedControl と PreCreateWindow のオーバーライド

OnDraw メンバー関数の変更

返送されたウィンドウ メッセージの処理

参照

概念

その他のリソース

返送されたウィンドウメッセージの処理