Compartir a través de


BrushCollection.GetMany(UInt32, Brush[]) Método

Definición

Recupera varios elementos en un único paso a través del iterador.

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

Parámetros

startIndex
UInt32

unsigned int

uint32_t

Índice desde el que se va a iniciar la recuperación.

items
Brush[]

Proporciona el destino del resultado. Tamaño de la matriz inicial como "capacidad" para especificar cuántos resultados se deben recuperar.

Devoluciones

UInt32

unsigned int

uint32_t

Número de elementos recuperados.

Implementaciones

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[])

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, que es "capacidad". Por lo tanto, cada vez que GetMany devuelve menos del 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 cero, la posición del iterador no cambia. Los elementos de la matriz que siguen a los valores devueltos no se modifican.

Se aplica a