TVOT_PUSHBUTTON
重要
新式打印平台是 Windows 与打印机通信的首选方式。 建议使用 Microsoft 的 IPP 收件箱类驱动程序以及打印支持应用 (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 | 指向 COLORADJUSTMENT 结构的指针（在 Windows SDK 文档中介绍）。 |
| 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 | 未使用。 |
| 术语 | 说明 |
|---|---|
| 样式 | 指定当用户单击按钮时由 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 | 如果已设置，即使用户无法修改属性表页面（即，即使 CPSUIF_UPDATE_PERMISSION 未在 COMPROPSHEETUI 结构中设置），按钮也始终处于启用状态。 按钮的回调函数必须显示其对话框，但不得允许用户修改。 请注意，还必须在 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 标识了 CPS 提供的模板，则不使用 BegCtrlID。 否则，BegCtrlID 必须包含一组按顺序编号的控制标识符的第一个控件标识符。 控件标识符必须标识以下 Windows 控件：
| 控件标识符 | Windows 控件 |
|---|---|
| BegCtrlID 内容 | 分组框 |
| BegCtrlID 内容+1 | 标题文本 |
| BegCtrlID 内容+2 | 按钮框 |
| BegCtrlID 内容+3 | 按钮图标 |
| BegCtrlID 内容+4 | “扩展”复选框或扩展按钮（可选） |
| BegCtrlID 内容+5 | “扩展”复选框或扩展按钮图标（可选） |
有关其他信息，请参阅自定义 CPSUI 支持的窗口控件。
要求
标头：compstui.h（包括 Compstui.h）