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

See Also

Reference

CreateDialog
CreateDialogIndirect
CreateDialogIndirectParam
CreateWindowEx
DestroyWindow
DialogProc
ShowWindow
MAKEINTRESOURCE
WM_INITDIALOG
WM_SETFONT
DLGTEMPLATE
Dialog Boxes Functions