OPTPARAM 结构 (compstui.h)

项目
02/22/2024

OPTPARAM 结构的数组由 CPSUI 应用程序使用， (包括打印机接口 DLL) ，用于描述与属性表选项关联的所有参数值。数组的地址包含在 OPTTYPE 结构中。

语法

typedef struct _OPTPARAM {
  WORD      cbSize;
  BYTE      Flags;
  BYTE      Style;
  LPTSTR    pData;
  ULONG_PTR IconID;
  LPARAM    lParam;
  ULONG_PTR dwReserved[2];
} OPTPARAM, *POPTPARAM;

成员

cbSize

OPTPARAM 结构的大小（以字节为单位）。

Flags

用于修改参数特征的可选位标志。可以任意组合设置以下标志：

OPTPF_DISABLED

如果设置了参数，则参数不可由用户选择。可与以下选项类型一起使用：

OPTPF_HIDE

如果设置了，则参数不会显示在树视图中。可与以下选项类型一起使用：

TVOT_3STATES

TVOT_COMBOBOX

TVOT_LISTBOX

OPTPF_ICONID_AS_HICON

如果设置， IconID 成员包含图标句柄。

如果未设置， IconID 成员包含图标资源标识符。

OPTPF_OVERLAY_NO_ICON

如果已设置，CPSUI 会将其IDI_CPSUI_NO图标覆盖到 IconID 成员标识的图标上。

OPTPF_OVERLAY_STOP_ICON

如果已设置，CPSUI 会将IDI_CPSUI_STOP图标覆盖到 IconID 成员标识的图标上。

OPTPF_OVERLAY_WARNING_ICON

如果已设置，CPSUI 会将其IDI_CPSUI_WARNING图标覆盖到 IconID 成员标识的图标上。

OPTPF_USE_HDLGTEMPLATE

如果设置， lParam 包含模板句柄。

如果未设置， 则 lParam 包含模板资源标识符。

(仅当 Style 为 PUSHBUTTON_TYPE_DLGPROC.) 时使用

Style

按钮样式，仅用于 TVOT_PUSHBUTTON 选项类型。

pData

指向参数值的指针。此成员的使用取决于 CPSUI 选项类型。

IconID

通常标识要与选项参数关联的图标，但有时用于其他目的。此成员的使用取决于 CPSUI 选项类型。

lParam

此成员的使用取决于 CPSUI 选项类型。

dwReserved[2]

保留，必须初始化为零。

注解

如果在与某个选项关联的所有 OPTPARAM 结构中设置了OPTPF_HIDE标志，则 CPSUI 会隐藏整个选项。

要求

要求	值
Header	compstui.h (包括 Compstui.h)