Práce s rozhraními kolekce XPS OM

Popisuje, jak používat běžné metody rozhraní kolekce.

Obsah

Metody popsané v této části jsou uvedeny v následujícím seznamu. Ne všechna rozhraní kolekce podporují každou z těchto metod a některá rozhraní také podporují metody, které nejsou popsány na této stránce. Seznam metod podporovaných konkrétním rozhraním najdete v popisu tohoto rozhraní.

Metoda Append
Metoda GetAt
GetCount – metoda
InsertAt – metoda
RemoveAt – metoda
SetAt – metoda

Viz také

Append – metoda

Připojí objekt na konec kolekce.

Obecná syntaxe

HRESULT Append(
  [in]  Object *object
);

popis

Na konec kolekce tato metoda připojí objekt předaný v seznamu parametrů, jak je znázorněno v následujícím diagramu.

kolekce

GetAt – metoda

Získá objekt ze zadaného umístění v kolekci.

Obecná syntaxe

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

popis

Zapíše objekt uložený v umístění kolekce určené indexem proměnné odkazované objektu. Tato akce nezmění obsah kolekce. Tento proces znázorňuje následující diagram.

GetCount – metoda

Získá počet objektů uložených v kolekci.

Obecná syntaxe

HRESULT GetCount(
  [out, retval]  UINT32 *count
);

popis

Zapíše počet objektů, které jsou aktuálně uloženy v kolekci do proměnné odkazované počet. Tato akce nezmění obsah kolekce. Tento proces znázorňuje následující diagram.

Metoda InsertAt

Vloží objekt do zadaného umístění kolekce.

Generická syntaxe

HRESULT InsertAt(
  [in]  UINT32 index,
  [in]  Object *object
);

popis

Objekt předaný jako objekt je vložen do kolekce v místě určeném indexem . Před vložením nového objektu objektutato metoda posune o 1 pozici objekt, který dříve zabíral místo na indexu , a přesune všechny ukazatele rozhraní, které jsou následné k indexu . Tento proces znázorňuje následující diagram.

RemoveAt – metoda

Odebere objekt ze zadaného umístění v kolekci.

Obecná Syntaxe

HRESULT RemoveAt(
  [in]  UINT32 index
);

popis

Tato metoda uvolní objekt z umístění určeného index, poté zkomprimuje kolekci snížením indexu každého ukazatele následujícího po indexo 1. Tento proces znázorňuje následující diagram.

SetAt – metoda

Nahradí objekt v zadaném umístění v kolekci.

Obecná syntaxe

HRESULT SetAt(
  [in]  UINT32 index,
  [in]  Object *object
);

popis

Tato metoda nejprve uvolní objekt v umístění, na které odkazuje index, pak nahradí tento objekt objektem předaným v objektu. Tento proces znázorňuje následující diagram.

Viz také

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