Compartilhar via


CRichEditCtrl::Create

Cria o controle de edição aplicativos do windows e associá-la com esse objeto de CRichEditCtrl .

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

Parâmetros

  • dwStyle
    Especifica o estilo do controle de edição. Aplicar uma combinação de estilos de janela listados na seção de Comentários em, e estilos de controle edit, descrito em Windows SDK.

  • rect
    Especifica o tamanho e a posição do controle de edição. Pode ser um objeto de CRect ou uma estrutura de RECT .

  • pParentWnd
    Especifica a janela pai do controle de edição (geralmente CDialog). Não deve ser NULO.

  • nID
    Especifica a identificação de controle edit

Valor de retorno

Diferente de zero se a inicialização for bem-sucedida; caso contrário, 0.

Comentários

Você constrói um objeto de CRichEditCtrl em duas etapas. Primeiro, chamar o construtor de CRichEditCtrl , então a chamada Criar, que cria o controle de edição do windows e anexa o ao objeto de CRichEditCtrl .

Quando você cria um controle de edição rico com essa função, primeiro você deve carregar a biblioteca necessária dos controles comuns. Para carregar a biblioteca, chame a função global AfxInitRichEdit, que inicializa por sua vez a biblioteca de controles comuns. Você precisará chamar apenas uma vez AfxInitRichEdit no processo.

Quando Criar é executado, o envia mensagens de WM_NCCREATE, de WM_NCCALCSIZE, de WM_CREATE, e de WM_GETMINMAXINFO ao controle de edição.

Essas mensagens são tratadas por padrão pelas funções de membro de OnNcCreate, de OnNcCalcSize, de OnCreate, e de OnGetMinMaxInfo na classe base de CWnd . Para estender tratamento de mensagem padrão, derive uma classe de CRichEditCtrl, adicione um mapa de mensagem para a nova classe, e substituir as funções de membro anterior de mensagem- manipulador. Substitua OnCreate, por exemplo, para executar a inicialização necessário para a nova classe.

Aplicar a seguir estilos de janela a um controle de edição.

  • WS_CHILD sempre.

  • GeralmenteWS_VISIBLE .

  • WS_DISABLED contrário.

  • WS_GROUP para os controles de grupo.

  • WS_TABSTOP para incluir o controle de edição na ordem de tabulação.

Para obter mais informações sobre estilos de janela, consulte CreateWindow em Windows SDK.

Exemplo

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

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe CRichEditCtrl

Gráfico da hierarquia

CRichEditCtrl::CreateEx

CRichEditCtrl::CRichEditCtrl