UIElement.PointerCaptures Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml

Ottiene il set di tutti i puntatori acquisiti, rappresentati come valori puntatore .

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)

Valore della proprietà

IVectorView<Pointer>

IReadOnlyList<Pointer>

Raccolta di puntatori acquisiti, ognuno rappresentato come oggetto Pointer .

Commenti

Per altre info su come acquisire un puntatore e sul motivo per cui si potrebbe voler eseguire questa operazione, vedere CapturePointer.

Poiché esistono scenari di input come le manipolazioni che coinvolgono più di un punto di puntatore, il Windows Runtime abilita l'acquisizione di più puntatori alla volta. La PointerCaptures proprietà espone una visualizzazione dei punti puntatore attualmente acquisiti da UIElement.

Il valore di questa proprietà viene calcolato in base ai risultati di altre azioni. La chiamata a CapturePointer aggiunge alla raccolta interna di cui PointerCaptures offre una visualizzazione di sola lettura. La chiamata a ReleasePointerCapture rimuove dalla raccolta. ReleasePointerCaptures cancella la raccolta. L'azione dell'utente che invalida l'acquisizione del puntatore, ad esempio il rilascio da un punto del puntatore, modifica anche lo stato di acquisizione e quindi la raccolta. Per altre info, vedi Interazioni del mouse e Gestire l'input del puntatore.

La raccolta non è necessariamente indicizzata da PointerId. Per trovare un oggetto specifico PointerId, è necessario controllare gli elementi nella raccolta e fare riferimento a un puntatore specifico.