CDialog::Create

BOOL Criar ( LPCTSTR lpszTemplateName, CWnd * pParentWnd = Nulo );

BOOL Criar ( UINT nIDTemplate, CWnd * pParentWnd = Nulo );

Valor de retorno

Ambas as formas retornam diferente de zero se a inicialização e criação de caixa de diálogo foram bem sucedidos; caso contrário 0.

Parâmetros

lpszTemplateName

Contém uma seqüência de caracteres null-terminated que é o nome de um recurso de modelo 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 NULL, janela de pai do objeto de caixa de diálogo é definida como a janela principal do aplicativo.

nIDTemplate

Contém o número de identificação de um recurso de modelo caixa de diálogo.

Observações

Chamada criar para criar uma caixa de diálogo sem janela restrita usando um modelo de caixa de diálogo de um recurso. Você pode colocar a chamada criar dentro do Construtor ou chamá-lo depois que o Construtor é invocado.

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

De qualquer forma, passe um ponteiro para o objeto de janela pai. Se pParentWnd for Nulo, a caixa de diálogo será criada com seu pai ou proprietário janela definida para a janela principal do aplicativo.

A função de membro Create retorna imediatamente após ele cria a caixa de diálogo.

Use o estilo WS_VISIBLE no modelo caixa de diálogo se a caixa de diálogo deve aparecer quando o janela pai é criado. Caso contrário, você deve chamar ShowWindow. Para obter mais estilos de caixa de diálogo e sua aplicação, consulte o DLGTEMPLATE estrutura na documentação do Win32 SDK e Estilos de janela no Referência da biblioteca de classe.

Use a função CWnd:: DestroyWindow para destruir uma caixa de diálogo criada por criar função.

Visão geral de CDialogMembros de classe | Gráfico de hierarquia

Consulte tambémnbsp;CDialog::CDialog, CWnd:: DestroyWindow, CDialog::InitModalIndirect, CDialog::DoModal, :: CreateDialog

Index