структура PROPSHEETUI_INFO_HEADER (compstui.h)

  • Статья

Структура PROPSHEETUI_INFO_HEADER используется в качестве входного параметра для типизированной функции PFNPROPSHEETUI приложения, когда функция вызывается со значением причины PROPSHEETUI_REASON_GET_INFO_HEADER.

Синтаксис

typedef struct _PROPSHEETUI_INFO_HEADER {
  WORD      cbSize;
  WORD      Flags;
  LPTSTR    pTitle;
  HWND      hWndParent;
  HINSTANCE hInst;
  union {
    HICON     hIcon;
    ULONG_PTR IconID;
  } DUMMYUNIONNAME;
} PROPSHEETUI_INFO_HEADER, *PPROPSHEETUI_INFO_HEADER;

Члены

cbSize

Размер структуры PROPSHEETUI_INFO_HEADER в байтах, предоставленный CPSUI.

Flags

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

Flag Описание
PSUIHDRF_DEFTITLE Если параметр задан, CPSUI должен включать значение Default в строке заголовка строки. CPSUI добавляет "Default" после строки pTitle и, если PSUIHDRF_PROPTITLE задано, перед "Свойства".
PSUIHDRF_EXACT_PTITLE Если параметр задан, CPSUI использует текст, заданный параметром pTitle , без изменений. Этот флаг переопределяет PSUIHDRF_DEFTITLE и PSUIHDRF_PROPTITLE.
PSUIHDRF_NOAPPLYNOW Если параметр задан, CPSUI не должен включать кнопку Применить сейчас .
PSUIHDRF_PROPTITLE Если параметр задан, CPSUI должен добавить "Свойства" в строку строки заголовка. (По умолчанию CPSUI устанавливает этот флаг перед вызовом приложения.)
PSUIHDRF_USEHICON Если этот параметр задан, объединение hIcon/IconID содержит дескриптор значка. Если значение не задано, объединение содержит идентификатор ресурса значка.

pTitle

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

hWndParent

Дескриптор окна, используемого в качестве родительского элемента страницы свойств. По умолчанию CPSUI передает дескриптор окна, полученный для параметра hWndOwner, в CommonPropertySheetUI, но приложение может перезаписать этот дескриптор другим.

hInst

Предоставленный приложением дескриптор экземпляра, который CPSUI использует при загрузке ресурсов приложения.

DUMMYUNIONNAME

Это объединение определяет значок, отображаемый в строке заголовка страницы свойств.

DUMMYUNIONNAME.hIcon

Определяет элемент HICONhIcon.

DUMMYUNIONNAME.IconID

Определяет iconID элемента ULONG_PTR. Член профсоюза выбирается PSUIHDRF_USEICON в разделе Флаги.

Требования

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