UIElement.PointerCaptures Propriedade

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

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 o CapturePointer adiciona à coleção interna da qual o 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 as interações do Mouse e a entrada do ponteiro Handle.

A coleção não é necessariamente indexada por PointerId. Para localizar um determinado PointerId, você deve verificar os itens na coleção e fazer referência a um ponteiro específico.