Compartilhar via


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
Winuser.h (inclua Windows.h)

Confira também

Referência

Createdialogindirectparam

Createdialogparam

Dialogboxindirectparam

Dialogboxparam

SetFocus

Conceitual

Caixas de diálogo

Outros recursos

PROPSHEETPAGE