CEdit::Create

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

更新 : 2007 年 11 月

Windows のエディットコントロールを作成し、CEdit オブジェクトに結び付けます。

virtual BOOL Create(
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID 
);

パラメータ

dwStyle
エディットコントロールのスタイルを指定します。コントロールにはエディットスタイルの任意の組み合わせを指定できます。
rect
エディットコントロールのサイズと位置を指定します。CRect オブジェクトまたは RECT 構造体を指定できます。
pParentWnd
エディットコントロールの親ウィンドウ (通常は CDialog) を指定します。NULL は指定できません。
nID
エディットコントロールの ID を指定します。

戻り値

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

解説

CEdit オブジェクトは、次の手順で構築します。まず、CEdit コンストラクタを呼び出します。その後、Create を呼び出して Windows エディットコントロールを作成し、CEdit オブジェクトに結び付けます。

Create を実行すると、Windows は WM_NCCREATE、WM_NCCALCSIZE、WM_CREATE、および WM_GETMINMAXINFO メッセージをエディットコントロールに送ります。

既定では、これらのメッセージは CWnd 基本クラスの OnNcCreate、OnNcCalcSize、OnCreate、および OnGetMinMaxInfo メンバ関数で処理されます。既定のメッセージ処理を拡張するには、CEdit からクラスを派生してから、新しいクラスにメッセージマップを追加し、上記のメッセージハンドラメンバ関数をオーバーライドします。たとえば、OnCreate 関数をオーバーライドして、新しいクラスに必要な初期化を実行します。

エディットコントロールには、次のウィンドウスタイルを適用できます。

WS_CHILD 常時
WS_VISIBLE 通常
WS_DISABLED まれ
WS_GROUP コントロールをグループ化します。
WS_TABSTOP タブオーダーにエディットコントロールを含める

使用例

// dynamically create an edit control
CEdit* pEdit = new CEdit;
pEdit->Create(ES_MULTILINE | WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_BORDER,
   CRect(10, 10, 100, 100), this, 1);