IXpsOMDictionary::InsertAt-Methode (xpsobjectmodel.h)
Fügt eine IXpsOMShareable-Schnittstelle an einer angegebenen Stelle im Wörterbuch ein und legt den Schlüssel fest, um die Schnittstelle zu identifizieren.
Syntax
HRESULT InsertAt(
[in] UINT32 index,
[in] LPCWSTR key,
[in] IXpsOMShareable *entry
);
Parameter
[in] index
Der nullbasierte Index im Wörterbuch, in das die IXpsOMShareable-Schnittstelle eingefügt werden soll.
[in] key
Der Schlüssel, der zum Identifizieren der IXpsOMShareable-Schnittstelle im Wörterbuch verwendet werden soll.
Die Zeichenfolge, auf die der Schlüssel verweist, muss im Wörterbuch eindeutig sein.
[in] entry
Der IXpsOMShareable-Schnittstellenzeiger , der an der durch den Index angegebenen Position eingefügt werden soll.
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
Die im Wörterbuch gespeicherten Schnittstellenzeiger sind in der Regel Zeiger auf Schnittstellen wie IXpsOMBrush und IXpsOMVisual, die von der IXpsOMShareable-Schnittstelle abgeleitet sind. Um den Schnittstellentyp zu bestimmen, rufen Sie die IXpsOMShareable::GetType-Methode auf.
An der vom Index angegebenen Position fügt diese Methode den IXpsOMShareable-Schnittstellenzeiger ein und legt den Schlüssel fest. Der Schnittstellenzeiger und der -Schlüssel werden als Wert bzw. Schlüssel übergeben. Bevor Wert und Schlüssel eingefügt werden, werden der Schnittstellenzeiger und der Schlüssel an dieser und allen nachfolgenden Speicherorten um einen Index nach oben verschoben.
Die folgende Abbildung veranschaulicht, wie das Wörterbuch durch die InsertAt-Methode geändert 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 |