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

Статья
02/22/2024

Структура 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 необходимо задать в элементе Flags .

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

wReserved[4]

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

dwReserved[2]

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

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

Требования

Требование	Значение
Заголовок	compstui.h (включая Compstui.h)

См. также раздел

EXTPUSH