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

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

Синтаксис

WM_INITDIALOG
    WPARAM wParam
    LPARAM lParam;

Параметры

wParam

Дескриптор органа управления, который по умолчанию принимает фокус клавиатуры. Система устанавливает заданный по умолчанию фокус клавиатуры только тогда, если процедура диалогового окна возвратит значение ИСТИНА (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

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

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да версии 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Нет

Заголовочный файл

 

- объявлено в

Winuser.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz