IXpsOMGradientBrush::SetTransformLookup-Methode (xpsobjectmodel.h)
Legt den Namen des Nachschlageschlüssels einer freigegebenen Matrixtransformation fest, die für den Pinsel verwendet werden soll.
Der Schlüsselname identifiziert eine freigegebene Ressource in einem Ressourcenverzeichnis.
Syntax
HRESULT SetTransformLookup(
[in] LPCWSTR key
);
Parameter
[in] key
Der Name des Nachschlageschlüssels der Matrixtransformation, die für den Pinsel verwendet werden soll.
Rückgabewert
Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem diejenigen in der folgenden Tabelle. Informationen zu Rückgabewerten der XPS-Dokument-API, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Gemäß der XML-Papierspezifikation ist der Wert von Lookup keine gültige Nachschlageschlüsselzeichenfolge. |
|
Der Nachschlageschlüsselname im Schlüssel verweist auf ein Objekt, das keine Geometrie ist. |
|
Es konnte kein Objekt mit einem Schlüsselnamen gefunden werden, der mit dem im Schlüssel übergebenen Wert übereinstimmte. |
Hinweise
Nachdem Sie SetTransformLookup aufgerufen haben, wird die lokale Transformation freigegeben, und GetTransformLocal gibt einen NULL-Zeiger im transformation-Parameter zurück. In der folgenden Tabelle wird die Beziehung zwischen den lokalen werten und den Nachschlagewerten dieser Eigenschaft erläutert.
| Die neueste Methode wurde aufgerufen. | Objekt, das in der Transformation von GetTransform zurückgegeben wird | Objekt, das in der Transformation von GetTransformLocal zurückgegeben wird | Objekt, das im Schlüssel von GetTransformLookup zurückgegeben wird |
|---|---|---|---|
| Die lokale Transformation, die von SetTransformLocal festgelegt wird. | Die lokale Transformation, die von SetTransformLocal festgelegt wird. | NULL-Zeiger . | |
| SetTransformLookup (diese Methode) | Die abgerufene freigegebene Transformation mit einem Nachschlageschlüssel, der mit dem schlüssel übereinstimmt, der von SetTransformLookup festgelegt ist, aus dem Ressourcenverzeichnis. | NULL-Zeiger . | Der Von SetTransformLookup festgelegte Nachschlageschlüssel. |
| Weder SetTransformLocal noch SetTransformLookup wurde noch aufgerufen. | NULL-Zeiger . | NULL-Zeiger . | NULL-Zeiger . |
Die Transformation, auf die der Schlüssel verweist, 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 Pinsel 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 |