DialogBoxParam

9/9/2008

Essa função cria um restrito caixa de diálogo de um recurso modelo caixa de diálogo. Antes de exibir a caixa 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.

Syntax

int DialogBoxParam( 
  HINSTANCE hInstance, 
  LPCTSTR lpTemplateName, 
  HWND hWndParent, 
  DLGPROC lpDialogFunc, 
  PARAM 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 - 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.

• dwInitParam
  [no] Especifica o valor para transmitir para o caixa de diálogo in a lParam parâmetro da mensagem WM_INITDIALOG.

Return Value

O valor da nResult parâmetro especificado na chamar para o EndDialog função indica sucesso. – 1 Indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

O DialogBoxParam função usa o CreateWindowEx função para criar a caixa diálogo. DialogBoxParam Em seguida, envia uma mensagem WM_INITDIALOG para o procedimento caixa de diálogo. A função exibe a caixa diálogo (regardless of se o modelo especifica o estilo WS_VISIBLE), desativa a janela proprietária e inicia sua própria mensagem executar um loop para recuperar e distribuir mensagens de caixa de diálogo.

Quando o procedimento caixa de diálogo chama o EndDialog função, DialogBoxParam destrói a caixa diálogo termina o executar um loop mensagem, permite a janela proprietária (se anteriormente habilitado) e retorna o valor da nResult parâmetro especificado pelo procedimento caixa de diálogo quando ele chamado EndDialog.

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

CreateWindowEx
DialogBox
DialogBoxIndirect
DialogBoxIndirectParam
DialogProc
EndDialog
WM_INITDIALOG
DLGTEMPLATE
MAKEINTRESOURCE
Dialog Boxes Functions