WM_INITDIALOG mensagem
Enviado para o procedimento da caixa de diálogo imediatamente antes que uma caixa de diálogo seja exibida. Normalmente, os procedimentos da caixa de diálogo usam essa mensagem para inicializar controles e realizar quaisquer outras tarefas de inicialização que afetem a aparência da caixa de diálogo.
#define WM_INITDIALOG 0x0110
Parâmetros
-
wParam
-
Um identificador para o controle para receber o foco padrão do teclado. O sistema atribuirá o foco de teclado padrão somente se o procedimento da caixa de diálogo retornar TRUE.
-
lParam
-
Dados de inicialização adicionais. Esses dados são passados para o sistema como o parâmetro lParam em uma chamada para a função CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParam ou DialogBoxParam usada para criar a caixa de diálogo. Para folhas de propriedades, esse parâmetro é um ponteiro para a estrutura PROPSHEETPAGE usada para criar a página. Esse parâmetro será zero se qualquer outra função de criação de caixa de diálogo for usada.
Valor retornado
O procedimento da caixa de diálogo deve retornar TRUE para direcionar o sistema para definir o foco do teclado para o controle especificado por wParam. Caso contrário, ele deverá retornar FALSE para impedir que o sistema configure o foco padrão do teclado.
O procedimento da caixa de diálogo deve retornar o valor diretamente. O valor DWL_MSGRESULT definido pela função SetWindowLong é ignorado.
Comentários
O controle para receber o foco do teclado padrão é sempre o primeiro controle na caixa de diálogo visível, não desabilitado e que tem o estilo WS_TABSTOP . Quando o procedimento da caixa de diálogo retorna TRUE, o sistema verifica o controle para garantir que o procedimento não o tenha desabilitado. Se ele tiver sido desabilitado, o sistema definirá o foco do teclado para o próximo controle visível, não desabilitado e terá o WS_TABSTOP.
Um aplicativo só poderá retornar FALSE se tiver definido o foco do teclado como um dos controles da caixa de diálogo.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
Confira também
-
Referência
-
Conceitual
-
Outros recursos