Freigeben über


GradientStopCollection.GetMany(UInt32, GradientStop[]) Methode

Definition

Ruft mehrere Elemente in einem einzelnen Durchgang durch den Iterator ab.

public:
 virtual unsigned int GetMany(unsigned int startIndex, Platform::Array <GradientStop ^> ^ items) = IVector<GradientStop ^>::GetMany;
uint32_t GetMany(uint32_t const& startIndex, winrt::array_view <GradientStop const&> & items);
public uint GetMany(uint startIndex, GradientStop[] items);
function getMany(startIndex, items)
Public Function GetMany (startIndex As UInteger, items As GradientStop()) As UInteger

Parameter

startIndex
UInt32

unsigned int

uint32_t

Der Index, von dem aus der Abruf gestartet werden soll.

items
GradientStop[]

Stellt das Ziel für das Ergebnis bereit. Ordnen Sie die anfängliche Arraygröße als "Kapazität" an, um anzugeben, wie viele Ergebnisse abgerufen werden sollen.

Gibt zurück

UInt32

unsigned int

uint32_t

Die Anzahl der abgerufenen Elemente.

Implementiert

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

Hinweise

Die GetMany-Methode funktioniert identisch wie beim Aufrufen und für jedes Element im angegebenen Array. Dies bedeutet, dass das erste von der GetMany-Methode zurückgegebene Element dasselbe Element ist, das durch Abrufen der Eigenschaft vor dem Aufrufen von GetMany zurückgegeben wird. Nachdem der GetMany-Aufruf zurückgegeben wurde, ruft die -Eigenschaft das -Element ab, das dem letzten element folgt, das vom GetMany-Aufruf zurückgegeben wurde, oder erzeugt einen Fehler, wenn keine weiteren Elemente in den Sequenzen vorhanden sind.

Die GetMany-Methode gibt die tatsächliche Anzahl der zurückgegebenen Elemente zurück. Es muss das Minimum von a) der Anzahl der in der Sammlung verbleibenden Elemente oder b) der Anzahl der angeforderten Elemente, d. h. "Kapazität", sein. Wenn GetMany daher weniger als die Anzahl der angeforderten Elemente zurückgibt, ist das Ende der Sequenz erreicht. Es gibt die Anzahl der Im "tatsächlichen" Ausgabeparameter abgerufenen Elemente zurück. Wenn der Aufrufer eine Kapazität von 0 angibt, bleibt die Position des Iterators unverändert. Elemente im Array, die den zurückgegebenen Werten folgen, bleiben unverändert.

Gilt für: