Condividi tramite

Uso delle interfacce della raccolta XPS OM

  • Articolo

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.

figura che mostra come aggiungere una voce alla raccolta

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.

figura che mostra come getat recupera una voce dalla raccolta

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.

figura che mostra come getcount ottiene il numero di voci nella raccolta

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.

figura che mostra come insertat aggiunge una voce alla raccolta

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.

figura che mostra come rimuovere una voce dalla raccolta

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.

figura che mostra come setat sostituisce una voce nella raccolta

Vedere anche

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