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

See Also

Reference

CreateDialogIndirectParam
CreateDialogParam
DialogBoxIndirectParam
DialogBoxParam
SetFocus
SetWindowLong
PROPSHEETPAGE
Dialog Boxes Messages