IXpsOMVisual::SetClipGeometryLookup-Methode (xpsobjectmodel.h)
Legt den Suchschlüsselnamen einer freigegebenen Clipgeometrie in einem Ressourcenwörterbuch fest.
Syntax
HRESULT SetClipGeometryLookup(
[in] LPCWSTR key
);
Parameter
[in] key
Der Nachschlageschlüsselname der Clipgeometrie im Wörterbuch. Ein NULL-Zeiger löscht den zuvor zugewiesenen Schlüsselnamen.
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 SetClipGeometryLookup aufgerufen haben, wird die lokale Clipgeometrie freigegeben, und GetClipGeometryLocal gibt einen NULL-Zeiger im clipGeometry-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 in clipGeometry von GetClipGeometry zurückgegeben wird | Objekt, das in clipGeometry von GetClipGeometryLocal zurückgegeben wird | Zeichenfolge, die im Schlüssel von GetClipGeometryLookup zurückgegeben wird |
|---|---|---|---|
| Die lokale Clipgeometrie, die von SetClipGeometryLocal festgelegt wird. | Die lokale Clipgeometrie, die von SetClipGeometryLocal festgelegt wird. | NULL-Zeiger . | |
| SetClipGeometryLookup (diese Methode) | Die freigegebene Clipgeometrie, die abgerufen wird, mit einem Suchschlüssel, der dem Schlüssel entspricht, der von SetClipGeometryLookup aus dem Ressourcenverzeichnis festgelegt wird. | NULL-Zeiger . | Die Suchtaste, die von SetClipGeometryLookup festgelegt wird. |
| Weder SetClipGeometryLookup noch SetClipGeometryLocal wurde noch aufgerufen. | NULL-Zeiger . | NULL-Zeiger . | NULL-Zeiger . |
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 |