Classe PhysicalGestureRecognizer

[Algumas informações referem-se ao produto pré-lançado que pode ser substancialmente modificado antes de ser lançado comercialmente. Microsoft não faz garantias, expressas ou implícitas, em relação às informações fornecidas aqui.]

Executa o reconhecimento de gestos na entrada do ponteiro alimentado a ele, com a saída retornada em unidades relativas ao dispositivo, em vez dos pixels independentes de exibição retornados por GestureRecognizer. Essas unidades de saída são mais adequadas para entrada touchpad para que os gestos possam ser reconhecidos em relação ao touchpad em si e não à exibição.

Depois que a entrada do ponteiro é alimentada para o reconhecedor, ela se torna ativa. Ele permanece ativo até que a interação de entrada seja concluída, alimentando a entrada de partida para todos os contatos ou concluindo-a à força por meio de CompleteGesture().

Todas as APIs funcionam de forma idêntica aos seus equivalentes no GestureRecognizer. A única diferença é o espaço de coordenadas da saída reconhecida exposta por meio dos eventos de gesto.

Namespace: Windows. UI. Entrada

Membros

Construtor

PhysicalGestureRecognizer();

Retorna uma nova instância da runtimeclass PhysicalGestureRecognizer .

Propriedades

IsActive

Boolean IsActive { get; }

Retorna se uma interação de entrada ainda está sendo processada.

GestureSettings

Windows.UI.Input.GestureSettings GestureSettings;

Obtém ou define os gestos configurados para reconhecimento. O PhysicalGestureRecognizer dá suporte ao seguinte subconjunto de gestos:

  • Torneira
  • Reter
  • ManipulationTranslate[Rails][X,Y]
  • ManipulationRotate
  • ManipulationScale
  • ManipulationMultipleFingerPanning

A entrada touchpad nunca será reconhecida como Toque ou Espera, pois a entrada touchpad só é recebida em cenários em que esses gestos não são mais possíveis de executar.

TapMinContactCount

UInt32 TapMinContactCount;

Obtém ou define o número mínimo de contatos necessários para que um toque seja reconhecido.

TapMaxContactCount

UInt32 TapMaxContactCount;

Obtém ou define o número máximo de contatos necessários para que um toque seja reconhecido.

HoldMinContactCount

UInt32 HoldMinContactCount;

Obtém ou define o número mínimo de contatos necessários para que uma retenção seja reconhecida.

HoldMaxContactCount

UInt32 HoldMaxContactCount;

Obtém ou define o número máximo de contatos necessários para que uma retenção seja reconhecida.

HoldRadius

Single HoldRadius;

Obtém ou define o raio no qual um contato deve permanecer de seu local inferior original para que um toque ou retenção seja reconhecido.

HoldStartDelay

Windows.Foundation.TimeSpan HoldStartDelay;

Obtém ou define a quantidade de tempo que um contato deve ficar para baixo antes que uma retenção seja reconhecida. Se a duração do contato for menor que esse valor quando ele partir e ele não tiver percorrido mais do que o HoldRadius, um toque será reconhecido.

TranslationMinContactCount

UInt32 TranslationMinContactCount;

Obtém ou define o número mínimo de contatos necessários para que uma tradução seja reconhecida.

TranslationMaxContactCount

UInt32 TranslationMaxContactCount;

Obtém ou define o número máximo de contatos necessários para que uma tradução seja reconhecida.

Methods

ProcessDownEvent, ProcessMoveEvents, ProcessUpEvent

void ProcessDownEvent(Windows.UI.Input.PointerPoint value);
void ProcessMoveEvents(IVector<Windows.UI.Input.PointerPoint> value);
void ProcessUpEvent(Windows.UI.Input.PointerPoint value);

Alimenta a entrada de ponteiro especificada para o PhysicalGestureRecognizer para reconhecimento de gestos.

CompleteGesture

void CompleteGesture();

Conclui a interação atual para que a entrada subsequente seja tratada como um novo gesto. Se um gesto estiver em andamento no momento, os eventos para sua conclusão serão disparados.

Eventos

ManipulationStarted

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.ManipulationStartedEventArgs> ManipulationStarted;

Disparado quando o PhysicalGestureRecognizer começa a reconhecer uma manipulação.

ManipulationUpdated

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.ManipulationUpdatedEventArgs> ManipulationUpdated;

Disparado quando o PhysicalGestureRecognizer recebe a entrada atualizada durante uma manipulação.

ManipulationCompleted

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.ManipulationCompletedEventArgs> ManipulationCompleted;

Disparado quando o PhysicalGestureRecognizer termina de reconhecer uma manipulação.

Aproveitado

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.TappedEventArgs> Tapped;

Disparado quando o PhysicalGestureRecognizer reconhece um toque.

Holding

event Windows.Foundation.TypedEventHandler<
    PhysicalGestureRecognizer,
    Windows.UI.Input.HoldingEventArgs> Holding;

Disparado quando o PhysicalGestureRecognizer reconhece um gesto de retenção.

Requisitos

Requisito Valor
Cliente mínimo suportado Windows 11
Namespace Windows. UI. Entrada
Contrato da API Windows. Foundation.UniversalApiContract (versão 19)
IID IPhysicalGestureRecognizer: 79a29f4d-32a6-5aa5-a999-42b0b420c66d

Consulte também

  • Last updated on