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


BrushCollection.GetMany(UInt32, Brush[]) Метод

Определение

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

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

Параметры

startIndex
UInt32

unsigned int

uint32_t

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

items
Brush[]

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

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

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 возвращает фактическое количество возвращаемых элементов. Это должно быть минимальное значение a) количество элементов, оставшихся в коллекции, или б) количество запрошенных элементов, то есть "емкость". Таким образом, всякий раз, когда GetMany возвращает меньшее количество запрошенных элементов, достигается конец последовательности. Он возвращает количество элементов, извлеченных в выходном параметре "actual".

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

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