GradientStopCollection.GetMany(UInt32, GradientStop[]) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 UIntegerParameter
- 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
Die Anzahl der abgerufenen Elemente.
Implementiert
1.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.