DialogBoxParam

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

int (DialogBoxParam HINSTANCE  hInstance, / / identificador de instância de aplicativoLPCTSTRlpTemplateName, / / identifica o modelo de caixa de diálogoHWNDhWndParent, / / identificador para janela de proprietárioDLGPROClpDialogFunc, / / ponteiro para caixa de diálogo caixa procedimentoLPARAMdwInitParam / / valor de inicialização);
 

Parâmetros

hInstance

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

lpTemplateName

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 .

dwInitParam

Especifica o valor para passar para a caixa de diálogo in a lParam parâmetro da mensagem WM_INITDIALOG.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é o valor da nResult parâmetro especificado 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 DialogBoxParam função usa o CreateWindowEx função para criar a caixa de diálogo. DialogBoxParam 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, DialogBoxParam 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 lpTemplateName .

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, CreateWindowEx, DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, WM_SETFONT

Index