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

Статья
02/06/2025

Массив структур 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 содержит идентификатор ресурса шаблона.

(Используется, только если стиль PUSHBUTTON_TYPE_DLGPROC.)

Style

Стиль кнопки push, используемый только для типа параметра TVOT_PUSHBUTTON.

pData

Указатель на значение параметра. Использование этого элемента зависит от типа параметра CPSUI.

IconID

Обычно идентифицирует значок, связанный с параметром параметра, но иногда используется для других целей. Использование этого элемента зависит от типа параметра CPSUI.

lParam

Использование этого элемента зависит от типа параметра CPSUI.

dwReserved[2]

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

Замечания

Если флаг OPTPF_HIDE установлен во всех структурах OPTPARAM, связанных с параметром, CPSUI скрывает весь параметр.

Требования

Требование	Ценность
заголовка	compstui.h (include Compstui.h)

Поделиться через