IExtendPropertySheet2::GetWatermarks-Methode (mmc.h)

Artikel
08/24/2023

Die IExtendPropertySheet2::GetWatermarks-Methode ruft die Wasserzeichenbit und header-Bitmap für Assistentenblätter ab, die als Assistenten im 97-Stil implementiert sind.

Syntax

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

Parameter

[in] lpIDataObject

Ein Zeiger auf die IDataObject-Schnittstelle für das Objekt, das Kontextinformationen zum Bereich oder Ergebniselement enthält.

[out] lphWatermark

Ein Zeiger auf das Handle auf eine Bitmap, die als Wasserzeichen für 97 Seiten des Assistenten dient. Wenn das Handle für die Bitmap NULL ist, wird für den Assistenten kein Wasserzeichen angezeigt. Wenn dieser Wert nicht NULL ist, sollte das Snap-In aus Kompatibilitätsgründen die Lebensdauer der Wasserzeichenressource verwalten. Das Snap-In ist für die Freigabe der Wasserzeichenressource verantwortlich.

[out] lphHeader

Ein Zeiger auf das Handle auf eine Bitmap, die als Kopfzeile für Wizard 97-Seiten dient. Wenn das Handle für die Bitmap NULL ist, wird in der Kopfzeile für Assistentenseiten keine Bitmap angezeigt. Wenn dieser Wert nicht NULL ist, sollte das Snap-In aus Gründen der Kompatibilität die Lebensdauer der Headerressource verwalten. Das Snap-In ist für das Freigeben der Headerressource verantwortlich.

[out] lphPalette

Ein Zeiger auf das Handle auf eine Palette, die für die durch lphWatermark und lphHeader angegebenen Bitmaps verwendet werden soll. Die Palette ist standardmäßig NULL . Wenn keine Palette zurückgegeben wird, ist die Palette NULL. Wenn dieser Wert nicht NULL ist, sollte das Snap-In aus Gründen der Kompatibilität die Lebensdauer der Palettenressource verwalten. Das Snap-In ist für das Freigeben der Palettenressource verantwortlich.

[out] bStretch

Ein -Wert, der angibt, ob die Wasserzeichen- und Kopfzeilenbitbits gestreckt werden sollen – statt gekachelt – so, dass sie dem Hintergrund- oder Kopfzeilenbereich des Eigenschaftenblatts entsprechen. TRUE gibt an, dass die Wasserzeichen- und Headerbits gestreckt werden sollen. FALSE gibt an, dass die Wasserzeichen- und Headerbitbits ihre Größe beibehalten und kacheln sollen. Dieser Parameter ist standardmäßig FALSE . Wenn kein bStretch-Wert zurückgegeben wird, ist bStretchFALSE.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

MMC ruft diese Methode nur in folgenden Fällen auf:

Der type-Parameter von IPropertySheetProvider::CreatePropertySheet ist auf FALSE (für Assistentenblatt) festgelegt, und der dwOptions-Parameter ist auf MMC_PSO_NEWWIZARDTYPE festgelegt (im Format des Assistenten 97).
Das Snap-In übergibt einen Zeiger auf seine IComponentData - oder IComponent-Schnittstelle als ersten Parameter in Aufrufen der IPropertySheetProvider::AddPrimaryPages-Methode .

Wenn die Implementierung dieser Methode durch das Snap-In einen Fehlerwert zurückgibt (z . B. E_NOTIMPL), setzt MMC das vom Snap-In angeforderte Assistentenblatt im Aufruf von IPropertySheetProvider::CreatePropertySheet in die Formatvorlage 97 zurück. Dadurch soll die Kompatibilität mit MMC 1.1 beibehalten werden.

Um Verzerrungen des Bilds zu verhindern, wird empfohlen, dass die Wasserzeichen- und Kopfzeilenbitbits die folgenden Dimensionen (in Pixel) aufweisen, wobei bStretch auf FALSE festgelegt ist.

Bitmap	Dimensionen
lphWatermark	164W x 628h
lphHeader	49w x 49h

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	mmc.h

Weitere Informationen

Hinzufügen von Eigenschaftenseiten und Assistentenseiten

Hinzufügen von Assistentenseiten: Implementierungsdetails

IExtendPropertySheet2

Freigeben über