DialogBox

A macro DialogBox cria um restrito caixa diálogo de um recurso de modelo de 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. A DialogBox macro usa a DialogBoxParam função.

int (DialogBox HINSTANCE  hInstance, / / identificador de instância de aplicativoLPCTSTRlpTemplate, / / identifica o modelo de caixa de diálogo HWNDhWndParent, / / identificador para janela de proprietárioDLGPROClpDialogFunc / / ponteiro para caixa de diálogo caixa procedimento);
 

Parâmetros

hInstance

Identifica uma instância do módulo cujo arquivo executável contém o modelo caixa diálogo.

lpTemplate

Identifica o modelo de caixa de diálogo. Este parâmetro é o ponteiro para uma Cadeia de caracteres terminada por caractere nulo que especifica o nome do modelo de caixa de diálogo ou um valor inteiro que especifica o identificador de recurso do modelo de 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

Identifica a janela que possui a caixa de diálogo.

lpDialogFunc

Ponteiro para o procedimento caixa de diálogo. Para obter mais informações sobre o procedimento de caixa de diálogo, consulte DialogProc .

Retornar valores

Se a função for bem-sucedido, o valor de retorno é nResult parâmetro na chamar para o EndDialog função usado para encerrar a caixa de diálogo.

Se a função falhar, o valor de retorno é – 1. Para informações de erro estendidas get, chamar GetLastError.

Observações

A DialogBox macro usa o CreateWindowEx função para criar a caixa de diálogo. DialogBox em seguida, envia uma mensagem WM_INITDIALOG (e uma mensagem WM_SETFONT) se o modelo especifica o estilo DS_SETFONT para o procedimento caixa de diálogo. A função exibe a caixa de diálogo (independentemente de saber se o modelo especifica o estilo WS_VISIBLE), desativa a janela proprietária e inicia seu próprio loop de mensagem para recuperar e distribuir mensagens para a 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 nResult parâmetro especificado pelo procedimento caixa de diálogo quando ele chamado EndDialog.

Windows 95 e posterior:O sistema pode oferecer suporte a um máximo de 255 controles por modelo caixa diálogo. Para colocar mais de 255 controles em uma caixa de diálogo, crie os controles no manipulador de mensagem WM_INITDIALOG em vez de colocá-los no modelo.

Windows CE: Nem todos os estilos são suportados na DLGTEMPLATE estrutura no modelo de diálogo referida pelo parâmetro lpTemplate .

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral de caixas de diálogo, funções de caixa de diálogo, CreateDialog, CreateWindowEx, DialogBoxIndirect, DialogBoxIndirectParam, DialogBoxParam, DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, WM_SETFONT

Index