Partilhar via


CRichEditCtrl::criar

Cria rich Windows controle de edição e associa esse CRichEditCtrl objeto.

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

Parâmetros

  • dwStyle
    Especifica o estilo de controle de edição.Aplicar uma combinação dos estilos de janela listado no Comentários seção abaixo e edição estilos de controle, descrito no Windows SDK.

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

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

  • nID
    Especifica a ID. do controle de edição

Valor de retorno

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

Comentários

Construir um CRichEditCtrl objeto em duas etapas. Primeiro, chamar o CRichEditCtrl construtor e, em seguida, telefonar Criarcontrole de edição e a anexa o , que cria o WindowsCRichEditCtrl objeto.

Quando você cria um controle rich edição com essa função, primeiro você deve carregar a biblioteca de controles comuns necessários.Para carregar a biblioteca telefonar a função global AfxInitRichEdit, que por sua vez inicializa a biblioteca de controles comuns.Você precisará telefonar AfxInitRichEdit somente uma vez no seu processo.

Quando Criar executa, o Windows envia o WM_NCCREATE, WM_NCCALCSIZE, WM_CREATE, and WM_GETMINMAXINFO mensagens para o controle de edição.

Essas mensagens são manipuladas pelo padrão, a OnNcCreate, OnNcCalcSize, OnCreate, and OnGetMinMaxInfo funções de membro a CWnd classe base. Para estender a manipulação de mensagem padrão, derivar uma classe de CRichEditCtrl, adicione um MAP da mensagem a nova classe e substituir as funções de membro acima do manipulador de mensagens. Substituir OnCreate, por exemplo executar precisava ser inicializada para a nova classe.

Aplicar o seguinte estilos de janela para um controle de edição.

  • WS_CHILD   Sempre.

  • WS_VISIBLE   Em geral.

  • WS_DISABLED   Raramente.

  • WS_GROUP   Para agrupar controles.

  • 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 in the 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 de hierarquia

CRichEditCtrl::CreateEx

CRichEditCtrl::CRichEditCtrl

Outros recursos

CRichEditCtrl membros