UIElement.PointerCaptures Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml

Obtient l’ensemble de tous les pointeurs capturés, représentés en tant que valeurs de pointeur .

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)

Valeur de propriété

IVectorView<Pointer>

IReadOnlyList<Pointer>

Collection de pointeurs capturés, chacune représentée en tant qu’objet Pointer .

Remarques

Pour plus d’informations sur la capture d’un pointeur et la raison pour laquelle vous souhaiterez peut-être le faire, consultez CapturePointer.

Étant donné qu’il existe des scénarios d’entrée tels que des manipulations qui impliquent plusieurs points de pointeur, le Windows Runtime permet de capturer plusieurs pointeurs à la fois. La PointerCaptures propriété expose une vue dont les points de pointeur sont actuellement capturés par l’UIElement.

La valeur de cette propriété est calculée en fonction des résultats d’autres actions. L’appel de CapturePointer ajoute à la collection interne dont PointerCaptures fournit une vue en lecture seule. L’appel de ReleasePointerCapture supprime de la collection. ReleasePointerCaptures efface la collection. L’action de l’utilisateur qui invalide la capture de pointeur, telle que la libération à partir d’un point de pointeur, modifie également l’état de capture et, par conséquent, la collection. Pour plus d’informations, consultez Interactions de la souris et Gérer l’entrée de pointeur.

La collection n’est pas nécessairement indexée par PointerId. Pour rechercher un pointeur spécifique PointerId, vous devez vérifier les éléments de la collection et référencer un pointeur spécifique.