сообщение WM_INITDIALOG

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

#define WM_INITDIALOG                   0x0110

Параметры

wParam

Дескриптор элемента управления для получения фокуса клавиатуры по умолчанию. Система назначает фокус клавиатуры по умолчанию, только если процедура диалогового окна возвращает значение TRUE.

lParam

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

Возвращаемое значение

Процедура диалогового окна должна возвращать значение TRUE , чтобы система перенаправляла фокус клавиатуры на элемент управления, заданный wParam. В противном случае он должен вернуть значение FALSE , чтобы система не устанавливала фокус клавиатуры по умолчанию.

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

Комментарии

Элемент управления для получения фокуса клавиатуры по умолчанию всегда является первым элементом управления в диалоговом окне, который отображается, не отключен и имеет WS_TABSTOP стиле. Когда процедура диалогового окна возвращает значение TRUE, система проверяет элемент управления, чтобы убедиться, что процедура не отключила его. Если он был отключен, система устанавливает фокус клавиатуры на следующий элемент управления, который отображается, а не отключен и имеет WS_TABSTOP.

Приложение может возвращать значение FALSE , только если оно настроило фокус клавиатуры на один из элементов управления диалогового окна.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Заголовок	Winuser.h (включая Windows.h)

См. также раздел

Справочные материалы

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

SetFocus

Основные понятия

Диалоговые окна

Другие ресурсы

PROPSHEETPAGE