TVOT_PUSHBUTTON
Внимание
Современная платформа печати — это предпочтительный способ взаимодействия с принтерами Windows. Рекомендуется использовать драйвер класса "Входящие" Microsoft IPP вместе с приложениями поддержки печати (PSA), чтобы настроить возможности печати в Windows 10 и 11 для разработки устройств принтера.
Дополнительные сведения см. в статье "Современная платформа печати" и руководство по проектированию приложений поддержки печати.
Тип параметра TVOT_PUSHBUTTON состоит из кнопки нажатия внутри поля группы.
Структура OPTITEM
Sel/pSel
Зависит от элемента стиля структуры OPTPARAM, как показано ниже.
| Стиль кнопки | Использование Sel/pSel |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | Не используется. |
| PUSHBUTTON_TYPE_DLGPROC | CPSUI сохраняет возвращаемое значение процедуры диалогового окна. |
| PUSHBUTTON_TYPE_HTCLRADJ | CPSUI сохраняет возвращаемое значение операции полутонирования. |
| PUSHBUTTON_TYPE_HTSETUP | CPSUI сохраняет возвращаемое значение операции полутонирования. |
Массив структуры OPTPARAM (элемент pOptParam в OPTTYPE)
pData
Зависит от элемента стиля , как показано ниже.
| Стиль кнопки push | Использование pData |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | Указатель на _CPSUICALLBACK типизированной функции. |
| PUSHBUTTON_TYPE_DLGPROC | Указатель типа DLGPROC на процедуру диалогового окна (см. документацию по пакету SDK для Microsoft Windows). |
| PUSHBUTTON_TYPE_HTCLRADJ | Указатель на структуру COLORADJUSTMENT (описанную в документации по пакету SDK для Windows). |
| PUSHBUTTON_TYPE_HTSETUP | Указатель на структуру DEVHTADJDATA . |
IconID
Определяет значок, связанный с кнопкой нажатия.
lParam зависит от элемента стиля , как показано ниже.
| Стиль кнопки push | Использование lParam |
|---|---|
| PUSHBUTTON_TYPE_CALLBACK | Не используется. |
| PUSHBUTTON_TYPE_DLGPROC | Идентификатор ресурса для ресурса DIALOG или дескриптор структуры DLGTEMPLATE (см. документацию по Windows SDK). Зависит от флага DPF_USE_HDLGTEMPLATE в элементе флагов структуры OPTPARAM. |
| PUSHBUTTON_TYPE_HTCLRADJ | Не используется. |
| PUSHBUTTON_TYPE_HTSETUP | Не используется. |
| Срок | Description |
|---|---|
| Стиль | Указывает операцию, выполняемую CPSUI, когда пользователь нажимает кнопку нажатия кнопки. Может использоваться одно из следующих значений: |
| PUSHBUTTON_TYPE_CALLBACK | CPSUI вызывает функцию обратного вызова _CPSUICALLBACK типа приложения для обработки событий кнопки, при этом член структуры 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
Можно указать следующие необязательные битовые флаги.
| Флаг | Description |
|---|---|
| OTS_PUSH_ENABLE_ALWAYS | Если задано, кнопка нажатия всегда включена, даже если пользователь не может изменить страницу листа свойств (то есть, даже если CPSUIF_UPDATE_PERMISSION не заданы в структуре COMPROPSHEETUI). Функция обратного вызова кнопки должна отображать его диалоговое окно, но не должна разрешать изменения пользователей. Обратите внимание, что этот флаг также необходимо задать в элементе Flags структуры OPTTYPE. |
| OTS_PUSH_INCL_SETUP_TITLE | Если задано, CPSUI включает слово "Настройка" после строки имени кнопки (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".
Требования
Заголовок: compstui.h (include Compstui.h)