InkApplicationGesture-Enumeration (msinkaut.h)

Artikel
08/24/2023

Definiert Werte, die das Interesse an einer Reihe anwendungsspezifischer Gesten festlegen.

Anwendungsgesten sind Gesten, die Sie für die Unterstützung Ihrer Anwendung auswählen können. Anwendungen, die speziell für die Arbeit mit einem Stift entwickelt wurden, verwenden diese Gesten eher als Anwendungen für Maus und Tastatur.

Die Gesten Tap und DoubleTap werden als Anwendungsgesten und Systemgesten unterstützt (Systemgesten werden im InkSystemGesture-Enumerationstyp definiert). Dies bedeutet, dass Sie eine Anwendungsgeste integrieren können, die über eine Komponente verfügt, die als Tap oder DoubleTap ausgelegt werden kann (z. B. die Ausrufegeste ). Aktivieren Sie in diesem Fall die Tap-Anwendungsgeste, und deaktivieren Sie die Tippen-Systemgeste in Ihrer Anwendung. Wenn ein Benutzer tippt, wird die Anwendungsgeste erkannt. Auf diese Weise kann Ihre Anwendung auf eine einzelne Komponente lauschen, die eine Systemgeste Tap von einem Tap innerhalb der Anwendungsgeste identifizieren und unterscheiden kann.

Zusätzlich zur folgenden Liste von Gesten beabsichtigt Microsoft, viele Gestenglyphen als Teil der Microsoft-Gestenerkennung zu unterstützen. Weitere Informationen zu diesen nicht implementierten Gesten-Glyphen finden Sie unter Nicht implementierte Glyphen.

Weitere Informationen zu Anwendungsgesten und Systemgesten finden Sie unter Verwenden von Gesten und Stifteingabe, Freihand und Erkennung.

Syntax

typedef enum InkApplicationGesture {
  IAG_AllGestures = 0,
  IAG_NoGesture = 0xf000,
  IAG_Scratchout = 0xf001,
  IAG_Triangle = 0xf002,
  IAG_Square = 0xf003,
  IAG_Star = 0xf004,
  IAG_Check = 0xf005,
  IAG_Curlicue = 0xf010,
  IAG_DoubleCurlicue = 0xf011,
  IAG_Circle = 0xf020,
  IAG_DoubleCircle = 0xf021,
  IAG_SemiCircleLeft = 0xf028,
  IAG_SemiCircleRight = 0xf029,
  IAG_ChevronUp = 0xf030,
  IAG_ChevronDown = 0xf031,
  IAG_ChevronLeft = 0xf032,
  IAG_ChevronRight = 0xf033,
  IAG_ArrowUp = 0xf038,
  IAG_ArrowDown = 0xf039,
  IAG_ArrowLeft = 0xf03a,
  IAG_ArrowRight = 0xf03b,
  IAG_Up = 0xf058,
  IAG_Down = 0xf059,
  IAG_Left = 0xf05a,
  IAG_Right = 0xf05b,
  IAG_UpDown = 0xf060,
  IAG_DownUp = 0xf061,
  IAG_LeftRight = 0xf062,
  IAG_RightLeft = 0xf063,
  IAG_UpLeftLong = 0xf064,
  IAG_UpRightLong = 0xf065,
  IAG_DownLeftLong = 0xf066,
  IAG_DownRightLong = 0xf067,
  IAG_UpLeft = 0xf068,
  IAG_UpRight = 0xf069,
  IAG_DownLeft = 0xf06a,
  IAG_DownRight = 0xf06b,
  IAG_LeftUp = 0xf06c,
  IAG_LeftDown = 0xf06d,
  IAG_RightUp = 0xf06e,
  IAG_RightDown = 0xf06f,
  IAG_Exclamation = 0xf0a4,
  IAG_Tap = 0xf0f0,
  IAG_DoubleTap = 0xf0f1
} ;

Konstanten


`IAG_AllGestures` Wert: 0 Alle anwendungsspezifischen Gesten.
`IAG_NoGesture` Wert: 0xf000 Keine anwendungsspezifischen Gesten. Weitere Informationen zu diesem Member finden Sie im abschnitt "Hinweise". Dies ist der Standardwert.
`IAG_Scratchout` Wert: 0xf001 Diese Stiftbewegung muss als einzelner Strich gezeichnet werden, der mindestens drei Vorwärts- und Rückwärtsbewegungen aufweist.
`IAG_Triangle` Wert: 0xf002 Das Dreieck muss mit einem einzelnen Strich ohne Heben des Stifts gezeichnet werden.
`IAG_Square` Wert: 0xf003 Das Quadrat kann mit einem oder zwei Strichen gezeichnet werden. Zeichnen Sie bei einem Strich das ganze Quadrat, ohne den Stift zu heben. Zeichnen Sie bei zwei Strichen drei Seiten des Quadrats, und zeichnen Sie die verbleibende Seite mit einem neuen Strich. Verwenden Sie nicht mehr als zwei Striche, um das Quadrat zu zeichnen.
`IAG_Star` Wert: 0xf004 Der Stern muss genau fünf Punkte aufweisen und mit einem einzelnen Strich ohne Heben des Stifts gezeichnet werden.
`IAG_Check` Wert: 0xf005 Der aufwärts zeigende Strich muss doppelt so lang wie der kleinere, abwärts zeigende Strich sein.
`IAG_Curlicue` Wert: 0xf010 Starten Sie die Curlicue für die Freihand, für die Sie Maßnahmen ergreifen möchten.
`IAG_DoubleCurlicue` Wert: 0xf011 Starten Sie die Doppelkurzung für die Freihand, für die Sie Maßnahmen ergreifen möchten.
`IAG_Circle` Wert: 0xf020 Der Kreis muss mit einem einzelnen Strich ohne Heben des Stifts gezeichnet werden.
`IAG_DoubleCircle` Wert: 0xf021 Die beiden Kreise müssen sich überschneiden und mit einem einzelnen Strich ohne Heben des Stifts gezeichnet werden.
`IAG_SemiCircleLeft` Wert: 0xf028 Der Halbkreis muss von links nach rechts gezeichnet werden. Horizontal sollten die beiden Enden des Halbkreises so gleichmäßig wie möglich sein.
`IAG_SemiCircleRight` Wert: 0xf029 Der Halbkreis muss von rechts nach links gezeichnet werden. Horizontal sollten die beiden Enden des Halbkreises so gleichmäßig wie möglich sein.
`IAG_ChevronUp` Wert: 0xf030 Beide Seiten des Chevrons müssen so identisch wie möglich gezeichnet werden. Der Winkel muss klein sein und in einem Punkt enden.
`IAG_ChevronDown` Wert: 0xf031 Beide Seiten des Chevrons müssen so identisch wie möglich gezeichnet werden. Der Winkel muss klein sein und in einem Punkt enden.
`IAG_ChevronLeft` Wert: 0xf032 Beide Seiten des Chevrons müssen so identisch wie möglich gezeichnet werden. Der Winkel muss klein sein und in einem Punkt enden.
`IAG_ChevronRight` Wert: 0xf033 Beide Seiten des Chevrons müssen so identisch wie möglich gezeichnet werden. Der Winkel muss klein sein und in einem Punkt enden.
`IAG_ArrowUp` Wert: 0xf038 Der Pfeil kann mit einem Strich oder in zwei Strichen gezeichnet werden, bei denen ein Strich die Linie und der andere der Pfeilkopf ist. Verwenden Sie nicht mehr als zwei Striche, um den Pfeil zu zeichnen.
`IAG_ArrowDown` Wert: 0xf039 Der Pfeil kann in einem einzigen Strich oder in zwei Strichen gezeichnet werden, bei denen ein Strich die Linie und der andere der Pfeilkopf ist. Verwenden Sie nicht mehr als zwei Striche, um den Pfeil zu zeichnen.
`IAG_ArrowLeft` Wert: 0xf03a Der Pfeil kann in einem einzigen Strich oder in zwei Strichen gezeichnet werden, bei denen ein Strich die Linie und der andere der Pfeilkopf ist. Verwenden Sie nicht mehr als zwei Striche, um den Pfeil zu zeichnen.
`IAG_ArrowRight` Wert: 0xf03b Der Pfeil kann in einem einzigen Strich oder in zwei Strichen gezeichnet werden, bei denen ein Strich die Linie und der andere der Pfeilkopf ist. Verwenden Sie nicht mehr als zwei Striche, um den Pfeil zu zeichnen.
`IAG_Up` Wert: 0xf058 Diese Stiftbewegung muss als einzelner schneller Strich nach oben gezeichnet werden. Diese Geste wird von Flicks Gestures verwendet.
`IAG_Down` Wert: 0xf059 Diese Stiftbewegung muss als einzelner schneller Strich nach unten gezeichnet werden. Diese Geste wird von Flicks Gestures verwendet.
`IAG_Left` Wert: 0xf05a Diese Stiftbewegung muss als einzelner schneller Strich nach links gezeichnet werden. Diese Geste wird von Flicks Gestures verwendet.
`IAG_Right` Wert: 0xf05b Diese Stiftbewegung muss als einzelner schneller Strich nach rechts gezeichnet werden. Diese Geste wird von Flicks Gestures verwendet.
`IAG_UpDown` Wert: 0xf060 Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem aufwärts zeigenden Strich begonnen wird. Die beiden Striche müssen so dicht wie möglich beieinander liegen.
`IAG_DownUp` Wert: 0xf061 Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem abwärts zeigenden Strich begonnen wird. Die beiden Striche müssen so dicht wie möglich beieinander liegen.
`IAG_LeftRight` Wert: 0xf062 Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem linken Strich begonnen wird. Die beiden Striche müssen so dicht wie möglich beieinander liegen.
`IAG_RightLeft` Wert: 0xf063 Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem rechten Strich begonnen wird. Die beiden Striche müssen so dicht wie möglich beieinander liegen.
`IAG_UpLeftLong` Wert: 0xf064 Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem aufwärts zeigenden Strich begonnen wird. Der linke Strich muss ungefähr doppelt so lang wie der aufwärts zeigende Strich sein, und die beiden Striche müssen im rechten Winkel zueinander stehen.
`IAG_UpRightLong` Wert: 0xf065 Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem aufwärts zeigenden Strich begonnen wird. Der rechte Strich muss ungefähr doppelt so lang wie der aufwärts zeigende Strich sein, und die beiden Striche müssen im rechten Winkel zueinander stehen.
`IAG_DownLeftLong` Wert: 0xf066 Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem abwärts zeigenden Strich begonnen wird. Der linke Strich ist ungefähr doppelt so lang wie der aufwärts zeigende Strich, und die beiden Striche müssen im rechten Winkel zueinander stehen.
`IAG_DownRightLong` Wert: 0xf067 Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem abwärts zeigenden Strich begonnen wird. Der rechte Strich muss ungefähr doppelt so lang wie der aufwärts zeigende Strich sein, und die beiden Striche müssen im rechten Winkel zueinander stehen.
`IAG_UpLeft` Wert: 0xf068 Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem aufwärts zeigenden Strich begonnen wird. Die beiden Seiten müssen möglichst gleich lang sein und im rechten Winkel zueinander stehen.
`IAG_UpRight` Wert: 0xf069 Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem aufwärts zeigenden Strich begonnen wird. Die beiden Seiten müssen möglichst gleich lang sein und im rechten Winkel zueinander stehen.
`IAG_DownLeft` Wert: 0xf06a Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem abwärts zeigenden Strich begonnen wird. Die beiden Seiten müssen möglichst gleich lang sein und im rechten Winkel zueinander stehen.
`IAG_DownRight` Wert: 0xf06b Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem abwärts zeigenden Strich begonnen wird. Die beiden Seiten müssen möglichst gleich lang sein und im rechten Winkel zueinander stehen.
`IAG_LeftUp` Wert: 0xf06c Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem linken Strich begonnen wird. Die beiden Seiten müssen möglichst gleich lang sein und im rechten Winkel zueinander stehen.
`IAG_LeftDown` Wert: 0xf06d Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem linken Strich begonnen wird. Die beiden Seiten sind möglichst gleich lang und stehen im rechten Winkel zueinander.
`IAG_RightUp` Wert: 0xf06e Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem rechten Strich begonnen wird. Die beiden Seiten müssen möglichst gleich lang sein und im rechten Winkel zueinander stehen.
`IAG_RightDown` Wert: 0xf06f Diese Stiftbewegung muss in einem einzelnen Strich gezeichnet werden, wobei mit dem rechten Strich begonnen wird. Die beiden Seiten müssen möglichst gleich lang sein und im rechten Winkel zueinander stehen.
`IAG_Exclamation` Wert: 0xf0a4 Die Linie muss zuerst gezeichnet werden. Anschließend wird der Punkt schnell und so dicht wie möglich an der Linie gezeichnet.
`IAG_Tap` Wert: 0xf0f0 Ein Mausklick. Tippen Sie schnell, um die geringste Menge an Gleiten über die Digitalisiereroberfläche zu verwenden.
`IAG_DoubleTap` Wert: 0xf0f1 Doppelklicken Sie mit der Maus. Tippen Sie schnell und so nah am gleichen Ort, um die besten Ergebnisse zu erzielen.

Hinweise

Der Standardwert ist NoGesture. Dabei handelt es sich tatsächlich um eine Trennlinie, die die empfohlene Mindestsicherheit der Microsoft-Gestenerkennung darstellt. Es stellt eigentlich keine Geste oder einen Mangel an Geste dar, nur der Punkt, an dem die Gestenerkennung nicht genügend Vertrauen in die Ergebnisgenauigkeit hat, um alles zu empfehlen, was nach diesem Punkt folgt.

Angenommen, ein Gestenarray besteht aus den folgenden Werten: Circle, LeftRight, NoGesture, RightLeft und Triangle. In diesem Fall hat die Gestenerkennung ein hohes Maß an Vertrauen in Circle und weniger Vertrauen in LeftRight. Die Erkennung hat ein sehr geringes Vertrauen in RightLeft und Triangle , da sie nach NoGesture in der Arrayreihenfolge kommen.

Die Konfidenzstufe, bei der die Gestenerkennung NoGesture zurückgibt, kann nicht geändert werden.

Wenn NoGesture das erste Element im Array ist (was bedeutet, dass jede erkannte Geste unter dem vorgeschlagenen Konfidenzschwellenwert liegt), ändert die Plattform den Standardwert des Cancel-Parameters im Gestenereignishandler von FALSE in TRUE. Dadurch wird die Freihandeingabe als Strich betrachtet und nicht standardmäßig aus dem InkDisp-Objekt gelöscht.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Kopfzeile	msinkaut.h