IXpsOMThumbnailGenerator::GenerateThumbnail-Methode (xpsobjectmodel.h)

Artikel
03/13/2024

Generiert ein Miniaturbild einer Seite.

Syntax

HRESULT GenerateThumbnail(
  [in]          IXpsOMPage          *page,
  [in]          XPS_IMAGE_TYPE      thumbnailType,
  [in]          XPS_THUMBNAIL_SIZE  thumbnailSize,
  [in]          IOpcPartUri         *imageResourcePartName,
  [out, retval] IXpsOMImageResource **imageResource
);

Parameter

[in] page

Ein Zeiger auf die IXpsOMPage-Schnittstelle , die die Seite enthält, für die das Miniaturbild erstellt wird.

[in] thumbnailType

Der XPS_IMAGE_TYPE Wert, der den Typ des zu erstellenden Miniaturbilds angibt.

[in] thumbnailSize

Der XPS_THUMBNAIL_SIZE Wert, der die Bildgröße der zu erstellenden Miniaturansicht angibt.

[in] imageResourcePartName

Ein Zeiger auf die IOpcPartUri-Schnittstelle , die den Namen des neuen Miniaturbildteils enthält.

[out, retval] imageResource

Ein Zeiger auf die neue IXpsOMImageResource-Schnittstelle , die das von dieser Methode erstellte Miniaturbild enthält.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem die Werte in der folgenden Tabelle. Informationen zu XPS-Dokument-API-Rückgabewerten, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	page, imageResourcePartName oder imageResource ist NULL.
E_INVALIDARG	Einer der folgenden Parameter enthält einen ungültigen Wert: thumbnailType: Der Bildtyp muss PNG (XPS_IMAGE_TYPE_PNG) oder JPEG (XPS_IMAGE_TYPE_JPEG) sein. thumbnailSize: thumbnailSize muss ein Mitglied von XPS_THUMBNAIL_SIZE

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	xpsobjectmodel.h