Win32 API. Справочник по диалоговому окну
Страница 42. Сообщение WM_INITDIALOG

Сообщение WM_INITDIALOG

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

Синтаксис

WM_INITDIALOG
hwndFocus = (HWND) wParam; // дескриптор блока диалога принявшего
// фокус ввода
lInitParam = lParam; // параметры инициализации 

Параметры
hwndFocus
Значение wParam. Идентифицирует орган управления, который по умолчанию принимает фокус клавиатуры. Windows устанавливает заданный по умолчанию фокус клавиатуры только тогда, если процедура диалогового окна возвратит значение ИСТИНА (TRUE).
lInitParam
Значение lParam. Определяет дополнительные данные инициализации. Эти данные передаются в Windows как параметр lParamInit при вызове функций CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParam или DialogBoxParam, используемых для создания диалогового окна. Этот параметр нулевой, если использована другая функция создания блока диалога.

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

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

Смотри также
CreateDialogIndirectParam, CreateDialogParam, DialogBoxIndirectParam, DialogBoxParam, SetFocus

Размещение и совместимость WM_INITDIALOG

Windows NTДа 
Win95Да 
Win32sДа 
Импортируемая библиотека- 
Заголовочный файлwinuser.h 
UnicodeНет 
Замечания по платформеНе имеется