TVOT_PUSHBUTTON

项目
03/08/2023

重要

建议使用 Microsoft 的 IPP 收件箱类驱动程序，以及 Print Support Apps (PSA) ，在 Windows 10 和 11 中自定义打印体验，以便进行打印机设备开发。

TVOT_PUSHBUTTON选项类型由分组框中的一个推送按钮组成。

OPTITEM 结构

Sel/pSel
取决于 OPTPARAM 结构的 Style 成员，如下所示。

按下按钮样式	Sel/pSel 用法
PUSHBUTTON_TYPE_CALLBACK	未使用。
PUSHBUTTON_TYPE_DLGPROC	CPSUI 存储对话框过程的返回值。
PUSHBUTTON_TYPE_HTCLRADJ	CPSUI 存储半调运算的返回值。
PUSHBUTTON_TYPE_HTSETUP	CPSUI 存储半调运算的返回值。

OPTPARAM 结构数组 (OPTTYPE) 的 pOptParam 成员

pData
取决于 Style 成员，如下所示。

按下按钮样式	pData 用法
PUSHBUTTON_TYPE_CALLBACK	指向 _CPSUICALLBACK类型函数的指针。
PUSHBUTTON_TYPE_DLGPROC	指向对话框过程的 DLGPROC 类型指针 (请参阅Microsoft Windows SDK文档) 。
PUSHBUTTON_TYPE_HTCLRADJ	指向 WINDOWS SDK 文档) 中所述的 COLORADJUSTMENT 结构的指针 (。
PUSHBUTTON_TYPE_HTSETUP	指向 DEVHTADJDATA 结构的指针。

IconID
标识要与推送按钮关联的图标。

lParam 取决于 Style 成员，如下所示。

按下按钮样式	lParam 用法
PUSHBUTTON_TYPE_CALLBACK	未使用。
PUSHBUTTON_TYPE_DLGPROC	DIALOG 资源的资源标识符或 DLGTEMPLATE 结构的句柄 (请参阅 Windows SDK 文档) 。取决于 OPTPARAM 结构的 Flags 成员中的DPF_USE_HDLGTEMPLATE标志。
PUSHBUTTON_TYPE_HTCLRADJ	未使用。
PUSHBUTTON_TYPE_HTSETUP	未使用。

术语	说明
Style	指定当用户单击按钮时 CPSUI 要执行的操作。可以是以下其中一个值：
PUSHBUTTON_TYPE_CALLBACK	CPSUI 调用应用程序的 _CPSUICALLBACK类型的回调函数来处理按钮事件， CPSUICBPARAM 结构的 Reason 成员设置为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

风格可以指定以下可选位标志。

标志	描述
OTS_PUSH_ENABLE_ALWAYS	如果设置，则始终启用推送按钮，即使用户无法修改属性表页 (即，即使未在 COMPROPSHEETUI 结构) 中设置CPSUIF_UPDATE_PERMISSION也是如此。推送按钮的回调函数必须显示其对话框，但不得允许用户修改。请注意，还必须在 OPTTYPE 结构的 Flags 成员中设置此标志。
OTS_PUSH_INCL_SETUP_TITLE	如果已设置，CPSUI 在 OPTITEM) 中的按钮名称字符串 (pName 后包含单词“Setup”。
OTS_PUSH_NO_DOT_DOT_DOT	如果已设置，CPSUI 在 OPTITEM) 中按钮的名称字符串 (pName 后面包含三个点 (...) 。

BegCtrlID
如果 COMPROPSHEETUI 中的 pDlgPage 标识 CPSUI 提供的页面，或者 DLGPAGE 中的 DlgTemplateID 标识 CPSUI 提供的模板，则不使用 BegCtrlID。否则， BegCtrlID 必须包含按顺序编号的控件标识符集的第一个控件标识符。控件标识符必须标识以下 Windows 控件：

控件标识符	Windows 控件
BegCtrlID 内容	分组框
BegCtrlID 内容+1	标题文本
BegCtrlID 内容+2	按钮框
BegCtrlID 内容+3	按下按钮图标
BegCtrlID 内容+4	扩展复选框或扩展按钮 (可选)
BegCtrlID 内容+5	扩展复选框或扩展按钮图标 (可选)