PointCollection.GetMany(UInt32, Point[]) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 UIntegerParamè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
Le nombre d'éléments à récupérer.
Implémente
1.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.