GradientStopCollection.GetMany(UInt32, GradientStop[]) 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 une seule passe à travers l’itérateur.
public:
virtual unsigned int GetMany(unsigned int startIndex, Platform::Array <GradientStop ^> ^ items) = IVector<GradientStop ^>::GetMany;uint32_t GetMany(uint32_t const& startIndex, winrt::array_view <GradientStop const&> & items);public uint GetMany(uint startIndex, GradientStop[] items);function getMany(startIndex, items)Public Function GetMany (startIndex As UInteger, items As GradientStop()) As UIntegerParamètres
- startIndex
-
UInt32
unsigned int
uint32_t
Index à partir duquel commencer la récupération.
- items
- GradientStop[]
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 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.