CFrameWnd::Create

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

更新 : 2007 年 11 月

CFrameWnd オブジェクトに関連付けられた Windows のフレームウィンドウを作成し、初期化します。

virtual BOOL Create(
   LPCTSTR lpszClassName,
   LPCTSTR lpszWindowName,
   DWORD dwStyle = WS_OVERLAPPEDWINDOW,
   const RECT& rect = rectDefault,
   CWnd* pParentWnd = NULL,
   LPCTSTR lpszMenuName = NULL,
   DWORD dwExStyle = 0,
   CCreateContext* pContext = NULL 
);

パラメータ

lpszClassName
Windows のクラス名を示す NULL で終わる文字列へのポインタ。クラス名には、AfxRegisterWndClass グローバル関数または Windows 関数の RegisterClass で登録された任意の名称を指定できます。NULL のときは、既定の組み込み CFrameWnd 属性が使われます。
lpszWindowName
ウィンドウ名を示す NULL で終わる文字列へのポインタ。タイトルバーのテキストとして使用します。
dwStyle
ウィンドウのスタイル属性を指定します。ウィンドウに表示されているドキュメントの名前を自動的にタイトルバーに表示するには、FWS_ADDTOTITLE スタイルを含めます。
rect
ウィンドウのサイズと位置を指定します。rectDefault 値を指定すると、Windows によって新しいウィンドウのサイズと位置が指定されます。
pParentWnd
このフレームウィンドウの親ウィンドウを指定します。トップレベルのフレームウィンドウの場合は、このパラメータに NULL を指定します。
lpszMenuName
ウィンドウに使われるメニューリソースの名前を識別します。メニューが文字列の代わりに整数の ID を持つときは、MAKEINTRESOURCE を使います。このパラメータには、NULL を指定できます。
dwExStyle
ウィンドウの拡張拡張ウィンドウスタイル属性を指定します。
pContext
CCreateContext 構造体のポインタを指定します。このパラメータには、NULL を指定できます。

戻り値

初期化が正常終了した場合は 0 以外の値を返します。それ以外の場合は 0 を返します。

解説

CFrameWnd オブジェクトは 2 ステップで構築します。まず CFrameWnd オブジェクトを構築するためにコンストラクタを起動します。その後、Windows のフレームウィンドウを作成して CFrameWnd オブジェクトをウィンドウに結び付けるために、Create 関数を呼び出します。Create 関数は、ウィンドウのクラス名やウィンドウ名を初期化し、スタイル、親ウィンドウ、関連するメニューの既定値を登録します。

引数を指定する代わりに、リソースからフレームウィンドウを読み込むには、Create ではなく、LoadFrame を使います。