UIElement.PointerCaptures Propriedade

Definição

Namespace:

Windows.UI.Xaml

Obtém o conjunto de todos os ponteiros capturados, representados como valores de ponteiro .

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)

Valor da propriedade

IVectorView<Pointer>

IReadOnlyList<Pointer>

A coleção de ponteiros capturados, cada um representado como um objeto Pointer .

Comentários

Para obter mais informações sobre como capturar um ponteiro e por que talvez você queira fazer isso, consulte CapturePointer.

Como há cenários de entrada, como manipulações que envolvem mais de um ponto de ponteiro, o Windows Runtime permite capturar mais de um ponteiro por vez. A propriedade PointerCaptures expõe uma exibição de quais pontos de ponteiro são capturados atualmente pelo UIElement.

O valor dessa propriedade é calculado com base nos resultados de outras ações. Chamar CapturePointer adiciona à coleção interna da qual PointerCaptures fornece uma exibição somente leitura. Chamar ReleasePointerCapture remove da coleção. ReleasePointerCaptures limpa a coleção. A ação do usuário que invalida a captura de ponteiro, como a liberação de um ponto de ponteiro, também altera o estado de captura e, portanto, a coleção. Para obter mais informações, consulte Interações do mouse e Entrada de ponteiro do identificador.

A coleção não é necessariamente indexada por PointerId. Para encontrar uma PointerId específica, você deve marcar os itens da coleção e fazer referência a um Ponteiro específico.