UIElement.PointerCaptures Eigenschaft

Definition

Namespace:

Windows.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 erfasster Zeiger, die jeweils als Zeigerobjekt dargestellt werden.

Hinweise

Weitere Informationen dazu, wie Sie einen Zeiger erfassen und warum Sie dies tun möchten, finden Sie unter CapturePointer.

Da es Eingabeszenarien wie Bearbeitungen gibt, die mehr als einen Zeigerpunkt umfassen, ermöglicht die Windows-Runtime die Erfassung 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. Das Aufrufen von CapturePointer fügt der internen Auflistung hinzu, die PointerCaptures eine schreibgeschützte Ansicht bietet. Das Aufrufen von ReleasePointerCapture wird aus der Auflistung entfernt. ReleasePointerCaptures löscht die Auflistung. Eine Benutzeraktion, die die Zeigererfassung ungültig macht, z. B. das Loslassen von einem Zeigerpunkt, ändert auch den Erfassungszustand und damit die Auflistung. Weitere Informationen finden Sie unter Mausinteraktionen und Handle-Zeigereingabe.

Die Auflistung ist nicht unbedingt durch PointerId indiziert. Um eine bestimmte PointerId zu finden, müssen Sie die Elemente in der Auflistung überprüfen und auf einen bestimmten Zeiger verweisen.