Partager via


CRichEditCtrl::Create

Crée le contrôle RichEdit windows et l'associe à cet objet d' CRichEditCtrl .

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

Paramètres

  • dwStyle
    Spécifie le style du contrôle d'édition.Appliquez une combinaison des styles de fenêtre répertoriées dans la section de Notes ci-dessous, et styles de contrôle d'édition, décrit dans Kit de développement logiciel Windows.

  • rect
    Spécifie la taille et la position du contrôle d'édition.Peut être un objet de CRect ou une structure de RECT .

  • pParentWnd
    Spécifie la fenêtre parente du contrôle d'édition (souvent CDialog).Il ne doit pas être NULL.

  • nID
    Spécifie l'ID du contrôle d'édition

Valeur de retour

Une valeur différente de zéro si l'initialisation est réussie ; sinon, 0.

Notes

Vous construisez un objet d' CRichEditCtrl en deux étapes.D'abord, appelez le constructeur de CRichEditCtrl , l'appel Créer, qui crée le contrôle d'édition windows et l'attache à l'objet d' CRichEditCtrl .

Lorsque vous créez un contrôle RichEdit avec cette fonction, vous devez d'abord charger la bibliothèque nécessaire de contrôles communs.Pour charger la bibliothèque, appelez la fonction globale AfxInitRichEdit, qui initialise ensuite la bibliothèque de contrôles communs.Vous devez appeler AfxInitRichEdit une seule fois dans votre processus.

Lorsque Créer exécute, windows envoie les messages de WM_NCCREATE, de WM_NCCALCSIZE, de WM_CREATE, et de WM_GETMINMAXINFO au contrôle d'édition.

Ces messages sont gérés par défaut par les fonctions membres d' OnNcCreate, d' OnNcCalcSize, d' OnCreate, et d' OnGetMinMaxInfo dans la classe de base d' CWnd .Pour étendre la gestion des messages par défaut, dérivez une classe d' CRichEditCtrl, ajoutez une table des messages à la nouvelle classe, et substituer les fonctions membres gestionnaires de messages ci-dessus.Substituez OnCreate, par exemple, pour effectuer l'initialisation requise pour la nouvelle classe.

Appliquez styles de fenêtre suivant à un contrôle d'édition.

  • WS_CHILD toujours.

  • WS_VISIBLE habituellement.

  • WS_DISABLED rarement.

  • WS_GROUP aux contrôles de groupe.

  • WS_TABSTOP pour inclure le contrôle d'édition dans l'ordre de tabulation.

Pour plus d'informations sur les styles de fenêtre, consultez CreateWindow dans Kit de développement logiciel Windows.

Exemple

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

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

Classe de CRichEditCtrl

Graphique de la hiérarchie

CRichEditCtrl::CreateEx

CRichEditCtrl::CRichEditCtrl