TVOT_PUSHBUTTON

Статья
03/08/2023

Важно!

Мы рекомендуем использовать драйвер класса "Входящие" корпорации Майкрософт, а также приложения для поддержки печати (PSA) корпорации Майкрософт, чтобы настроить возможности печати в Windows 10 и 11 для разработки принтеров.

Дополнительные сведения см. в руководстве по проектированию приложений поддержки печати.

Тип параметра TVOT_PUSHBUTTON состоит из кнопки push внутри поля группы.

Структура OPTITEM

Sel/pSel
Зависит от элемента Style структуры OPTPARAM, как показано ниже.

Стиль кнопки	Использование Sel/pSel
PUSHBUTTON_TYPE_CALLBACK	Не используется.
PUSHBUTTON_TYPE_DLGPROC	CPSUI хранит возвращаемое значение процедуры диалогового окна.
PUSHBUTTON_TYPE_HTCLRADJ	CPSUI сохраняет возвращаемое значение операции полутонов.
PUSHBUTTON_TYPE_HTSETUP	CPSUI сохраняет возвращаемое значение операции полутонов.

Массив структуры OPTPARAM (элемент pOptParam optTYPE)

Pdata
Зависит от элемента Style , как показано ниже.

Стиль кнопки	Использование pData
PUSHBUTTON_TYPE_CALLBACK	Указатель на _CPSUICALLBACK типизированные функции.
PUSHBUTTON_TYPE_DLGPROC	Указатель на процедуру диалогового окна с типом DLGPROC (см. документацию по Microsoft Windows SDK).
PUSHBUTTON_TYPE_HTCLRADJ	Указатель на структуру COLORADJUSTMENT (описано в документации windows SDK).
PUSHBUTTON_TYPE_HTSETUP	Указатель на структуру DEVHTADJDATA .

IconID
Определяет значок, связанный с кнопкой нажатия.

Lparam Зависит от элемента Style , как показано ниже.

Стиль кнопки	Использование lParam
PUSHBUTTON_TYPE_CALLBACK	Не используется.
PUSHBUTTON_TYPE_DLGPROC	Идентификатор ресурса для ресурса DIALOG или дескриптор структуры DLGTEMPLATE (см. документацию по Windows SDK). Зависит от флага DPF_USE_HDLGTEMPLATE в элементе Flags структуры OPTPARAM.
PUSHBUTTON_TYPE_HTCLRADJ	Не используется.
PUSHBUTTON_TYPE_HTSETUP	Не используется.

Термин	Описание
Стиль	Указывает операцию, выполняемую CPSUI, когда пользователь нажимает кнопку push. Может иметь одно из следующих значений:
PUSHBUTTON_TYPE_CALLBACK	CPSUI вызывает функцию обратного вызова приложения с _CPSUICALLBACK типом для обработки событий кнопки, а для элемента Reason структуры CPSUICBPARAM задано значение CPSUICB_REASON_PUSHBUTTON. (CPSUI игнорирует возвращаемое значение функции обратного вызова.)
PUSHBUTTON_TYPE_DLGPROC	Процедура диалогового окна приложения обрабатывает события кнопки. (Дополнительные сведения см. в разделе Примечания для DLGPAGE.) Когда функция получает сообщение WM_INITDIALOG, ее аргумент lParam указывает на структуру CPSUICBPARAM с элементом Reason , равным CPSUICB_REASON_DLGPROC.
PUSHBUTTON_TYPE_HTCLRADJ	В CPSUI отображается диалоговое окно настройки полутонового цвета.
PUSHBUTTON_TYPE_HTSETUP	CPSUI отображает диалоговое окно настройки полутона устройства.

Структура OPTTYPE

Тип TVOT_PUSHBUTTON

Число 1

Стиль Можно указать следующие необязательные битовые флаги.

Flag	Описание
OTS_PUSH_ENABLE_ALWAYS	Если задано значение , кнопка push всегда включена, даже если пользователь не может изменить страницу страницы свойств (т. е. даже если CPSUIF_UPDATE_PERMISSION не задан в структуре COMPROPSHEETUI ). Функция обратного вызова кнопки push-кнопки должна отображать свое диалоговое окно, но не должна разрешать изменения пользователей. Обратите внимание, что этот флаг также необходимо задать в элементе Flags структуры OPTTYPE .
OTS_PUSH_INCL_SETUP_TITLE	Если этот параметр задан, CPSUI включает слово "Setup" после строки имени кнопки (pName в OPTITEM).
OTS_PUSH_NO_DOT_DOT_DOT	Если этот параметр задан, CPSUI содержит три точки (...) после строки имени кнопки (pName в OPTITEM).

BegCtrlID
Если pDlgPage в COMPROPSHEETUI определяет предоставленную CPSUI страницу или если DlgTemplateID в DLGPAGE определяет предоставленный CPSUI шаблон, BegCtrlID не используется. В противном случае BegCtrlID должен содержать первый идентификатор элемента управления последовательно пронумерованного набора идентификаторов элементов управления. Идентификаторы элементов управления должны идентифицировать следующие элементы управления Windows:

Идентификатор элемента управления	Элемент управления Windows
Содержимое BegCtrlID	Группа
Содержимое BegCtrlID +1	Текст заголовка
Содержимое BegCtrlID +2	Кнопка "Отправить"
Содержимое BegCtrlID +3	Значок кнопки
Содержимое BegCtrlID +4	Расширенный флажок или расширенная кнопка (необязательно)
Содержимое BegCtrlID +5	Расширенный флажок или значок расширенной кнопки (необязательно)

Дополнительные сведения см. в разделе Настройка CPSUI-Supported оконных элементов управления.

Требования

Заголовок: compstui.h (включая Compstui.h)

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

OPTITEM

OPTPARAM

OPTTYPE