Freigeben über


IXpsOMGradientBrush::GetTransform-Methode (xpsobjectmodel.h)

Ruft einen Zeiger auf die IXpsOMMatrixTransform-Schnittstelle ab, die die aufgelöste Matrixtransformation für den Pinsel enthält.

Syntax

HRESULT GetTransform(
  [out, retval] IXpsOMMatrixTransform **transform
);

Parameter

[out, retval] transform

Ein Zeiger auf die IXpsOMMatrixTransform-Schnittstelle , die die aufgelöste Matrixtransformation für den Pinsel enthält. Wenn die Transformation nicht festgelegt wurde, wird ein NULL-Zeiger zurückgegeben.

Der in diesem Parameter zurückgegebene Wert hängt davon ab, welche Methode zuletzt aufgerufen wurde, um die Transformation festzulegen.

Neueste Methode namens Objekt, das in der Transformation zurückgegeben wird

SetTransformLocal

Die lokale Transformation, die von SetTransformLocal festgelegt wird.

SetTransformLookup

Die freigegebene Transformation, die aus dem Ressourcenverzeichnis abgerufen wird, mit einem Suchschlüssel, der dem Schlüsselsatz von SetTransformLookup entspricht.
Weder SetTransformLocal noch SetTransformLookup wurden noch aufgerufen. NULL-Zeiger .

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
transformation ist NULL.
XPS_E_LOOKUP_INVALID_TYPE
Der von SetStrokeBrushLookup festgelegte Nachschlageschlüsselname verweist auf ein Objekt, das kein Pinsel ist.
XPS_E_LOOKUP_NOT_FOUND
Es konnte kein Objekt mit einem Schlüsselnamen gefunden werden, der dem Nachschlagewert entsprach.

Es konnte kein Objekt mit einem Schlüsselnamen gefunden werden, der mit dem bei der Suche übergebenen Wert übereinstimmte.

Hinweise

Die Transformation bestimmt, wie der Farbverlauf transformiert wird. Der sichtbare Teil des Farbverlaufs, der letztendlich im Bild gerendert wird, wird durch den Pfad, den Strich oder die Glyphe bestimmt, die den Farbverlaufspinsel verwendet.

Anforderungen

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

Weitere Informationen

IXpsOMGradientBrush

IXpsOMMatrixTransform

XML Paper Specification

XPS-Dokumentfehler