CContainedWindowT::Create

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

更新 : 2007 年 11 月

RegisterWndSuperclass を呼び出して、既存のクラスに基づくウィンドウクラスを登録します。ただし、ウィンドウプロシージャは既存のクラスのものではなく、CContainedWindowT::WindowProc に変更されます。

HWND Create(
   HWND hWndParent,
   _U_RECT rect,
   LPCTSTR szWindowName = NULL,
   DWORD dwStyle = 0,
   DWORD dwExStyle = 0,
   _U_MENUorID MenuOrID = 0U, 
   LPVOID lpCreateParam = NULL 
);
HWND Create(
   CMessageMap* pObject, 
   DWORD dwMsgMapID, 
   HWND hWndParent,
   _U_RECT rect,
   LPCTSTR szWindowName = NULL,
   DWORD dwStyle = 0,
   DWORD dwExStyle = 0,
   _U_MENUorID MenuOrID = 0U, 
   LPVOID lpCreateParam = NULL 
);
HWND Create(
   LPCTSTR lpszClassName, 
   CMessageMap* pObject, 
   DWORD dwMsgMapID, 
   HWND hWndParent,
   _U_RECT rect,
   LPCTSTR szWindowName = NULL,
   DWORD dwStyle = 0,
   DWORD dwExStyle = 0,
   _U_MENUorID MenuOrID = 0U, 
   LPVOID lpCreateParam = NULL 
);

パラメータ

lpszClassName
[入力] コンテナ内のウィンドウの基となる既存のウィンドウクラスの名前。
pObject
[入力] メッセージマップを宣言するコンテナオブジェクトへのポインタ。このオブジェクトのクラスは、CMessageMap から派生したものである必要があります。
dwMsgMapID
[入力] コンテナ内のウィンドウのメッセージを処理するメッセージマップを識別する値。既定値は 0 で、BEGIN_MSG_MAP で宣言された既定のメッセージマップを指定します。ALT_MSG_MAP(msgMapID) で宣言された代替メッセージマップを使うには、msgMapID を渡します。
hWndParent
[入力] 親ウィンドウまたはオーナーウィンドウを識別するハンドル。
rect
[入力] ウィンドウの位置を指定する RECT 構造体。RECT は、ポインタまたは参照によって渡されます。
szWindowName
[入力] ウィンドウの名前。既定値は NULL です。
dwStyle
[入力] ウィンドウのスタイル。既定値は、WS_CHILD |WS_VISIBLE です。有効な値の一覧については、Windows SDK の「CreateWindow」を参照してください。
dwExStyle
[入力] 拡張ウィンドウスタイル。既定値は 0 で、拡張スタイルは使いません。有効な値の一覧については、Windows SDK の「CreateWindowEx」を参照してください。
MenuOrID
[入力] 子ウィンドウの場合はウィンドウ識別子。トップレベルウィンドウの場合はウィンドウのメニューハンドル。既定値は 0U です。
lpCreateParam
[入力] ウィンドウ作成データへのポインタ。詳細については、CreateWindowEx に渡す最後のパラメータの説明を参照してください。

戻り値

処理が正常に終了した場合は、新規に作成したウィンドウを識別するハンドルを返します。それ以外の場合は、NULL を返します。

解説

既存のウィンドウクラス名は、m_lpszClassName に保存されます。次に、Create はこの新しいクラスに基づいてウィンドウを作成します。新しく作成されたウィンドウは、CContainedWindowT オブジェクトに自動的にアタッチされます。

メモ :
既に SubclassWindow を呼び出している場合は、Create を呼び出さないでください。

メモ :
MenuOrID パラメータの値として 0 を使用する場合は、コンパイラエラーを避けるため、既定値である 0U を指定してください。