GeometryCollection.GetMany(UInt32, Geometry[]) 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 solo paso a través del iterador.
public:
virtual unsigned int GetMany(unsigned int startIndex, Platform::Array <Geometry ^> ^ items) = IVector<Geometry ^>::GetMany;uint32_t GetMany(uint32_t const& startIndex, winrt::array_view <Geometry const&> & items);public uint GetMany(uint startIndex, Geometry[] items);function getMany(startIndex, items)Public Function GetMany (startIndex As UInteger, items As Geometry()) As UIntegerParámetros
- startIndex
-
UInt32
unsigned int
uint32_t
Índice desde el que se va a iniciar la recuperación.
- items
- Geometry[]
Proporciona el destino del resultado. Ajustar el tamaño de la matriz inicial como una "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 el devuelto recuperando la propiedad antes de llamar a GetMany. Una vez que se devuelve la llamada a GetMany, la propiedad recuperará el elemento después del ú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 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 0, la posición del iterador no cambia. Los elementos de la matriz que siguen a los valores devueltos no cambian.