CWindowImpl クラス

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

このクラスには、ウィンドウを作成またはサブクラス化するためのメソッドが用意されています。

template <
   class T,
   class TBase = CWindow,
   class TWinTraits = CControlWinTraits 
>
class ATL_NO_VTABLE CWindowImpl :
   public CWindowImplBaseT< TBase, TWinTraits >

パラメータ

T
CWindowImpl の派生クラス。
TBase
新規作成するクラスの基本クラス。既定の基本クラスは CWindow です。
TWinTraits
ウィンドウのスタイルを定義する特徴 (traits) クラス。既定のクラスは CControlWinTraits です。

解説

CWindowImpl では、新しいウィンドウを作成したり、既存のウィンドウをサブクラス化したりできます。CWindowImpl のウィンドウプロシージャは、メッセージマップを使ってメッセージを適切なハンドラに送ります。

CWindowImpl::Create は、CWndClassInfo が管理するウィンドウクラスの情報に基づいて新規のウィンドウを作成します。CWindowImpl には、DECLARE_WND_CLASS マクロが含まれています。つまり、CWndClassInfo が新しいウィンドウクラスを登録します。既存のウィンドウクラスをスーパークラス化する場合は、CWindowImpl の派生クラスを作成し、そのクラスに DECLARE_WND_SUPERCLASS マクロを含めます。この場合、CWndClassInfo は既存のクラスに基づくウィンドウクラスを登録します。ただし、ウィンドウプロシージャは CWindowImpl::WindowProc に変更されます。次に例を示します。

class ATL_NO_VTABLE CMyWindow :
   OtherInheritedClasses
   public CComControl<CMyWindow>
          // CComControl derives from CWindowImpl
{
public:
   // 1. The NULL parameter means ATL will generate a
   //    name for the superclass
   // 2. The "EDIT" parameter means the superclass is
   //    based on the standard Windows Edit box
   DECLARE_WND_SUPERCLASS(NULL, _T("EDIT"))

   // Remainder of class declaration omitted

メモ :
CWndClassInfo は単一のウィンドウクラスの情報を管理するため、CWindowImpl のインスタンスを使用して作成される各ウィンドウは、同じウィンドウクラスに基づくことになります。

CWindowImpl は、ウィンドウのサブクラス化もサポートします。SubclassWindow メソッドは、既存のウィンドウを CWindowImpl オブジェクトにアタッチし、ウィンドウプロシージャを CWindowImpl::WindowProc に変更します。CWindowImpl の各インスタンスは、それぞれ別のウィンドウをサブクラス化できます。

メモ :
指定された CWindowImpl オブジェクトに対しては、Create または SubclassWindow のいずれかを呼び出します。同じオブジェクトに対して両方のメソッドを呼び出さないでください。

CWindowImpl のほかにも、ATL (Active Template Library) には別のオブジェクトに含まれているウィンドウを作成するための CContainedWindow が用意されています。

基本クラスのデストラクタ (~CWindowImplRoot) は、必ずウィンドウを破棄してからオブジェクトを破棄します。

CWindowImpl は CWindowImplBaseT の派生クラスです。CWindowImplBaseT は CWindowImplRoot の派生クラスです。CWindowImplRoot は TBase と CMessageMap を継承しています。

詳細情報	参照項目
コントロールの作成	ATL チュートリアル
ATL でのウィンドウの使い方	ATL ウィンドウクラス
ATL プロジェクトウィザード	ATL プロジェクトの作成
ウィンドウ	About Windows Procedures