UIElement.PointerCaptures Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml

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

IVectorView<Pointer>

IReadOnlyList<Pointer>

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.