UIElement.PointerCaptures Propriété

Définition

Espace de noms:

Windows.UI.Xaml

Obtient l’ensemble de tous les pointeurs capturés, représentés sous forme de 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, chacun représenté sous la forme d’un objet Pointer .

Remarques

Pour plus d’informations sur la capture d’un pointeur et la raison pour laquelle vous pouvez 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 propriété PointerCaptures expose une vue des points de pointeur actuellement capturés par l’élément 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 avec la souris et Gérer l’entrée du pointeur.

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