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

Статья
02/06/2025

Структура EXTCHKBOX используется приложениями CPSUI (включая библиотеки 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 задан и OPTIF_DISABLED ясно в структуре OPTITEM).

Если параметр не задан, CPSUI всегда отображает строку pCheckedName, если установлен параметр (то есть OPTIF_ECB_CHECKED установлен в структуре OPTITEM), даже если этот параметр отключен.

ECBF_ICONID_AS_HICON

Если задано, элемент iconID содержит дескриптор значка.

Если параметр не задан, элемент IconID содержит идентификатор ресурса значка.

ECBF_OVERLAY_ECBICON_IF_CHECKED

Если установлен флажок (то есть установлен OPTIF_ECB_CHECKED в структуре OPTITEM), 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

Строковый идентификатор, представляющий заголовок флажка. Это может быть 32-разрядный указатель на строку, завершаемую значением NULL, или это может быть 16-разрядный идентификатор ресурса строки с значением HIWORD, равным нулю.

pSeparator

Строковый идентификатор, представляющий символ разделителя, отображаемый между строкой проверяемого имени и выбранной строкой параметра, это может быть 32-разрядный указатель на строку, завершающую значение NULL, или может быть 16-разрядным идентификатором строкового ресурса с значением HIWORD, равным нулю.

pCheckedName

Строковый идентификатор, представляющий текст, отображаемый при флажке. Это может быть 32-разрядный указатель на строку, завершаемую значением NULL, или это может быть 16-разрядный идентификатор ресурса строки с значением HIWORD, равным нулю.

IconID

Один из следующих идентификаторов значков:

Идентификатор ресурса значка. Это может быть определено приложением или может быть одним из предоставленных cpSUI идентификаторов ресурсов IDI_CPSUI-префиксированных значков.
Дескриптор значка. Если указан дескриптор, ECBF_ICONID_AS_HICON необходимо задать в элементе флагов.

Если это значение равно нулю, значок не отображается.

wReserved[4]

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

dwReserved[2]

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

Замечания

Расширенный флажок — это определенный тип флажка CPSUI, который может быть связан со структурой OPTITEM. Структура OPTITEM может иметь один расширенный флажок или одну расширенную кнопку нажатия.

Требования

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

См. также

EXTPUSH

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