CWinFormsControl::CreateManagedControl
更新 : 2007 年 11 月
MFC コンテナに Windows フォーム コントロールを作成します。
inline BOOL CreateManagedControl(
System::Type^ pType,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
int nID
)
inline BOOL CreateManagedControl(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
int nID
);
inline BOOL CreateManagedControl(
DWORD dwStyle,
int nPlaceHolderID,
CWnd* pParentWnd
);
inline BOOL CreateManagedControl(
typename TManagedControl^ pControl,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
int nID
);
パラメータ
pType
作成するコントロールのデータ型。System.Type データ型を指定する必要があります。dwStyle
コントロールに適用するウィンドウ スタイル。ウィンドウ スタイルの組み合わせを指定します。現在、WS_TABSTOP、WS_VISIBLE、WS_DISABLED、および WS_GROUP というスタイルだけがサポートされています。rect
コントロールの左上隅および右下隅の座標を定義する RECT 構造体 (最初のオーバーロードのみ)。nPlaceHolderID
リソース エディタに配置された静的なプレースホルダ コントロールのハンドル。新しく作成された Windows フォーム コントロールは、位置、z オーダー、およびスタイルを想定して、静的なコントロールを置き換えます (2 番目のオーバーロードのみ)。pParentWnd
親ウィンドウへのポインタ。nID
新しく作成されたコントロールに割り当てるリソース ID 番号。pControl
CWinFormsControl クラス オブジェクトに関連付ける Windows フォーム コントロールのインスタンス (4 番目のオーバーロードのみ)
戻り値
正常に終了した場合は、0 以外の値を返します。それ以外の場合は、ゼロを返します。
解説
このメソッドは、MFC コンテナで .NET Framework Windows フォーム コントロールをインスタンス化します。
メソッドの最初のオーバーロードには .NET Framework の pType データ型を使用できるため、MFC は、この型の新しいオブジェクトをインスタンス化できます。pType には、System.Type データ型を指定する必要があります。
メソッドの 2 番目のオーバーロードは、CWinFormsControl クラスの TManagedControl テンプレート パラメータに基づいて Windows フォーム コントロールを作成します。コントロールのサイズと位置は、メソッドに渡された RECT 構造体に基づいています。スタイルについては、dwStyle だけが重要になります。
メソッドの 3 番目のオーバーロードは、スタティック コントロールと置き換わる Windows フォーム コントロールを作成します。このとき、スタティック コントロールを破棄したり、その位置、z オーダー、およびスタイルを想定したりします。スタティック コントロールは、Windows フォーム コントロールのプレースホルダとしてのみ機能します。コントロールを作成する際に、このオーバーロードは、dwStyle のスタイルとスタティック コントロールのリソース スタイルを組み合わせます。
メソッドの 4 番目のオーバーロードを使用すると、MFC でラップする既にインスタンス化された pControl という Windows フォーム コントロールに渡すことができます。CWinFormsControl クラスの TManagedControl テンプレート パラメータと同じ型を指定する必要があります。
Windows フォーム コントロールの使用例については、「MFC での Windows フォーム ユーザー コントロールの使用」を参照してください。
必要条件
ヘッダー : afxwinforms.h