WM_INITDIALOG

9/9/2008

Esta mensagem é enviada para o procedimento caixa diálogo imediatamente antes que uma caixa diálogo seja exibida. Use geralmente procedimentos caixa de diálogo esta mensagem para inicializar controles e contêm quaisquer outras tarefas inicialização que afetam a aparência da caixa de diálogo.

Syntax

WM_INITDIALOG hwndFocus = (HWND) wParam;
    lInitParam = lParam;

Parameters

• hwndFocus
  Identificador para o controle para receber o foco do teclado usar como padrão. O sistema atribui a foco do teclado usar como padrão somente se o procedimento caixa diálogo retorna TRUE.

• lInitParam
  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, DialogBoxIndirectParam, ou DialogBoxParam função usada para criar a caixa diálogo. Propriedade folhas, este parâmetro é um ponteiro para o PROPSHEETPAGE estrutura usada para criar a página. Este parâmetro será zero se a qualquer outra função de criação caixa de diálogo é usada.

Return Value

O procedimento caixa de diálogo deve retornar TRUE para direcionar o sistema para definir o foco do teclado para o controle indicado por hwndFocus. Caso contrário, ele deve retornar FALSE para evitar o sistema de configuração de foco do teclado usar como padrão.

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

Remarks

O controle receber o foco do teclado usar como padrão é sempre o primeiro controle na caixa de diálogo que é visível, não desativado, e que possui o estilo WS_TABSTOP. Quando o procedimento caixa de diálogo retorna TRUE, o sistema verifica o controle para garantir que o procedimento não tiver desativado-lo. Se ele foi desativado, o sistema define o foco do teclado para o próximo controle que é 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.

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

CreateDialogIndirectParam
CreateDialogParam
DialogBoxIndirectParam
DialogBoxParam
SetFocus
SetWindowLong
PROPSHEETPAGE
Dialog Boxes Messages