UIElement.PointerCaptures Eigenschaft
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 den Satz aller erfassten Zeiger ab, die als Zeigerwerte dargestellt werden.
public:
property IVectorView<Pointer ^> ^ PointerCaptures { IVectorView<Pointer ^> ^ get(); };IVectorView<Pointer> PointerCaptures();public IReadOnlyList<Pointer> PointerCaptures { get; }var iVectorView = uIElement.pointerCaptures;Public ReadOnly Property PointerCaptures As IReadOnlyList(Of Pointer)Eigenschaftswert
Die Auflistung der erfassten Zeiger, die jeweils als Zeigerobjekt dargestellt werden.
Hinweise
Weitere Informationen dazu, wie Sie einen Zeiger erfassen und warum Sie dies möglicherweise tun möchten, finden Sie unter CapturePointer.
Da es Eingabeszenarien wie Bearbeitungen gibt, die mehr als einen Zeigerpunkt umfassen, ermöglicht die Windows-Runtime das Erfassen von mehr als einem Zeiger gleichzeitig. Die PointerCaptures -Eigenschaft macht eine Ansicht verfügbar, welche Zeigerpunkte derzeit vom UIElement erfasst werden.
Der Wert dieser Eigenschaft wird basierend auf den Ergebnissen anderer Aktionen berechnet. Durch aufrufen von CapturePointer wird die interne Auflistung hinzugefügt, für die PointerCaptures eine schreibgeschützte Ansicht bereitstellt. Durch aufrufen von ReleasePointerCapture wird aus der Auflistung entfernt. ReleasePointerCaptures löscht die Auflistung. Eine Benutzeraktion, die die Zeigererfassung ungültig macht, z. B. das Freigeben von einem Zeigerpunkt, ändert auch den Erfassungszustand und damit die Sammlung. Weitere Informationen finden Sie unter Mausinteraktionen und Behandeln von Zeigereingaben.
Die Auflistung ist nicht notwendigerweise durch PointerId indiziert. Um einen bestimmten PointerIdzu finden, müssen Sie die Elemente in der Auflistung überprüfen und auf einen bestimmten Zeiger verweisen.