BrushCollection.GetMany(UInt32, Brush[]) 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 einzigen Durchlauf durch den Iterator ab.
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 UIntegerParameter
- startIndex
-
UInt32
unsigned int
uint32_t
Der Index, aus dem der Abruf gestartet werden soll.
- items
- Brush[]
Stellt das Ziel für das Ergebnis bereit. Vergrößern Sie die anfängliche Arraygröße als "Kapazität", 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, als ob sie und für jedes Element im angegebenen Array aufruft. Dies bedeutet, dass das erste element, das von der GetMany-Methode zurückgegeben wird, dasselbe Element ist, das durch Abrufen der -Eigenschaft vor dem Aufruf 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 Auflistung verbleibenden Elemente oder b) der Anzahl der angeforderten Elemente sein, d. h. "Kapazität". Wenn GetMany weniger als die anzahl der angeforderten Elemente zurückgibt, ist daher das Ende der Sequenz erreicht. Sie gibt die Anzahl der Elemente zurück, die im Ausgabeparameter "actual" abgerufen wurden.
Wenn der Aufrufer eine Kapazität von 0 (null) angibt, bleibt die Position des Iterators unverändert. Elemente im Array, die auf die zurückgegebenen Werte folgen, bleiben unverändert.