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[]
Предоставляет назначение для результата. Задайте размер исходного массива как "емкость", чтобы указать, сколько результатов необходимо извлечь.
Возвращаемое значение
Количество извлеченных элементов.
Реализации
1.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".
Если вызывающий объект задает нулевую емкость, положение итератора остается неизменным. Элементы массива, следующие за возвращаемыми значениями, не изменяются.