PointCollection.GetMany(UInt32, Point[]) Metode

Definisi

Ruang nama:

Windows.UI.Xaml.Media

Mengambil beberapa elemen dalam satu pass melalui iterator.

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

Parameter

startIndex

UInt32

unsigned int

uint32_t

Indeks untuk memulai pengambilan.

items

Point[]

Menyediakan tujuan untuk hasilnya. Ukuran ukuran array awal sebagai "kapasitas" untuk menentukan berapa banyak hasil yang harus diambil.

Mengembalikan

UInt32

unsigned int

uint32_t

Jumlah item yang diambil.

Penerapan

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[])

Keterangan

Metode GetMany beroperasi secara identik seolah-olah memanggil dan untuk setiap elemen dalam array yang disediakan. Ini berarti bahwa elemen pertama yang dikembalikan oleh metode GetMany adalah elemen yang sama seperti yang dikembalikan dengan mengambil properti sebelum memanggil GetMany. Setelah panggilan GetMany kembali, properti akan mengambil elemen mengikuti elemen terakhir yang dikembalikan oleh panggilan GetMany, atau menghasilkan kesalahan jika tidak ada lagi elemen dalam urutan.

Metode GetMany mengembalikan jumlah elemen aktual yang dikembalikan. Ini harus minimal a) jumlah elemen yang tersisa dalam koleksi, atau b) jumlah elemen yang diminta, yaitu, "kapasitas". Oleh karena itu, setiap kali GetMany mengembalikan kurang dari jumlah elemen yang diminta, akhir urutan telah tercapai. Ini mengembalikan jumlah elemen yang diambil dalam parameter output "aktual".

Ketika penelepon menentukan kapasitas 0, posisi iterator tidak berubah. Elemen dalam array yang mengikuti nilai yang dikembalikan tidak berubah.