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 Sammlungsschnittstellen 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 am 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 einem angegebenen Speicherort in der Auflistung ab.

Generische Syntax

HRESULT GetAt(
  [in]           UINT32 index,
  [out, retval]  Object **object
);

Beschreibung

Schreibt das Objekt, das am durch index angegebenen Speicherort der Auflistung gespeichert wird, in die Variable, auf die vom Objekt verwiesen wird. Durch diese Aktion wird der Inhalt der Sammlung 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 anhand der Anzahl verwiesen wird. Durch diese Aktion wird der Inhalt der Sammlung 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 im -Objekt übergebene Objekt wird an der durch 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 Schnittstellenzeiger 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 index angegebenen Position frei und komprimiert dann die Auflistung, indem der Index jedes Zeigers, der auf den Index folgt, 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 Stelle frei, auf die vom Index verwiesen wird, und ersetzt dieses Objekt dann durch das Objekt, das im -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