Compartilhar via


PointCollection.GetMany(UInt32, Point[]) Método

Definição

Recupera vários elementos em uma única passagem pelo iterador.

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 UInteger

Parâmetros

startIndex
UInt32

unsigned int

uint32_t

O índice do qual iniciar a recuperação.

items
Point[]

Fornece o destino do resultado. Dimensione o tamanho inicial da matriz como uma "capacidade" para especificar quantos resultados devem ser recuperados.

Retornos

UInt32

unsigned int

uint32_t

O número de itens recuperados.

Implementações

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

Comentários

O método GetMany opera de forma idêntica como se estivesse chamando e para cada elemento na matriz fornecida. Isso significa que o primeiro elemento retornado pelo método GetMany é o mesmo elemento retornado pela recuperação da propriedade antes de chamar GetMany. Depois que a chamada GetMany retornar, a propriedade recuperará o elemento após o último elemento retornado pela chamada GetMany ou produzirá um erro se não houver mais elementos nas sequências.

O método GetMany retorna o número real de elementos retornados. Deve ser o mínimo de a) o número de elementos restantes na coleção ou b) o número de elementos solicitados, ou seja, "capacidade". Portanto, sempre que GetMany retornar menos do que o número de elementos solicitados, o final da sequência será atingido. Ele retorna o número de elementos recuperados no parâmetro de saída "real".

Quando o chamador especifica uma capacidade de 0, a posição do iterador é inalterada. Os elementos na matriz após os valores retornados não são alterados.

Aplica-se a