WM_INITDIALOG mensagem

Enviado para o procedimento da caixa de diálogo imediatamente antes de uma caixa de diálogo ser exibida. Os procedimentos da caixa de diálogo normalmente usam essa mensagem para inicializar controles e executar 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 atribui o foco padrão do teclado 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. Este parâmetro é zero se qualquer outra função de criação de caixa de diálogo for usada.

Valor de retorno

O procedimento da caixa de diálogo deve retornar TRUE para direcionar o sistema para definir o foco do teclado para o controle especificado pelo wParam. Caso contrário, ele deve retornar FALSE para impedir que o sistema defina 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.

Observações

O controle para receber o foco padrão do teclado é sempre o primeiro controle na caixa de diálogo que está visível, não desativado 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 desativou. Se tiver sido desativado, o sistema define o foco do teclado para o próximo controle que está visível, não desativado e tem o WS_TABSTOP.

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

Requerimentos

Consulte também

Referência

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

SetFocus

Conceptual

Caixas de diálogo

Outros recursos

PROPSHEETPAGE