IXpsOMVisualBrush::SetVisualLookup-Methode (xpsobjectmodel.h)
Legt den Suchschlüsselnamen des freigegebenen Visuals fest, das in einem Ressourcenwörterbuch gespeichert wird, um als Quelle für den Pinsel verwendet zu werden.
Syntax
HRESULT SetVisualLookup(
[in] LPCWSTR lookup
);
Parameter
[in] lookup
Der Nachschlageschlüsselname des freigegebenen Visuals, das als Quelle für den Pinsel verwendet werden soll. 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
Nachdem Sie SetVisualLookup aufgerufen haben, wird das lokale Visual freigegeben, und GetVisualLocal gibt einen NULL-Zeiger im visuellen Parameter 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 von GetVisual als Visual zurückgegeben wird | Objekt, das von GetVisualLocal als Visual zurückgegeben wird | Zeichenfolge, die bei der Suche von GetVisualLookup zurückgegeben wird |
|---|---|---|---|
| Das Visual, das von SetVisualLocal festgelegt wird. | Das Visual, das von SetVisualLocal festgelegt wird. | NULL-Zeiger . | |
| SetVisualLookup (diese Methode). | Das Visual, das aus dem Ressourcenverzeichnis abgerufen wird, mit einem Nachschlageschlüssel, der dem Schlüsselsatz von SetVisualLookup entspricht. | NULL-Zeiger . | Die Von SetVisualLookup festgelegte Nachschlagetaste. |
| Weder SetVisualLocal noch SetVisualLookup 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 |