CRichEditCtrl::Create

Crea il controllo Rich Edit di Windows e lo associa a questo oggetto CRichEditCtrl.

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

Parametri

  • dwStyle
    Specifica lo stile del controllo di modifica.Applica una combinazione degli stili della finestra elencati nella sezione Note sotto e stili del controllo di modifica, descritto in Windows SDK.

  • rect
    Specifica la dimensione e la posizione del controllo di modifica.Può essere un oggetto CRect o una struttura RECT.

  • pParentWnd
    Specifica la finestra padre del controllo di modifica (spesso CDialog).Non deve essere NULL.

  • nID
    Specifica l'id controllo di modifica

Valore restituito

Diverso da zero se tale operazione ha esito positivo; in caso contrario, 0.

Note

Costruisce un oggetto CRichEditCtrl in due passaggi.Innanzitutto, chiamare il costruttore CRichEditCtrl, la chiamata Crea, che crea il controllo di modifica di Windows e lo aggiunge all'oggetto CRichEditCtrl.

Quando si crea un controllo Rich Edit con questa funzione, è innanzitutto necessario caricare la libreria necessaria dei controlli.Per caricare la raccolta, chiamare la funzione globale AfxInitRichEdit, che a sua volta inizializzata la raccolta di controlli comuni.È necessario chiamare solo una volta AfxInitRichEdit nel processo.

Quando Crea esegue Windows, invia i messaggi WM_NCCREATE, WM_NCCALCSIZE, WM_CREATEe WM_GETMINMAXINFO al controllo di modifica.

Questi messaggi sono gestiti per impostazione predefinita dalle funzioni membro OnNcCreate, OnNcCalcSize, OnCreatee OnGetMinMaxInfo nella classe base CWnd.Per estendere la gestione dei messaggi predefinito, derivare una classe da CRichEditCtrl, aggiungere una mappa messaggi alla nuova classe ed esegue l'override della funzione membro per la gestione dei messaggi sopra.Eseguire l'override OnCreate, ad esempio, per eseguire l'inizializzazione necessaria per la nuova classe.

Applicare seguente stili della finestra a un controllo di modifica.

  • WS_CHILD sempre.

  • WS_VISIBLE normalmente.

  • WS_DISABLED raramente.

  • WS_GROUP ai controlli.

  • WS_TABSTOP per includere controllo di modifica nell'ordine di tabulazione.

Per ulteriori informazioni sugli stili della finestra, vedere CreateWindow in Windows SDK.

Esempio

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

Requisiti

Header: afxcmn.h

Vedere anche

Riferimenti

Classe di CRichEditCtrl

Grafico della gerarchia

CRichEditCtrl::CreateEx

CRichEditCtrl::CRichEditCtrl