EXTCHKBOX 结构 (compstui.h)

项目
02/26/2024

CPSUI 应用程序使用 EXTCHKBOX 结构， (包括打印机接口 DLL) ，用于指定扩展检查框，该框可添加到属性表页选项中。

语法

typedef struct _EXTCHKBOX {
  WORD      cbSize;
  WORD      Flags;
  LPTSTR    pTitle;
  LPTSTR    pSeparator;
  LPTSTR    pCheckedName;
  ULONG_PTR IconID;
  WORD      wReserved[4];
  ULONG_PTR dwReserved[2];
} EXTCHKBOX, *PEXTCHKBOX;

成员

cbSize

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

Flags

位标志，可以是下列值之一：

ECBF_CHECKNAME_AT_FRONT

如果已设置，CPSUI 将按“pCheckedName pSeparator SelectName”的顺序显示字符串，其中 SelectName 是与选项的选定值关联的字符串。

如果未设置，CPSUI 将按“SelectName pSeparator pCheckedName”的顺序显示字符串。

ECBF_CHECKNAME_ONLY_ENABLED

如果已设置，则 CPSUI 仅在选中并启用选项时显示 pCheckedName 字符串， (即设置OPTIF_ECB_CHECKED，并且 OPTITEM 结构) 中清除OPTIF_DISABLED。

如果未设置，CPSUI 始终显示 pCheckedName 字符串，如果选中选项 (即，在 OPTITEM 结构) 中设置OPTIF_ECB_CHECKED，即使选项被禁用也是如此。

ECBF_ICONID_AS_HICON

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

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

ECBF_OVERLAY_ECBICON_IF_CHECKED

如果已设置，并且选中检查框 (即在 OPTITEM 结构) 中设置OPTIF_ECB_CHECKED，CPSUI 会将 IconID 成员标识的图标覆盖到与选项项关联的图标上。

ECBF_OVERLAY_NO_ICON

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

ECBF_OVERLAY_STOP_ICON

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

ECBF_OVERLAY_WARNING_ICON

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

pTitle

字符串标识符，表示检查框标题。这可以是指向以 NULL 结尾的字符串的 32 位指针，也可以是 HIWORD 设置为零的 16 位字符串资源标识符。

pSeparator

字符串标识符，表示在选中的名称字符串和所选选项字符串之间显示的分隔符。它可以是指向以 NULL 结尾的字符串的 32 位指针，也可以是 HIWORD 设置为零的 16 位字符串资源标识符。

pCheckedName

字符串标识符，表示选中“检查”框时要显示的文本。这可以是指向以 NULL 结尾的字符串的 32 位指针，也可以是 HIWORD 设置为零的 16 位字符串资源标识符。

IconID

以下图标标识符之一：

图标资源标识符。这可以是应用程序定义的，也可以是 CPSUI 提供的IDI_CPSUI前缀图标资源标识符之一。
图标句柄。如果指定了句柄，则必须在 Flags 成员中设置ECBF_ICONID_AS_HICON。

如果此值为零，则不显示图标。

wReserved[4]

保留，必须初始化为零。

dwReserved[2]