CRichEditCtrl::Create
Creates the Windows rich edit control and associates it with this CRichEditCtrl object.
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID
);
Parameters
dwStyle
Specifies the edit control's style. Apply a combination of the window styles listed in the Remarks section below, and edit control styles, described in the Windows SDK.rect
Specifies the edit control's size and position. Can be a CRect object or RECT structure.pParentWnd
Specifies the edit control's parent window (often a CDialog). It must not be NULL.nID
Specifies the edit control's ID.
Return Value
Nonzero if initialization is successful; otherwise, 0.
Remarks
You construct a CRichEditCtrl object in two steps. First, call the CRichEditCtrl constructor, then call Create, which creates the Windows edit control and attaches it to the CRichEditCtrl object.
When you create a rich edit control with this function, first you must load the necessary common controls library. To load the libary, call the global function AfxInitRichEdit, which in turn initializes the common controls library. You need to call AfxInitRichEdit only once in your process.
When Create executes, Windows sends the WM_NCCREATE, WM_NCCALCSIZE, WM_CREATE, and WM_GETMINMAXINFO messages to the edit control.
These messages are handled by default by the OnNcCreate, OnNcCalcSize, OnCreate, and OnGetMinMaxInfo member functions in the CWnd base class. To extend the default message handling, derive a class from CRichEditCtrl, add a message map to the new class, and override the above message-handler member functions. Override OnCreate, for example, to perform needed initialization for the new class.
Apply the following window styles to an edit control.
WS_CHILD Always.
WS_VISIBLE Usually.
WS_DISABLED Rarely.
WS_GROUP To group controls.
WS_TABSTOP To include edit control in the tabbing order.
For more information about window styles, see CreateWindow in the Windows SDK.
Example
m_myRichEditCtrl.Create(
WS_CHILD|WS_VISIBLE|WS_BORDER|ES_MULTILINE,
CRect(10,10,100,200), pParentWnd, IDD_RICHEDITCTRL);
Requirements
Header: afxcmn.h