UIElement.PointerCaptures Propriedade

Definição

Namespace:

Microsoft.UI.Xaml

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

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 você pode querer 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 PointerCaptures propriedade 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 com o mouse e Entrada do ponteiro de identificador.

A coleção não é necessariamente indexada por PointerId. Para localizar um específicoPointerId, você deve marcar os itens na coleção e referenciar um Ponteiro específico.