IXpsOMDictionary::SetAt-Methode (xpsobjectmodel.h)
Ersetzt den Eintrag an einer angegebenen Position im Wörterbuch.
Syntax
HRESULT SetAt(
[in] UINT32 index,
[in] LPCWSTR key,
[in] IXpsOMShareable *entry
);
Parameter
[in] index
Der nullbasierte Index im Wörterbuch, in dem ein Eintrag ersetzt werden soll.
[in] key
Der Schlüssel, der für den neuen Eintrag verwendet werden soll.
Die Zeichenfolge, auf die der Schlüssel verweist, muss im Wörterbuch eindeutig sein.
[in] entry
Der IXpsOMShareable-Schnittstellenzeiger , der aktuelle Inhalte an der durch den Index angegebenen Position ersetzt.
Ein Wörterbuch darf keine doppelten Schnittstellenzeiger enthalten. Dieser Parameter muss einen Schnittstellenzeiger enthalten, der sich noch nicht im Wörterbuch befindet.
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. |
|
entry verweist nicht auf eine erkannte Schnittstellenimplementierung. Die benutzerdefinierte Implementierung von XPS-Dokument-API-Schnittstellen wird nicht unterstützt. |
Hinweise
An der vom Index angegebenen Position gibt diese Methode die IXpsOMShareable-Schnittstelle frei, auf die der vorhandene Zeiger verweist, ersetzt sie dann durch den Schnittstellenzeiger, der im Eintrag übergeben wird, und weist ihr den schlüssel übergebenen Schlüssel zu.
Die in einem Wörterbuch gespeicherten Schnittstellenzeiger zeigen normalerweise auf Schnittstellen wie IXpsOMBrush und IXpsOMVisual, die von der IXpsOMShareable-Schnittstelle abgeleitet sind. Um den Schnittstellentyp zu bestimmen, rufen Sie die GetType-Methode auf.
Die folgende Abbildung veranschaulicht, wie das Wörterbuch durch die SetAt-Methode geändert wird.
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 |