Share via


CEdit::Create

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_NCCREATEWM_NCCALCSIZEWM_CREATE、および WM_GETMINMAXINFO メッセージをエディット コントロールに送ります。

既定では、これらのメッセージは CWnd 基本クラスの OnNcCreateOnNcCalcSizeOnCreate、および 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);

必要条件

**ヘッダー:**afxwin.h

参照

参照

CEdit クラス

階層図

CEdit::CEdit

その他の技術情報

CEdit のメンバー