Uso delle interfacce della raccolta XPS OM

Viene descritto come usare i metodi comuni delle interfacce della raccolta.

Contenuto

I metodi descritti in questa sezione sono visualizzati nell'elenco che segue. Non tutte le interfacce di raccolta supportano ognuno di questi metodi e alcune interfacce supportano anche metodi non descritti in questa pagina. Per l'elenco dei metodi supportati da un'interfaccia specifica, vedere la descrizione della descrizione dell'interfaccia.

Metodo Append
Metodo GetAt
Metodo GetCount
InsertAt, metodo
RemoveAt, metodo
SetAt, metodo

Vedere anche

Metodo Append

Aggiunge un oggetto alla fine dell'insieme.

Sintassi generica

HRESULT Append(
  [in]  Object *object
);

Descrizione

Alla fine dell'insieme, questo metodo aggiunge un oggetto passato nell'elenco dei parametri, come illustrato nel diagramma seguente.

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

Metodo GetAt

Ottiene un oggetto da una posizione specificata nell'insieme.

Sintassi generica

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

Descrizione

Scrive l'oggetto archiviato nella posizione dell'insieme specificata dall'indice nella variabile a cui fa riferimento l'oggetto. Questa azione non modifica il contenuto della raccolta. La figura seguente illustra questo processo.

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

Metodo GetCount

Ottiene il numero di oggetti archiviati nella raccolta.

Sintassi generica

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

Descrizione

Scrive il numero di oggetti attualmente archiviati nell'insieme nella variabile a cui fa riferimento il conteggio. Questa azione non modifica il contenuto della raccolta. La figura seguente illustra questo processo.

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

InsertAt, metodo

Inserisce un oggetto in una posizione specificata dell'insieme.

Sintassi generica

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

Descrizione

L'oggetto passato nell'oggetto viene inserito nella raccolta nella posizione specificata dall'indice. Prima di inserire il nuovo oggetto, questo metodo passa da 1 all'oggetto che ha precedentemente occupato la posizione in corrispondenza dell'indice e sposta tutti i puntatori di interfaccia successivi all'indice. La figura seguente illustra questo processo.

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

RemoveAt, metodo

Rimuove l'oggetto da una posizione specificata nell'insieme.

Sintassi generica

HRESULT RemoveAt(
  [in]  UINT32 index
);

Descrizione

Questo metodo rilascia l'oggetto dalla posizione specificata dall'indice, quindi compatta la raccolta riducendo di 1 l'indice di ogni puntatore successivo all'indice. La figura seguente illustra questo processo.

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

SetAt, metodo

Sostituisce l'oggetto in una posizione specificata nell'insieme.

Sintassi generica

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

Descrizione

Questo metodo rilascia prima l'oggetto nella posizione a cui fa riferimento l'indice, quindi sostituisce l'oggetto con quello passato nell'oggetto. La figura seguente illustra questo processo.

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

Vedere anche

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