DialogBox

9/9/2008

Essa função cria um restrito caixa de diálogo de um recurso modelo caixa de diálogo. DialogBox Não retornar controle até que a função callback especificada termina de restrito caixa diálogo por chamado de EndDialog função.

Syntax

int DialogBox( 
  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 valor da nResult parâmetro na chamar para o EndDialog função indica sucesso. – 1 Indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

O DialogBox macro usa o CreateWindowEx função para criar a caixa diálogo. DialogBox 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, DialogBox 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

CreateDialog
CreateWindowEx
DialogBoxIndirect
DialogBoxIndirectParam
DialogBoxParam
DialogProc
EndDialog
WM_INITDIALOG
DLGTEMPLATE
MAKEINTRESOURCE
Dialog Boxes Functions