IXpsOMPage::GetDictionary-Methode (xpsobjectmodel.h)
Ruft einen Zeiger auf die aufgelöste IXpsOMDictionary-Schnittstelle ab, die dieser Seite zugeordnet ist.
Syntax
HRESULT GetDictionary(
[out, retval] IXpsOMDictionary **resourceDictionary
);
Parameter
[out, retval] resourceDictionary
Ein Zeiger auf die aufgelöste IXpsOMDictionary-Schnittstelle , die dieser Seite zugeordnet ist.
Der in diesem Parameter zurückgegebene Wert hängt davon ab, welche Methode zuletzt aufgerufen wurde, um das Wörterbuch festzulegen.
| Neueste Methode namens | Objekt, das in resourceDictionary zurückgegeben wird |
|---|---|
| Die lokale Wörterbuchressource, die von SetDictionaryLocal festgelegt wird. | |
| Das freigegebene Wörterbuch in der Wörterbuchressource, das von SetDictionaryResource festgelegt wird. | |
| Weder SetDictionaryLocal noch SetDictionaryResource wurde 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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
resourceDictionary ist NULL. |
|
Der von SetStrokeBrushLookup festgelegte Nachschlageschlüsselname verweist auf ein Objekt, das kein Pinsel ist. |
|
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
Unabhängig davon, ob das Wörterbuch lokal ist oder in einer Remotewörterbuchressource enthalten ist, gibt diese Methode einen IXpsOMDictionary-Schnittstellenzeiger zurück. GetOwner bestimmt, ob das Wörterbuch remote ist.
Wenn eine Seite ein Remotewörterbuch enthält, deserialisiert GetDictionary das Wörterbuch. Wenn die Seite ein ungültiges Remotewörterbuch enthält, gibt GetDictionary möglicherweise einen Deserialisierungsfehlercode zurück.
Nach dem Laden und Analysieren der Ressource in das XPS-OM gibt diese Methode möglicherweise einen Fehler zurück, der für eine andere Ressource gilt. Dies tritt auf, weil alle Beziehungen analysiert werden, wenn eine Ressource geladen wird.
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 |