сообщение 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 , только если фокус клавиатуры установлен на один из элементов управления диалогового окна.

Требования

См. также

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

CreateDialogIndirectParam

CreateDialogParam

DialogBoxIndirectParam

DialogBoxParam

SetFocus

Концептуальный

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

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

PROPSHEETPAGE