структура PROPSHEETHEADERA_V2 (prsht.h)

Определяет рамку и страницы страницы страницы свойств.

Примечание

Эта структура не предназначена для непосредственного использования в коде. Вместо этого используйте структуру PROPSHEETHEADER .

Синтаксис

typedef struct _PROPSHEETHEADERA_V2 {
  union {
    HBITMAP hbmWatermark;
    LPCSTR  pszbmWatermark;
  } DUMMYUNIONNAME4;
  HPALETTE hplWatermark;
  union {
    HBITMAP hbmHeader;
    LPCSTR  pszbmHeader;
  } DUMMYUNIONNAME5;
} PROPSHEETHEADERA_V2, *LPPROPSHEETHEADERA_V2;

Члены

DUMMYUNIONNAME4

DUMMYUNIONNAME4.hbmWatermark

Тип: HBITMAP

Версия 5.80 или более поздняя. Дескриптор к растровой диаграмме водяного знака. Если элемент dwFlags не содержит PSH_USEHBMWATERMARK, этот элемент игнорируется.

DUMMYUNIONNAME4.pszbmWatermark

Тип: LPCTSTR

Версия 5.80 или более поздняя. Ресурс растрового изображения, используемый в качестве водяного знака. Этот член может указать идентификатор ресурса растрового изображения или адрес строки, указывающей имя ресурса растрового изображения. Если элемент dwFlags содержит PSH_USEHBMWATERMARK, этот элемент игнорируется.

hplWatermark

Тип: HPALETTE

Версия 5.80 или более поздняя. Структура HPALETTE, используемая для рисования растрового изображения водяного знака и /или растрового изображения заголовка. Если элемент dwFlags не содержит PSH_USEHPLWATERMARK, этот элемент игнорируется.

DUMMYUNIONNAME5

DUMMYUNIONNAME5.hbmHeader

Тип: HBITMAP

Версия 5.80 или более поздняя. Дескриптор для растрового изображения заголовка. Если элемент dwFlags не содержит PSH_USEHBMHEADER, этот элемент игнорируется.

DUMMYUNIONNAME5.pszbmHeader

Тип: LPCSTR

Версия 5.80 или более поздняя. Ресурс растрового изображения, используемый в качестве заголовка. Этот член может указать идентификатор ресурса растрового изображения или адрес строки, указывающей имя ресурса растрового изображения. Если элемент dwFlags содержит PSH_USEHBMHEADER, этот элемент игнорируется.

Комментарии

Если пользователь выбирает параметр, например Крупные шрифты, который увеличивает диалоговое окно, подложка, нарисованная на начальной и готовой страницах, также будет увеличена. Размер и положение исходного растрового рисунка останутся прежними. Дополнительная область будет заполнена цветом пикселя в левом верхнем углу растрового изображения.

Обратите внимание, что несколько элементов этой структуры поддерживаются только для Comctl32.dll версий 4.71 и более поздних. Эти элементы можно включить, включив в заголовок один из следующих элементов.

#define _WIN32_IE 0x0400 // For version 4.71

или

#define _WIN32_IE 0x0500 // For version 5.80

Однако необходимо инициализировать структуру с ее размером. Если вы используете размер определенной структуры, приложение может не запускаться в более ранних версиях Comctl32.dll, для которых требуется меньшая структура. К ним относятся все системы с Windows 95 или Microsoft Windows NT 4.0, в которых не установлен Интернет Обозреватель 4.0 или более поздней версии. Приложение можно запускать в версиях Comctl32.dll до 4.71, определив соответствующий номер версии. Однако это может привести к проблемам, если приложение также должно работать в системах с более поздними версиями.

Вы можете оставаться совместимыми со всеми версиями Comctl32.dll, используя текущие файлы заголовков и соответствующим образом задав размер структуры PROPSHEETHEADER . Перед инициализацией структуры используйте функцию DllGetVersion , чтобы определить, какая версия Comctl32.dll установлена в системе. Если это версия 4.71 или более позднюю, используйте

psh.dwSize = sizeof(PROPSHEETHEADER);

для инициализации члена dwSize . В более ранних версиях размер структуры до версии 4.71 определяется константой PROPSHEETHEADER_V1_SIZE. Использование

psh.dwSize = PROPSHEETHEADER_V1_SIZE;

Стили PSH_WIZARD, PSH_WIZARD97 и PSH_WIZARD_LITE взаимно несовместимы. Следует задать только один из этих флагов стиля. PSH_AEROWIZARD следует сочетать с PSH_WIZARD.

Требования

Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	prsht.h