Метод IExtendPropertySheet2::GetWatermarks (mmc.h)

Статья
08/24/2023

Метод IExtendPropertySheet2::GetWatermarks получает растровое изображение водяного знака и растровое изображение заголовка для листов мастера, реализованных как мастера в стиле Мастера 97.

Синтаксис

HRESULT GetWatermarks(
  [in]  LPDATAOBJECT lpIDataObject,
  [out] HBITMAP      *lphWatermark,
  [out] HBITMAP      *lphHeader,
  [out] HPALETTE     *lphPalette,
  [out] BOOL         *bStretch
);

Параметры

[in] lpIDataObject

Указатель на интерфейс IDataObject объекта , который содержит сведения о контексте область или результирующий элемент.

[out] lphWatermark

Указатель на дескриптор растрового изображения, который служит подложкой для страниц Мастера 97. Если дескриптор растрового изображения имеет значение NULL, подложка для мастера не отображается. Если это значение не равно NULL, оснастка для совместимости должна управлять временем существования ресурса водяного знака. Оснастка отвечает за освобождение ресурса водяного знака.

[out] lphHeader

Указатель на дескриптор растрового изображения, который служит заголовком для страниц мастера 97. Если дескриптор растрового изображения имеет значение NULL, то растровое изображение не будет отображаться в заголовке страниц мастера. Если это значение не равно NULL, оснастка для совместимости должна управлять временем существования ресурса заголовка. Оснастка отвечает за освобождение ресурса заголовка.

[out] lphPalette

Указатель на дескриптор палитры, который следует использовать для растровых изображений, заданных lphWatermark и lphHeader. По умолчанию палитра имеет значение NULL . Если палитра не возвращается, она имеет значение NULL. Если это значение не равно NULL, оснастка для совместимости должна управлять временем существования ресурса палитры. Оснастка отвечает за освобождение ресурса палитры.

[out] bStretch

Значение типа , указывающее, следует ли растягивать растровые изображения подложки и заголовка, а не мозаичными, чтобы они соответствовали фону или области заголовка страницы свойств. Значение TRUE указывает, что растровые изображения подложки и заголовка должны быть растянуты; Значение FALSE указывает, что растровые изображения водяного знака и заголовка должны поддерживать свой размер и быть мозаичными. По умолчанию этот параметр имеет значение FALSE . Если значение bStretch не возвращается, bStretch имеет значение FALSE.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Параметр type объекта IPropertySheetProvider::CreatePropertySheet имеет значение FALSE (для листа мастера), а параметру dwOptions присвоено значение MMC_PSO_NEWWIZARDTYPE (для стиля мастера 97).
Оснастка передает указатель на интерфейс IComponentData или IComponent в качестве первого параметра в вызовах метода IPropertySheetProvider::AddPrimaryPages .

Если реализация этого метода в оснастке возвращает значение сбоя (например , E_NOTIMPL), MMC возвращает лист мастера, запрошенный оснасткой, в вызове IPropertySheetProvider::CreatePropertySheet в стиле, отличном от мастера 97. Это необходимо для обеспечения совместимости с MMC 1.1.

Чтобы предотвратить искажение изображения, рекомендуется, чтобы растровые изображения водяного знака и заголовка имели следующие размеры (в пикселях), а для bStretch задано значение FALSE.

Bitmap	Измерения
lphWatermark	164 Вт x 628 ч
lphHeader	49w x 49h

Требования


Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	mmc.h

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

Добавление страниц свойств и страниц мастера

Добавление страниц мастера: сведения о реализации

IExtendPropertySheet2

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