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