CreateDialogParam
9/9/2008
Essa função cria uma sem janela restrita caixa de diálogo de um recurso modelo caixa de diálogo. Antes de exibir a caixa diálogo, ela 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.
Syntax
HWND CreateDialogParam(
HINSTANCE hInstance,
LPCTSTR lpTemplateName,
HWND hWndParent,
DLGPROC lpDialogFunc,
LPARAM dwInitParam
);
Parameters
- hInstance
[no] Identificador para o módulo cujo arquivo executável contém o modelo caixa diálogo.
- lpTemplateName
[no] Ponteiro longo para o modelo caixa diálogo. Este parâmetro é o ponteiro para uma que especifica o nome do modelo de caixa de diálogo seqüência de caracteres NULL-Terminated ou um valor inteiro que especifica o identificador recurso de modelo caixa de diálogo. Se o parâmetro especifica um identificador recurso, seu alto - palavra ordem deve ser zero e baixo-ordem palavra deve conter o identificador. Você pode usar o MAKEINTRESOURCE macro para criar esse valor.
- hWndParent
[no] Identificador para a janela proprietária caixa de diálogo.
- lpDialogFunc
[no] Ponteiro longo para o procedimento caixa de diálogo. Para obter mais informações sobre o procedimento caixa de diálogo, consulte DialogProc.
- dwInitParam
[no] Especifica o valor para transmitir para o procedimento caixa de diálogo in a lParam parâmetro na mensagem de WM_INITDIALOG.
Return Value
O manipulador de janela para caixa de diálogo indica sucesso. NULL Indica falha. Para informações de erro estendidas get, chamar GetLastError.
Remarks
O CreateDialogParam função usa o CreateWindowEx função para criar a caixa diálogo. CreateDialogParam Em seguida, envia uma mensagem WM_INITDIALOG para o procedimento caixa de diálogo. A função exibe a caixa diálogo se o modelo especifica o estilo WS_VISIBLE. Finalmente, CreateDialogParam Retorna o identificador janela da caixa de diálogo.
Após CreateDialogParam Retorna, o aplicativo exibe a caixa diálogo (se ele não estiver exibido) usando o ShowWindow função. O aplicativo destrói caixa de diálogo usando o DestroyWindow função.
Windows Embedded CE não todos os estilos no suporte a DLGTEMPLATE estrutura. Essa estrutura consta o modelo identificado pelo lpTemplate parâmetro*.*
Requirements
Header | winuser.h |
Windows Embedded CE | Windows CE 1.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
CreateDialog
CreateDialogIndirect
CreateDialogIndirectParam
CreateWindowEx
DestroyWindow
DialogProc
ShowWindow
MAKEINTRESOURCE
WM_INITDIALOG
WM_SETFONT
DLGTEMPLATE
Dialog Boxes Functions