CreateDialog

A macro CreateDialog cria uma caixa de diálogo sem janela restrita de um recurso de modelo de caixa de diálogo. A macro CreateDialog usa o CreateDialogParam função.

(HWND CreateDialog HINSTANCE  hInstance, / / identificador de instância de aplicativoLPCTSTRlpTemplate, / / identifica o nome de modelo de caixa de diálogoHWNDhWndParent, / / identificador para janela de proprietárioDLGPROClpDialogFunc / / ponteiro para caixa de diálogo caixa procedimento);
 

Parâmetros

hInstance

Identifica uma instância do módulo cujo arquivo executável contém o modelo caixa diálogo.

lpTemplate

Identifica o modelo de caixa de diálogo. Este parâmetro é o ponteiro para uma Cadeia de caracteres terminada por caractere nulo que especifica o nome do modelo de caixa de diálogo ou um valor inteiro que especifica o identificador de recurso do modelo de caixa de diálogo. Se o parâmetro especifica um identificador recurso, seu alto-ordem palavra deve ser zero e seu baixo-ordem palavra deve conter o identificador. Você pode usar o MAKEINTRESOURCE macro para criar esse valor.

hWndParent

Identifica a janela que possui a caixa de diálogo.

lpDialogFunc

Ponteiro para o procedimento caixa de diálogo. Para obter mais informações sobre o procedimento de caixa de diálogo, consulte DialogProc .

Retornar valores

Se a função for bem-sucedido, o valor de retorno é o identificador para a caixa de diálogo.

Se a função falhar, o valor de retorno é NULL. Para informações de erro estendidas get, chamar GetLastError.

Observações

CreateDialog função usa o CreateWindowEx função para criar a caixa de diálogo. CreateDialog , em seguida, envia uma mensagem WM_INITDIALOG (e uma mensagem WM_SETFONT ) se o modelo especifica o estilo DS_SETFONT para o procedimento caixa de diálogo. A função exibe a caixa de diálogo se o modelo especifica o estilo WS_VISIBLE. Finalmente, CreateDialog retorna o identificador de janela para a caixa de diálogo.

Após CreateDialog retorna, o aplicativo exibe a caixa de diálogo (se não estiver sendo exibida) usando a ShowWindow função. O aplicativo destrói a caixa de diálogo usando o DestroyWindow função.

Windows 95 e posterior:O sistema pode oferecer suporte a um máximo de 255 controles por modelo caixa diálogo. Para colocar mais de 255 controles em uma caixa de diálogo, crie os controles no manipulador de mensagem WM_INITDIALOG em vez de colocá-los no modelo.

Windows CE: Nem todos os estilos são suportados na DLGTEMPLATE estrutura no modelo de diálogo referida pelo parâmetro lpTemplate .

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral de caixas de diálogo, funções de caixa de diálogo, CreateDialogIndirect, CreateDialogIndirectParam, CreateDialogParam, CreateWindowEx, DestroyWindow, DialogBox, DialogProc, ShowWindow, WM_INITDIALOG, WM_SETFONT

Index