CreateDialogParam

O CreateDialogParam função cria uma caixa de diálogo sem janela restrita de um recurso de modelo de caixa de diálogo. Antes de exibir a caixa de diálogo, a função passa um application-defined value para o procedimento caixa de diálogo como o lParam parâmetro da mensagem WM_INITDIALOG . Um aplicativo pode usar esse valor para inicializar controles caixa de diálogo.

(HWND CreateDialogParam HINSTANCE  hInstance, / / identificador de instância de aplicativoLPCTSTRlpTemplateName, / / identifica o modelo de caixa de diálogoHWNDhWndParent, / / identificador para janela de proprietárioDLGPROClpDialogFunc, / / ponteiro para caixa de diálogo caixa procedimentoLPARAMdwInitParam / / valor de inicialização);
 

Parâmetros

hInstance

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

lpTemplateName

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 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 .

dwInitParam

Especifica o valor para passar para o procedimento caixa de diálogo in a lParam parâmetro da mensagem WM_INITDIALOG.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é o identificador de janela 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

O CreateDialogParam função usa o CreateWindowEx função para criar a caixa de diálogo. CreateDialogParam 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, CreateDialogParam retorna o identificador da janela da caixa de diálogo.

Após CreateDialogParam 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 lpTemplateName .

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, CreateDialog, CreateDialogIndirect, CreateDialogIndirectParam, CreateWindowEx, DestroyWindow, DialogProc, MAKEINTRESOURCE, ShowWindow, WM_INITDIALOG, WM_SETFONT

Index