Уведомление WM_INITDIALOG

Сообщение WM_INITDIALOG отправляется процедуре диалогового окна непосредственно перед показом на экране диалогового окна. Процедуры диалогового окна обычно используют это сообщение, чтобы инициализировать органы управления и выполнить какие-либо другие задачи инициализации, которые влияют на внешний вид блока диалога.

Дескриптор органа управления, который по умолчанию принимает фокус клавиатуры. Система устанавливает заданный по умолчанию фокус клавиатуры только тогда, если процедура диалогового окна возвратит значение ИСТИНА (TRUE).

lParam

Определяет дополнительные данные инициализации. Эти данные передаются в систему как параметр lParam при вызове функций CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParam или DialogBoxParam, используемых для создания диалогового окна. Для вкладок свойств этот параметр - указатель на структуру PROPSHEETPAGE, используемую, чтобы создать страницу. Этот параметр обнуляется, если использована какая-либо другая функция создания блока диалога.

Процедура диалогового окна должна возвратить значение ИСТИНА (TRUE), чтобы заставить систему установить фокус клавиатуры в орган управления, заданный параметром wParam. Или же, она должна возвратить значение ЛОЖЬ(FALSE), чтобы не допустить систему к установке заданного по умолчанию фокуса клавиатуры.

Процедура диалогового окна должна возвратить значение непосредственно. Значение DWL_MSGRESULT, установленное функцией SetWindowLong, игнорируется.

Орган управления, который принимает заданный по умолчанию фокус клавиатуры, является всегда первым элементом управления в диалоговом окне, которое является видимым, не заблокированным, и оно имеет стиль WS_TABSTOP. Когда процедура диалогового окна возвращает значение ИСТИНА (TRUE), система отмечает этот орган управления, гарантируя, что процедура не отключит его. Если оно заблокировано, система устанавливает фокус клавиатуры в следующем органе управления, который является видимым, не заблокированным и имеет стиль WS_TABSTOP.

Прикладная программа может возвратить значение ЛОЖЬ(FALSE) только тогда, если она установила фокус клавиатуры в одном из органов управления диалогового окна.

Обзор Диалоговые окна, CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParam, DialogBoxParam, PROPSHEETPAGE, SetFocus