PointCollection.GetMany(UInt32, Point[]) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
反復子を通過する 1 つのパス内の複数の要素を取得します。
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[]
結果の変換先を提供します。 取得する必要がある結果の数を指定するために、最初の配列サイズを "容量" としてサイズ設定します。
戻り値
取得した項目数。
実装
M:Windows.Foundation.Collections.IVector
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) コレクションに残っている要素の数、または b) 要求された要素の数 、つまり "容量" の最小値である必要があります。 したがって、GetMany が要求された要素の数より少ない数を返すたびに、シーケンスの末尾に達しました。 "actual" 出力パラメーターで取得された要素の数を返します。
呼び出し元が容量 0 を指定すると、反復子の位置は変更されません。 返される値に続く配列内の要素は変更されません。