Compartilhar via


CreateDialog

Windows Mobile SupportedWindows Embedded CE Supported

9/9/2008

Essa função cria uma sem janela restrita caixa de diálogo de um recurso modelo caixa de diálogo.

Syntax

HWND CreateDialog( 
  HINSTANCE hInstance, 
  LPCTSTR lpTemplate, 
  HWND hWndParent, 
  DLGPROC lpDialogFunc
); 

Parameters

  • hInstance
    [no] Identificador para o módulo cujo arquivo executável contém o modelo caixa diálogo.
  • lpTemplate
    [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 - 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
    [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.

Return Value

O identificador para a caixa diálogo indica sucesso. NULL Indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

O CreateDialog função usa o CreateWindowEx função para criar a caixa diálogo. CreateDialog Em seguida, envia uma WM_INITDIALOG mensagem para o procedimento caixa de diálogo. A função exibe a caixa diálogo se o modelo especifica o estilo WS_VISIBLE. Finalmente, CreateDialog Retorna o manipulador de janela para caixa de diálogo.

Após CreateDialog 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

CreateDialogIndirect
CreateDialogIndirectParam
CreateDialogParam
CreateWindowEx
DestroyWindow
DialogBox
DialogProc
ShowWindow
WM_INITDIALOG
DLGTEMPLATE
Dialog Boxes Functions