Arbeiten mit XPS OM-Sammlungsschnittstellen
Beschreibt, wie die allgemeinen Methoden der Auflistungsschnittstellen verwendet werden.
Inhalte
Die in diesem Abschnitt beschriebenen Methoden werden in der folgenden Liste angezeigt. Nicht alle Auflistungsschnittstellen unterstützen jede dieser Methoden, und einige Schnittstellen unterstützen auch Methoden, die auf dieser Seite nicht beschrieben werden. Die Liste der Methoden, die von einer bestimmten Schnittstelle unterstützt werden, finden Sie in der Beschreibung dieser Schnittstelle.
Append-Methode
Fügt ein -Objekt an das Ende der Auflistung an.
Generische Syntax
HRESULT Append(
[in] Object *object
);
Beschreibung
Am Ende der Auflistung fügt diese Methode ein Objekt an, das in der Parameterliste übergeben wird, wie im folgenden Diagramm dargestellt.

GetAt-Methode
Ruft ein -Objekt von einer angegebenen Position in der Auflistung ab.
Generische Syntax
HRESULT GetAt(
[in] UINT32 index,
[out, retval] Object **object
);
Beschreibung
Schreibt das -Objekt, das an der durch den Index angegebenen Position der Auflistung gespeichert wird, in die Variable, auf die das Objekt verweist. Durch diese Aktion wird der Inhalt der Auflistung nicht geändert. Dieser Prozess wird anhand des folgenden Diagramms veranschaulicht.

GetCount-Methode
Ruft die Anzahl der in der Auflistung gespeicherten Objekte ab.
Generische Syntax
HRESULT GetCount(
[out, retval] UINT32 *count
);
Beschreibung
Schreibt die Anzahl der Objekte, die derzeit in der Auflistung gespeichert sind, in die Variable, auf die von count verwiesen wird. Durch diese Aktion wird der Inhalt der Auflistung nicht geändert. Dieser Prozess wird anhand des folgenden Diagramms veranschaulicht.

InsertAt-Methode
Fügt ein -Objekt an einer angegebenen Position der Auflistung ein.
Generische Syntax
HRESULT InsertAt(
[in] UINT32 index,
[in] Object *object
);
Beschreibung
Das -Objekt, das im -Objekt übergeben wird, wird an der durch den Index angegebenen Position in die Auflistung eingefügt. Vor dem Einfügen des neuen -Objekts verschiebt diese Methode um 1 das Objekt, das zuvor die Position am Index belegt hat, und verschiebt alle Schnittstellenze0er nach dem Index. Dieser Prozess wird anhand des folgenden Diagramms veranschaulicht.

RemoveAt-Methode
Entfernt das -Objekt von einer angegebenen Position in der Auflistung.
Generische Syntax
HRESULT RemoveAt(
[in] UINT32 index
);
Beschreibung
Diese Methode gibt das -Objekt von der durch den Index angegebenen Position frei und komprimiert dann die Auflistung, indem der Index jedes Zeigers nach dem Index um 1 reduziert wird. Dieser Prozess wird anhand des folgenden Diagramms veranschaulicht.

SetAt-Methode
Ersetzt das -Objekt an einer angegebenen Position in der Auflistung.
Generische Syntax
HRESULT SetAt(
[in] UINT32 index,
[in] Object *object
);
Beschreibung
Diese Methode gibt zuerst das -Objekt an der Position frei, auf die durch den Index verwiesen wird, und ersetzt dann dieses Objekt durch das Objekt, das an das -Objekt übergeben wird. Dieser Prozess wird anhand des folgenden Diagramms veranschaulicht.

Weitere Informationen
IXpsOMColorProfileResourceCollection
IXpsOMDashCollection
IXpsOMDocumentCollection
IXpsOMFontResourceCollection
IXpsOMGeometryFigureCollection
IXpsOMGradientStopCollection
IXpsOMImageResourceCollection
IXpsOMNameCollection
IXpsOMPageReferenceCollection
IXpsOMPartUriCollection
IXpsOMRemoteDictionaryResourceCollection
IXpsOMSignatureBlockResourceCollection
IXpsOMVisualCollection
IXpsSignatureBlockCollection
IXpsSignatureCollection
IXpsSignatureRequestCollection