PhysicalGestureRecognizer-Klasse

[Einige Informationen beziehen sich auf vorab veröffentlichte Produkte, die vor der kommerziellen Veröffentlichung erheblich geändert werden können. Microsoft übernimmt keine Gewährleistungen, ausdrücklichen oder konkludenten Angaben in Bezug auf die hier bereitgestellten Informationen.]

Führt die Gestikerkennung für die zeigereingabe aus, die an sie gespeist wird, wobei die Ausgabe in Einheiten relativ zum Gerät zurückgegeben wird, anstatt die von GestureRecognizer zurückgegebenen anzeigeunabhängigen Pixel. Diese Ausgabeeinheiten eignen sich besser für die Touchpadeingabe, sodass Gesten relativ zum Touchpad selbst und nicht zum Display erkannt werden können.

Sobald die Zeigereingabe an die Erkennung gespeist wird, wird sie aktiv. Sie bleibt aktiv, bis die Eingabeinteraktion abgeschlossen ist – entweder durch Das Einfüttern von ausgehenden Eingaben für alle Kontakte oder durch forcibly completeGesture().

Alle APIs funktionieren identisch mit ihren Gegenstücken in GestureRecognizer. Der einzige Unterschied ist der Koordinatenraum der erkannten Ausgabe, die über die Gestikereignisse verfügbar gemacht wird.

Namespace: Windows. BENUTZEROBERFLÄCHE. Eingabe

Elemente

Konstruktor

PhysicalGestureRecognizer();

Gibt eine neue Instanz der PhysicalGestureRecognizer-Laufzeitklasse zurück.

Eigenschaften

IsActive

Boolean IsActive { get; }

Gibt zurück, ob eine Eingabeinteraktion noch verarbeitet wird.

GestureSettings

Windows.UI.Input.GestureSettings GestureSettings;

Ruft die Gesten ab, die für die Erkennung konfiguriert sind, oder legt diese fest. Der PhysicalGestureRecognizer unterstützt die folgende Teilmenge von Gesten:

  • Tippen
  • Hold
  • ManipulationTranslate[Rails][X,Y]
  • ManipulationRotate
  • ManipulationScale
  • ManipulationMultipleFingerPanning

Touchpadeingaben werden nie als Tippen oder Halten erkannt, da touchpadeingaben nur in Szenarien empfangen werden, in denen diese Gesten nicht mehr ausgeführt werden können.

TapMinContactCount

UInt32 TapMinContactCount;

Ruft die Mindestanzahl der Kontakte ab, die für die Erkennung eines Tippens erforderlich sind, oder legt diese fest.

TapMaxContactCount

UInt32 TapMaxContactCount;

Dient zum Abrufen oder Festlegen der maximalen Anzahl von Kontakten, die für die Erkennung eines Tippens erforderlich sind.

HoldMinContactCount

UInt32 HoldMinContactCount;

Ruft die Mindestanzahl der Kontakte ab, die für die Erkennung eines Halteraums erforderlich sind, oder legt diese fest.

HoldMaxContactCount

UInt32 HoldMaxContactCount;

Ruft die maximale Anzahl von Kontakten ab, die für die Erkennung eines Halteraums erforderlich sind, oder legt diese fest.

HoldRadius

Single HoldRadius;

Ruft den Radius ab, in dem ein Kontakt von seiner ursprünglichen Position nach unten bleiben muss, damit ein Tipp- oder Haltebereich erkannt wird, oder legt diesen fest.

HoldStartDelay

Windows.Foundation.TimeSpan HoldStartDelay;

Ruft ab oder legt fest, wie lange ein Kontakt nach unten bleiben muss, bevor ein Halteraum erkannt wird. Wenn die Dauer des Kontakts kleiner als dieser Wert ist, wenn er abfährt, und er nicht weiter als der HoldRadius bewegt wurde, wird ein Tippen erkannt.

TranslationMinContactCount

UInt32 TranslationMinContactCount;

Ruft die Mindestanzahl der Kontakte ab, die für die Erkennung einer Übersetzung erforderlich sind, oder legt diese fest.

TranslationMaxContactCount

UInt32 TranslationMaxContactCount;

Ruft die maximale Anzahl von Kontakten ab, die für die Erkennung einer Übersetzung erforderlich sind, oder legt diese fest.

Methodik

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

Feeds the specified pointer input to the PhysicalGestureRecognizer for gesture recognition.

CompleteGesture

void CompleteGesture();

Schließt die aktuelle Interaktion ab, sodass nachfolgende Eingaben als neue Geste behandelt werden. Wenn derzeit eine Geste ausgeführt wird, werden Ereignisse für den Abschluss ausgelöst.

Ereignisse

ManipulationStarted

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

Wird ausgelöst, wenn der PhysicalGestureRecognizer beginnt, eine Manipulation zu erkennen.

ManipulationUpdated

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

Wird ausgelöst, wenn der PhysicalGestureRecognizer während einer Manipulation aktualisierte Eingaben empfängt.

ManipulationCompleted

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

Wird ausgelöst, wenn der PhysicalGestureRecognizer die Erkennung einer Manipulation beendet hat.

Angezapft

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

Wird ausgelöst, wenn der PhysicalGestureRecognizer einen Tipp erkennt.

Holding

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

Wird ausgelöst, wenn der PhysicalGestureRecognizer eine Haltebewegung erkennt.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 11
Namespace Windows. BENUTZEROBERFLÄCHE. Eingabe
API-Vertrag Windows. Foundation.UniversalApiContract (Version 19)
IID IPhysicalGestureRecognizer: 79a29f4d-32a6-5aa5-a999-42b0b420c66d

Siehe auch

  • Last updated on