PointCollection.GetMany(UInt32, Point[]) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 UIntegerParâ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
O número de itens recuperados.
Implementações
1.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.