Partage via


GeometryCollection.GetMany(UInt32, Geometry[]) Méthode

Définition

Récupère plusieurs éléments en une seule passe à travers l’itérateur.

public:
 virtual unsigned int GetMany(unsigned int startIndex, Platform::Array <Geometry ^> ^ items) = IVector<Geometry ^>::GetMany;
uint32_t GetMany(uint32_t const& startIndex, winrt::array_view <Geometry const&> & items);
public uint GetMany(uint startIndex, Geometry[] items);
function getMany(startIndex, items)
Public Function GetMany (startIndex As UInteger, items As Geometry()) As UInteger

Paramètres

startIndex
UInt32

unsigned int

uint32_t

Index à partir duquel commencer la récupération.

items
Geometry[]

Fournit la destination du résultat. Dimensionner la taille initiale du tableau en tant que « capacité » afin de spécifier le nombre de résultats à récupérer.

Retours

UInt32

unsigned int

uint32_t

Le nombre d'éléments à récupérer.

Implémente

M:Windows.Foundation.Collections.IVector1.GetMany(System.UInt32,0[]) M:Windows.Foundation.Collections.IVector1.GetMany(unsigned int,0[]) M:Windows.Foundation.Collections.IVector1.GetMany(uint32_t,0[])

Remarques

La méthode GetMany fonctionne de la même façon que si vous appelez et pour chaque élément du tableau fourni. Cela signifie que le premier élément retourné par la méthode GetMany est le même élément que celui retourné en récupérant la propriété avant d’appeler GetMany. Une fois l’appel GetMany retourné, la propriété récupère l’élément suivant le dernier élément retourné par l’appel GetMany, ou génère une erreur si plus aucun élément n’existe dans les séquences.

La méthode GetMany retourne le nombre réel d’éléments retournés. Il doit s’agir du minimum de a) du nombre d’éléments restants dans la collection, ou b) du nombre d’éléments demandés, c’est-à-dire de la « capacité ». Par conséquent, chaque fois que GetMany retourne moins que le nombre d’éléments demandés, la fin de la séquence a été atteinte. Elle retourne le nombre d’éléments récupérés dans le paramètre de sortie « réel ». Lorsque l’appelant spécifie une capacité de 0, la position de l’itérateur est inchangée. Les éléments du tableau qui suivent les valeurs retournées sont inchangés.

S’applique à