Поделиться через


PointCollection.GetMany(UInt32, Point[]) Метод

Определение

Извлекает несколько элементов в одном проходе через итератор.

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

Параметры

startIndex
UInt32

unsigned int

uint32_t

Индекс, с которого начинается извлечение.

items
Point[]

Предоставляет назначение для результата. Задайте размер исходного массива как "емкость", чтобы указать, сколько результатов следует извлечь.

Возвращаемое значение

UInt32

unsigned int

uint32_t

Количество извлеченных элементов.

Реализации

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

Комментарии

Метод GetMany работает так же, как при вызове и для каждого элемента в предоставленном массиве. Это означает, что первый элемент, возвращаемый методом GetMany, является тем же элементом, что и при получении свойства перед вызовом GetMany. После возврата вызова GetMany свойство извлекает элемент, следующий за последним элементом, возвращенным вызовом GetMany, или выдает ошибку, если в последовательностях больше нет элементов.

Метод GetMany возвращает фактическое количество возвращаемых элементов. Это должно быть минимальное значение а) количество элементов, оставшихся в коллекции, или б) количество запрошенных элементов, т. е. "емкость". Таким образом, каждый раз, когда GetMany возвращает меньшее количество запрошенных элементов, достигается конец последовательности. Он возвращает количество элементов, извлеченных в параметре вывода "actual".

Если вызывающий объект указывает емкость 0, положение итератора остается неизменным. Элементы массива, следующие за возвращаемыми значениями, не изменяются.

Применяется к