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
GetAt-Methode
GetCount-Methode
InsertAt-Methode
RemoveAt-Methode
SetAt-Methode

Weitere Informationen

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.

Abbildung, die zeigt, wie append der Auflistung einen Eintrag hinzufügt

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.

Abbildung, die zeigt, wie getat einen Eintrag aus der Sammlung abruft

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.

Abbildung, die zeigt, wie getcount die Anzahl von Einträgen in der Sammlung erhält

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.

Abbildung, die zeigt, wie insertat der Auflistung einen Eintrag hinzufügt

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.

Abbildung, die zeigt, wie removeat einen Eintrag aus der Sammlung entfernt

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.

Abbildung, die zeigt, wie setat einen Eintrag in der Auflistung ersetzt

Weitere Informationen

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