IXpsOMTileBrush::SetTransformLookup-Methode (xpsobjectmodel.h)
Legt den Nachschlageschlüsselnamen einer freigegebenen Matrixtransformation fest, die als Transformation für diesen Pinsel verwendet wird. Die transformation der freigegebenen Matrix, auf die der Nachschlageschlüssel verweist, wird im Ressourcenverzeichnis gespeichert.
Syntax
HRESULT SetTransformLookup(
[in] LPCWSTR key
);
Parameter
[in] key
Eine Zeichenfolgenvariable, die den Nachschlageschlüsselnamen einer gemeinsam genutzten Matrixtransformation im Ressourcenverzeichnis enthält. Wenn bereits ein Nachschlageschlüssel festgelegt wurde, löscht ein NULL-Zeiger sie.
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Gemäß der XML-Papierspezifikation ist der Wert von Lookup keine gültige Suchschlüsselzeichenfolge. |
|
Der Suchschlü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
Die Transformation wird angewendet, bevor das Pinselbild im Pfad, Strich oder Glyphe gerendert wird, der den Kachelpinsel verwendet. Der Kachelpinsel verfügt nur über eine Transformation, die lokal oder remote sein kann.
Nachdem Sie SetTransformLookup aufgerufen haben, wird die lokale Transformation freigegeben, und GetTransformLocal gibt einen NULL-Zeiger im Transformationsparameter zurück. In der folgenden Tabelle wird die Beziehung zwischen den lokalen Werten und den Nachschlagewerten dieser Eigenschaft erläutert.
| Neueste Methode namens | Objekt, das in der Transformation von GetTransform zurückgegeben wird | Objekt, das in der Transformation von GetTransformLocal zurückgegeben wird | Zeichenfolge, die im Schlüssel von GetTransformLookup zurückgegeben wird |
|---|---|---|---|
| Die Transformation, die von SetTransformLocal festgelegt wird. | Die Transformation, die von SetTransformLocal festgelegt wird. | NULL-Zeiger . | |
| SetTransformLookup (diese Methode) | Die Transformation, die mithilfe eines Suchschlüssels, der dem von SetTransformLookup festgelegten Schlüssel entspricht, aus dem Ressourcenverzeichnis abgerufen wird. | NULL-Zeiger . | Der Suchschlüssel, der von SetTransformLookup festgelegt wird. |
| Weder SetTransformLocal noch SetTransformLookup wurden noch aufgerufen. | NULL-Zeiger . | NULL-Zeiger . | NULL-Zeiger . |
Anforderungen
| 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 |