Структура OPTTYPE (compstui.h)

Статья
03/08/2023

Структура OPTTYPE используется приложениями CPSUI (включая библиотеки DLL интерфейса принтера) для описания типа и других характеристик параметра страницы свойств, если параметр задан структурой OPTITEM .

Синтаксис

typedef struct _OPTTYPE {
  WORD      cbSize;
  BYTE      Type;
  BYTE      Flags;
  WORD      Count;
  WORD      BegCtrlID;
  POPTPARAM pOptParam;
  WORD      Style;
  WORD      wReserved[3];
  ULONG_PTR dwReserved[3];
} OPTTYPE, *POPTTYPE;

Члены

cbSize

Размер структуры OPTTYPE в байтах.

Type

Указывает тип параметра CPSUI.

Flags

Необязательные битовые флаги, которые изменяют характеристики параметра. Следующие флаги можно задать в любом сочетании.

OPTTF_NOSPACE_BEFORE_POSTFIX

ПРИ отображении параметра CPSUI не следует добавлять пробел между строкой, указанной строкой pName структуры OPTITEM, и строкой pData структуры OPTPARAM.

Допустимо, только если тип параметра — или TVOT_SCROLLBAR или TVOT_TRACKBAR.

OPTTF_TYPE_DISABLED

Все структуры OPTPARAM , к которым относятся точки pOptParam , отключены, поэтому ни одно из значений параметров не может быть выбрано пользователем.

Count

Указывает количество структур OPTPARAM , на которые указывает pOptParam . Значение этого элемента зависит от типа параметра CPSUI.

BegCtrlID

Если pDlgPage в COMPROPSHEETUI определяет страницу, предоставленную CPSUI, или если DlgTemplateID в DLGPAGE определяет шаблон, предоставленный CPSUI, BegCtrlID не используется.

В противном случае BegCtrlID должен содержать первый из последовательно пронумерованного набора идентификаторов элементов управления Windows. Использование идентификатора элемента управления зависит от типа параметра CPSUI.

pOptParam

Указатель на массив структур OPTPARAM , описывающий значения параметров, которые пользователь может выбрать для параметра.

Style

Задает флаги, которые можно использовать для изменения характеристик отображения параметра. Флаги, которые можно указать, зависят от типа параметра CPSUI.

wReserved[3]

Зарезервировано, должно быть инициализировано до нуля.

dwReserved[3]