GeometryCollection.GetMany(UInt32, Geometry[]) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Извлекает несколько элементов в одном проходе через итератор.
public:
virtual unsigned int GetMany(unsigned int startIndex, Platform::Array <Geometry ^> ^ items) = IVector<Geometry ^>::GetMany;
uint32_t GetMany(uint32_t const& startIndex, winrt::array_view <Geometry const&> & items);
public uint GetMany(uint startIndex, Geometry[] items);
function getMany(startIndex, items)
Public Function GetMany (startIndex As UInteger, items As Geometry()) As UInteger
Параметры
- startIndex
-
UInt32
unsigned int
uint32_t
Индекс, с которого начинается извлечение.
- items
- Geometry[]
Предоставляет назначение для результата. Задайте размер исходного массива как "емкость", чтобы указать, сколько результатов следует извлечь.
Возвращаемое значение
Количество извлеченных элементов.
Реализации
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 возвращает фактическое количество возвращаемых элементов. Это должно быть минимальное значение а) количество элементов, оставшихся в коллекции, или б) количество запрошенных элементов, т. е. "емкость". Таким образом, каждый раз, когда GetMany возвращает меньшее количество запрошенных элементов, достигается конец последовательности. Он возвращает количество элементов, извлеченных в параметре вывода "actual". Если вызывающий объект указывает емкость 0, положение итератора остается неизменным. Элементы массива, следующие за возвращаемыми значениями, не изменяются.