Freigeben über


CRichEditCtrl::Create

Erstellt das Windows-Rich-Edit-Steuerelement und ordnet mit diesem CRichEditCtrl-Objekt zu.

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

Parameter

  • dwStyle
    Gibt das Format des Bearbeitungssteuerelements an. Wendet eine Kombination der Fensterstile, die im Remarks-Abschnitt unten aufgeführt sind, und Bearbeitungssteuerelementformate beschrieben, in Windows SDK.

  • rect
    Gibt des die Größe und Position Bearbeitungssteuerelements an. Kann ein CRect-Objekt oder eine RECT-Struktur sein.

  • pParentWnd
    Gibt das übergeordnete Fenster des Bearbeitungssteuerelements an (häufig CDialog-Klasse). Er darf nicht NULL sein.

  • nID
    Gibt die ID des Bearbeitungssteuerelements an

Rückgabewert

Ungleich 0 (null), wenn die Initialisierung erfolgreich ist; andernfalls 0.

Hinweise

Sie erstellen ein CRichEditCtrl-Objekt in zwei Schritten. Zuerst rufen Sie den CRichEditCtrl-Konstruktor, dann den Aufruf Create auf, der das Windows-Bearbeitungssteuerelement erstellt und auf CRichEditCtrl-Objekt angefügt werden.

Wenn Sie ein RichEdit-Steuerelement mit dieser Funktion erstellen, müssen Sie zunächst die notwendige Bibliothek der allgemeinen Steuerelementen laden. Um die Bibliothek zu laden, rufen Sie die globale Funktion AfxInitRichEdit auf, die wiederum die Bibliothek der allgemeinen Steuerelemente initialisiert. Sie müssen AfxInitRichEdit im Prozess nur einmal aufrufen.

Wenn Create ausführt, sendet Windows die WM_NCCREATE, WM_NCCALCSIZE, WM_CREATE und WM_GETMINMAXINFO Meldungen in das Bearbeitungssteuerelement.

Diese Meldungen werden standardmäßig durch die OnNcCreate, OnNcCalcSize, OnCreate und OnGetMinMaxInfo-Memberfunktionen in der CWnd Basisklasse bearbeitet. Um die standardmäßige Meldungsbehandlung zu erweitern, leiten Sie eine Klasse von CRichEditCtrl, fügen Sie eine Meldungszuordnung der neuen Klasse hinzu, und überschreiben Sie die oben genannten Meldungshandlermemberfunktionen. Überschreiben Sie OnCreate um beispielsweise erforderliche Initialisierung für die neue Klasse auszuführen.

Übernehmen Sie folgenden Fensterstile auf ein Bearbeitungssteuerelement zu.

  • WS_CHILD immer.

  • WS_VISIBLE normalerweise.

  • WS_DISABLED selten.

  • WS_GROUP für Group-Steuerelemente.

  • WS_TABSTOP, um des Bearbeitungssteuerelements in der Drücken der TAB-TASTEen-Reihenfolge einzuschließen.

Weitere Informationen zu Fensterstile, finden Sie unter CreateWindow in Windows SDK.

Beispiel

m_myRichEditCtrl.Create(
   WS_CHILD|WS_VISIBLE|WS_BORDER|ES_MULTILINE,
   CRect(10,10,100,200), pParentWnd, IDD_RICHEDITCTRL);

Anforderungen

Header: afxcmn.h

Siehe auch

Referenz

CRichEditCtrl-Klasse

Hierarchiediagramm

CRichEditCtrl::CreateEx

CRichEditCtrl::CRichEditCtrl