WM_INITDIALOG

O WM_INITDIALOG mensagem é enviada para o procedimento caixa diálogo imediatamente antes que uma caixa de diálogo é exibida. Procedimentos de caixa de diálogo normalmente usam esta mensagem para inicializar controles e realizar outras tarefas de inicialização que afetam a aparência da caixa de diálogo.

WM_INITDIALOG hwndFocus = wParam (HWND); / / identificador de controle para receber foco lInitParam = lParam;       / / parâmetro de inicialização 

 

Parâmetros

hwndFocus

Valor de wParam. Identifica o controle receber o foco do teclado padrão. O sistema atribui o foco do teclado padrão apenas se o procedimento caixa diálogo retorna TRUE.

lInitParam

Valor de lParam. Especifica dados inicialização adicional. Este dados são passados para o sistema como o lParamInit parâmetro em uma chamar para o CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParamou DialogBoxParam função usada para criar a caixa de diálogo. Para folhas de propriedades, este parâmetro é um ponteiro para o PROPSHEETPAGE estrutura usada para criar a página. Este parâmetro será zero se qualquer outra função de criação caixa diálogo é usada.

Retornar valores

O procedimento de caixa de diálogo deve retornar TRUE para direcionar o sistema para definir o foco do teclado para o controle fornecido por hwndFocus. Caso contrário, ela deve retornar FALSE para impedir que o sistema de configuração o foco do teclado padrão.

O procedimento de caixa de diálogo deve retornar o valor diretamente. O valor DWL_MSGRESULT definido pelo SetWindowLong função é ignorado.

Observações

O controle receber o foco do teclado usar como padrão é sempre o primeiro Controlarar na caixa de diálogo que é visível, não desativado, e que tem o estilo WS_TABSTOP. Quando o procedimento caixa diálogo retorna TRUE, o sistema verifica o controle para garantir que o procedimento não tiver desativado-lo. Se tiver sido desativada, o sistema define o foco do teclado para o Avançar Controlarar é visível, não desativado, e tem o WS_TABSTOP.

Um aplicativo pode retornar FALSE somente se ele tiver definido o foco do teclado para um dos controles de caixa de diálogo.

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.

Ver também

Visão geral de caixas de diálogo, mensagens de caixa de diálogo, CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParam, DialogBoxParam, PROPSHEETPAGE, SetFocus

Index