Partager via


PointCollection.GetMany(UInt32, Point[]) Méthode

Définition

Récupère plusieurs éléments en un seul passage par l’itérateur.

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

Paramètres

startIndex
UInt32

unsigned int

uint32_t

Index à partir duquel démarrer la récupération.

items
Point[]

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 manière 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 aucun élément supplémentaire n’existe dans les séquences.

La méthode GetMany retourne le nombre réel d’éléments retournés. Il doit s’agir de la valeur minimale a) du nombre d’éléments restant dans la collection, ou b) du nombre d’éléments demandés, c’est-à-dire de « 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. Il 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 à