Partager via

Utilisation des interfaces de collection DE MODÈLE XPS

Décrit comment utiliser les méthodes courantes des interfaces de collection.

Contenu

Les méthodes décrites dans cette section sont indiquées dans la liste qui suit. Toutes les interfaces de collection ne prennent pas en charge chacune de ces méthodes, et certaines interfaces prennent également en charge les méthodes qui ne sont pas décrites dans cette page. Pour obtenir la liste des méthodes prises en charge par une interface spécifique, reportez-vous à la description de cette interface.

Méthode Append
GetAt, méthode
GetCount, méthode
InsertAt, méthode
RemoveAt, méthode
SetAt, méthode

Voir aussi

Méthode Append

Ajoute un objet à la fin de la collection.

Syntaxe générique

HRESULT Append(
  [in]  Object *object
);

Description

À la fin de la collection, cette méthode ajoute un objet qui est passé dans la liste des paramètres, comme illustré dans le diagramme suivant.

figure qui montre comment l’ajout ajoute une entrée à la collection

GetAt, méthode

Obtient un objet à partir d’un emplacement spécifié dans la collection.

Syntaxe générique

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

Description

Écrit l’objet stocké à l’emplacement de la collection spécifié par l’index dans la variable référencée par l’objet. Cette action ne modifie pas le contenu de la collection. Le diagramme suivant illustre ce processus.

figure qui montre comment getat récupère une entrée de la collection

GetCount, méthode

Obtient le nombre d’objets stockés dans la collection.

Syntaxe générique

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

Description

Écrit le nombre d’objets actuellement stockés dans la collection dans la variable référencée par nombre. Cette action ne modifie pas le contenu de la collection. Le diagramme suivant illustre ce processus.

figure qui montre comment getcount obtient le nombre d’entrées dans la collection

InsertAt, méthode

Insère un objet à un emplacement spécifié de la collection.

Syntaxe générique

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

Description

L’objet passé dans l’objet est inséré dans la collection à l’emplacement spécifié par index. Avant d’insérer le nouvel objet, cette méthode déplace de 1 l’objet qui a précédemment occupé l’emplacement au niveau de l’index et déplace tous les pointeurs d’interface après l’index. Le diagramme suivant illustre ce processus.

figure qui montre comment insertat ajoute une entrée à la collection

RemoveAt, méthode

Supprime l’objet d’un emplacement spécifié dans la collection.

Syntaxe générique

HRESULT RemoveAt(
  [in]  UINT32 index
);

Description

Cette méthode libère l’objet de l’emplacement spécifié par index, puis compacte la collection en réduisant de 1 l’index de chaque pointeur suivant l’index. Le diagramme suivant illustre ce processus.

figure qui montre comment removeat supprime une entrée de la collection

SetAt, méthode

Remplace l’objet à un emplacement spécifié dans la collection.

Syntaxe générique

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

Description

Cette méthode libère d’abord l’objet à l’emplacement référencé par l’index, puis remplace cet objet par celui qui est passé dans l’objet. Le diagramme suivant illustre ce processus.

figure qui montre comment setat remplace une entrée dans la collection

Voir aussi

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

 

 

  • Last updated on