Trabajar con interfaces de colección DE OM XPS

Describe cómo usar los métodos comunes de las interfaces de colección.

Contenido

Los métodos descritos en esta sección se muestran en la lista siguiente. No todas las interfaces de colección admiten cada uno de estos métodos, y algunas interfaces también admiten métodos que no se describen en esta página. Para obtener la lista de métodos admitidos por una interfaz específica, consulte la descripción de esa interfaz.

Append (método)
GetAt (método)
GetCount (Método)
InsertAt (método)
RemoveAt (método)
SetAt (método)

Consulte también

Append (método)

Anexa un objeto al final de la colección.

Sintaxis genérica

HRESULT Append(
  [in]  Object *object
);

Descripción

Al final de la colección, este método anexa un objeto que se pasa en la lista de parámetros, como se muestra en el diagrama siguiente.

a figure that shows how append adds an entry to the collection

GetAt (método)

Obtiene un objeto de una ubicación especificada en la colección.

Sintaxis genérica

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

Descripción

Escribe el objeto almacenado en la ubicación de la colección especificada por índice en la variable a la que hace referencia el objeto . Esta acción no cambia el contenido de la colección. En el siguiente diagrama se muestra este proceso.

a figure that shows how getat retrieves an entry from the collection

GetCount (Método)

Obtiene el número de objetos almacenados en la colección.

Sintaxis genérica

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

Descripción

Escribe el número de objetos almacenados actualmente en la colección en la variable a la que hace referencia count. Esta acción no cambia el contenido de la colección. En el siguiente diagrama se muestra este proceso.

a figure that shows how getcount gets the number of entries in the collection

InsertAt (método)

Inserta un objeto en una ubicación especificada de la colección.

Sintaxis genérica

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

Descripción

El objeto que se pasa en el objeto se inserta en la colección en la ubicación especificada por el índice. Antes de insertar el nuevo objeto, este método mueve por 1 el objeto que previamente ha ocupado la ubicación en el índice y mueve todos los punteros de interfaz posteriores al índice. En el siguiente diagrama se muestra este proceso.

a figure that shows how insertat adds an entry to the collection

RemoveAt (método)

Quita el objeto de una ubicación especificada en la colección.

Sintaxis genérica

HRESULT RemoveAt(
  [in]  UINT32 index
);

Descripción

Este método libera el objeto de la ubicación especificada por el índice y, a continuación, compacta la colección reduciendo en 1 el índice de cada puntero posterior al índice. En el siguiente diagrama se muestra este proceso.

a figure that shows how removeat removes an entry from the collection

SetAt (método)

Reemplaza el objeto en una ubicación especificada de la colección.

Sintaxis genérica

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

Descripción

Este método libera primero el objeto en la ubicación a la que hace referencia el índice y, a continuación, reemplaza ese objeto por el que se pasa en el objeto . En el siguiente diagrama se muestra este proceso.

a figure that shows how setat replaces an entry in the collection

Consulte también

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