GradientStopCollection.GetMany(UInt32, GradientStop[]) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Recupera varios elementos en un único paso a través del iterador.
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 UIntegerParámetros
- startIndex
-
UInt32
unsigned int
uint32_t
Índice desde el que se va a iniciar la recuperación.
- items
- GradientStop[]
Proporciona el destino del resultado. Tamaño de la matriz inicial como "capacidad" para especificar cuántos resultados se deben recuperar.
Devoluciones
Número de elementos recuperados.
Implementaciones
1.GetMany(System.UInt32,0[])
M:Windows.Foundation.Collections.IVector1.GetMany(unsigned int,0[])
M:Windows.Foundation.Collections.IVector1.GetMany(uint32_t,0[])
Comentarios
El método GetMany funciona de forma idéntica como si llamara a y para cada elemento de la matriz proporcionada. Esto significa que el primer elemento devuelto por el método GetMany es el mismo elemento que devolvió recuperando la propiedad antes de llamar a GetMany. Después de que se devuelva la llamada a GetMany, la propiedad recuperará el elemento que sigue al último elemento devuelto por la llamada a GetMany o producirá un error si no existen más elementos en las secuencias.
El método GetMany devuelve el número real de elementos devueltos. Debe ser el mínimo de a) el número de elementos restantes en la colección, o b) el número de elementos solicitados, es decir, "capacidad". Por lo tanto, cada vez que GetMany devuelve menos que el número de elementos solicitados, se ha alcanzado el final de la secuencia. Devuelve el número de elementos recuperados en el parámetro de salida "real". Cuando el autor de la llamada especifica una capacidad de 0, la posición del iterador no cambia. Los elementos de la matriz que siguen a los valores devueltos no se modifican.