CDialog::criar

Artigo
08/25/2010

De telefonarCriar para criar uma caixa de diálogo sem janela restrita, usando um modelo de caixa de diálogo de um recurso.

virtual BOOL Create(
   LPCTSTR lpszTemplateName,
   CWnd* pParentWnd = NULL 
);
virtual BOOL Create(
   UINT nIDTemplate,
   CWnd* pParentWnd = NULL 
);

Parâmetros

lpszTemplateName
Contém uma seqüência de caracteres terminada com nulo que é o nome de um recurso de modelo de caixa de diálogo.
pParentWnd
Aponta para o objeto de janela pai (do tipo CWnd) ao qual pertence o objeto de caixa de diálogo.Se for NULO, janela do pai do objeto de caixa de diálogo é definida como a janela principal do aplicativo.
nIDTemplate
Contém o número de ID de um recurso de modelo de caixa de diálogo.

Valor de retorno

As duas formas de retorno diferente de zero se a caixa de diálogo criação e a inicialização foram bem-sucedida; caso contrário, 0.

Comentários

Você pode colocar a telefonar para Criar dentro do construtor ou chamá-lo depois que o construtor é invocado.

Duas formas do Criarfunção de membro são fornecidos para acessar o recurso de modelo de caixa de diálogo pelo modelo de nome ou número de ID do modelo (por exemplo, IDD_DIALOG1).

Para qualquer formulário passar um ponteiro para o objeto da janela pai.If pParentWnd é NULO, a caixa de diálogo será criada com sua janela pai ou proprietário conjunto na janela principal do aplicativo.

The Criarfunção de membro retorna imediatamente após criar a caixa de diálogo.

Use o WS_VISIBLE estilo no modelo de caixa de diálogo se a caixa de diálogo deve aparecer quando a janela pai é criada.Caso contrário, você deve telefonar ShowWindow. Para obter mais estilos de caixa de diálogo e seus aplicativos, consulte o DLGTEMPLATE estrutura o Windows SDK e Estilos de janela in the Referência da MFC.

Use o CWnd::DestroyWindow função destruir uma caixa de diálogo criada pela Criar função.

Exemplo

void CMyDialog::OnMenuShowSimpleDialog()
{
   //m_pSimpleDialog initialized to NULL in the constructor of CMyDialog class
   m_pSimpleDlg = new CSimpleDlg();
   //Check if new succeeded and we got a valid pointer to a dialog object
   if(m_pSimpleDlg != NULL)
   {
      BOOL ret = m_pSimpleDlg->Create(IDD_SIMPLEDIALOG, this);

      if(!ret)   //Create failed.
         AfxMessageBox(_T("Error creating Dialog"));

      m_pSimpleDlg->ShowWindow(SW_SHOW);
   }
   else
   {
      AfxMessageBox(_T("Error Creating Dialog Object"));
   }
}