CWnd::OnCreate

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

Create メンバー関数または CreateEx メンバー関数を呼び出して Windows のウィンドウを作成する要求をアプリケーションが行ったときに、フレームワークよりこのメンバー関数が呼び出されます。

afx_msg int OnCreate(
   LPCREATESTRUCT lpCreateStruct 
);

パラメーター

lpCreateStruct
作成される CWnd オブジェクトについての情報を持つ CREATESTRUCT 構造体を指します。

戻り値

OnCreate 関数では、CWnd オブジェクトの作成を続ける場合 0 を返す必要があります。アプリケーションが -1 を返した場合、ウィンドウは破棄されます。

解説

CWnd オブジェクトは、ウィンドウが作成されてから表示されるまでにこの呼び出しを受け取ります。 OnCreate は、Create または CreateEx メンバー関数が返す前に呼び出されます。

派生クラスでは、必要な初期化を実行するためにこのメンバー関数をオーバーライドします。

CREATESTRUCT 構造体には、ウィンドウを作るために使うパラメーターのコピーが含まれます。

注意

このメンバー関数は、アプリケーションが Windows メッセージを処理できるようにするためにフレームワークによって呼び出されます。この関数に渡されるパラメーターの値は、フレームワークがメッセージ受信時に受け取ったパラメーターの値に基づいています。この関数の基本クラスの実装を呼び出した場合は、関数に渡したパラメーターではなく、メッセージと共に渡されたパラメーター自体が使用されます。