TVOT_LISTBOX

重要

新式打印平台是 Windows 与打印机通信的首选方式。 建议使用 Microsoft 的 IPP 收件箱类驱动程序以及打印支持应用 (PSA) 来自定义 Windows 10 和 11 中的打印体验,以便进行打印机设备开发。

有关详细信息,请参阅新式打印平台打印支持应用设计指南

TVOT_LISTBOX 选项类型由组框中的列表框组成。

OPTITEM 结构

Sel/pSel
指向该选项的 OPTTYPE 结构的 pOptParam 成员的 OPTPARAM 数组的索引。 这指定当前选定的选项参数。

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

pData
pOptParam[0]->pData 指向要在列表框中显示的第一个文本字符串。 pOptParam[1]->pData 指向要在列表框中显示的第二个文本字符串。 pOptParam[n]->pData 指向要在列表框中显示的第 n 个文本字符串。

IconID
pOptParam[0]->IconID 标识要与第一个文本字符串关联的图标。 pOptParam[1]->IconID 标识要与第二个文本字符串关联的图标。 pOptParam[n]->IconID 标识要与第 n 个文本字符串关联的图标。

lParam
未使用。

OPTTYPE 结构

类型
TVOT_LISTBOX

计数
OPTPARAM 结构的数量;即要在列表框中显示的文本字符串的数量。

样式
可以指定以下可选位标志。

标记 说明
OTS_LBCB_INCL_ITEM_NONE 如果已设置,则 CPSUI 将在列表框中包含一个“无”字符串。 如果用户选择“无”,则 Sel/pSel 并集设置为 -1。
OTS_LBCB_NO_ICON16_IN_ITEM 如果已设置,则 CPSUI 在列表框中显示参数的值时,不会绘制每个选项参数的图标(OPTPARAM 中的 IconID)。
OTS_LBCB_PROPPAGE_LBUSECB 当该选项显示在非树视图属性表页上时,它将显示为组合框而不是列表框。
OTS_LBCB_SORT 如果已设置,则 CPSUI 将按字母顺序显示文本字符串。

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)

另请参阅

OPTITEM

OPTPARAM

OPTTYPE