次の方法で共有


BrushCollection.GetMany(UInt32, Brush[]) メソッド

定義

反復子を 1 回のパスで複数の要素を取得します。

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) コレクションに残っている要素の数、または b) 要求された要素の数 ("容量") の最小値である必要があります。 したがって、GetMany が返す要素数が要求された数より少ない場合は常に、シーケンスの末尾に達しました。 "actual" 出力パラメーターで取得された要素の数を返します。

呼び出し元が 0 の容量を指定すると、反復子の位置は変更されません。 返される値の後の配列内の要素は変更されません。

適用対象