Classe PhysicalGestureRecognizer

[Alcune informazioni riguardano il prodotto non rilasciato che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non fornisce alcuna garanzia, espressa o implicita, in relazione alle informazioni fornite qui.]

Esegue il riconoscimento dei movimenti sull'input del puntatore immesso, con l'output restituito in unità relative al dispositivo, anziché i pixel indipendenti dallo schermo restituiti da GestureRecognizer. Queste unità di output sono più adatte per l'input del touchpad, in modo che i movimenti possano essere riconosciuti rispetto al touchpad stesso anziché allo schermo.

Una volta che l'input del puntatore viene alimentato al riconoscitore, diventa attivo. Rimane attivo fino al completamento dell'interazione di input, alimentando l'input di partenza per tutti i contatti o completandolo forzatamente tramite CompleteGesture().

Tutte le API funzionano in modo identico alle rispettive controparti in GestureRecognizer. L'unica differenza è lo spazio delle coordinate dell'output riconosciuto esposto tramite gli eventi di movimento.

Namespace: Windows. UI. Input

Membri

Costruttore

PhysicalGestureRecognizer();

Restituisce una nuova istanza della classe di runtime PhysicalGestureRecognizer .

Proprietà

IsActive

Boolean IsActive { get; }

Restituisce un valore che indica se è ancora in corso l'elaborazione di un'interazione di input.

GestureSettings

Windows.UI.Input.GestureSettings GestureSettings;

Ottiene o imposta i movimenti configurati per il riconoscimento. PhysicalGestureRecognizer supporta il sottoinsieme di movimenti seguente:

  • Toccare
  • Blocco
  • ManipulationTranslate[Rails][X,Y]
  • ManipulationRotate
  • ManipulationScale
  • ManipulationMultipleFingerPanning

L'input del touchpad non verrà mai riconosciuto come Tocco o Blocco, poiché l'input del touchpad viene ricevuto solo negli scenari in cui tali movimenti non sono più possibile eseguire.

TapMinContactCount

UInt32 TapMinContactCount;

Ottiene o imposta il numero minimo di contatti necessari per il riconoscimento di un tocco.

TapMaxContactCount

UInt32 TapMaxContactCount;

Ottiene o imposta il numero massimo di contatti necessari per il riconoscimento di un tocco.

HoldMinContactCount

UInt32 HoldMinContactCount;

Ottiene o imposta il numero minimo di contatti necessari per il riconoscimento di un blocco.

HoldMaxContactCount

UInt32 HoldMaxContactCount;

Ottiene o imposta il numero massimo di contatti necessari per il riconoscimento di un blocco.

HoldRadius

Single HoldRadius;

Ottiene o imposta il raggio all'interno del quale un contatto deve rimanere dalla posizione originale verso il basso per il riconoscimento di un tocco o di un blocco.

HoldStartDelay

Windows.Foundation.TimeSpan HoldStartDelay;

Ottiene o imposta la quantità di tempo per cui un contatto deve rimanere inattivo prima che venga riconosciuto un blocco. Se la durata del contatto è minore di questo valore quando parte e non ha viaggiato più lontano da HoldRadius, viene riconosciuto un tocco.

TranslationMinContactCount

UInt32 TranslationMinContactCount;

Ottiene o imposta il numero minimo di contatti necessari per il riconoscimento di una traduzione.

TranslationMaxContactCount

UInt32 TranslationMaxContactCount;

Ottiene o imposta il numero massimo di contatti necessari per il riconoscimento di una traduzione.

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);

Inserisce l'input del puntatore specificato in PhysicalGestureRecognizer per il riconoscimento dei movimenti.

CompleteGesture

void CompleteGesture();

Completa l'interazione corrente in modo che l'input successivo venga considerato come un nuovo movimento. Se un movimento è attualmente in corso, verranno attivati gli eventi per il completamento.

Events

ManipulationStarted

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

Attivato quando PhysicalGestureRecognizer inizia a riconoscere una manipolazione.

ManipulationUpdated

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

Attivato quando PhysicalGestureRecognizer riceve l'input aggiornato durante una manipolazione.

ManipulationCompleted

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

Attivato al termine del riconoscimento di una manipolazione da parte di PhysicalGestureRecognizer .

Sfruttato

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

Attivato quando PhysicalGestureRecognizer riconosce un tocco.

Patrimonio

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

Attivato quando PhysicalGestureRecognizer riconosce un movimento di blocco.

Requisiti

Requisito Valore
Client minimo supportato Windows 11
Namespace Windows. UI. Input
Contratto API Windows. Foundation.UniversalApiContract (versione 19)
IID IPhysicalGestureRecognizer: 79a29f4d-32a6-5aa5-a999-42b0b420c66d

Vedere anche

  • Last updated on