InkCollectionMode-Enumeration (msinkaut.h)

  • Artikel

Definiert Werte, die bestimmen, ob Freihand, Gesten oder Freihand- und Gesten beim Schreiben des Benutzers erkannt werden.

Syntax

typedef enum InkCollectionMode {
  ICM_InkOnly = 0,
  ICM_GestureOnly,
  ICM_InkAndGesture
} ;

Konstanten

 
ICM_InkOnly
Wert: 0
Sammelt nur Freihand und erstellt einen Strich.

Das Interesse des Gestenereignisses ist auf FALSE festgelegt, was bedeutet, dass Gesten nicht gesammelt werden (alle anderen Ereignisinteressen bleiben unverändert).
ICM_GestureOnly
Erfasst nur Gesten und erstellt keine Striche. Gesten können entweder ein oder mehrere Striche sein. Gesten mit mehreren Strichen werden akzeptiert, wenn die Striche innerhalb der vom integrierten Timer der Erkennung festgelegten Zeit vorgenommen werden.

Alle Strich- und paketbezogenen Ereignisse werden nicht vom InkCollector ausgelöst. Cursorereignisse werden ausgelöst, und Freihand wird immer gelöscht.

Das Gestenereignisinteresse ist auf TRUE festgelegt, was bedeutet, dass Gesten gesammelt werden (alle anderen Ereignisinteressen bleiben unverändert).
ICM_InkAndGesture
Akzeptiert nur Gesten mit einem Strich. Das Gestenereignis wird zuerst ausgelöst, sodass der Benutzer "CancelTRUE" oder "FALSE" = sagen kann. Der Standardwert ist TRUE, außer wenn NoGesture die primäre Geste ist, wird Cancel standardmäßig auf FALSE festgelegt. Bei TRUE ist die Freihandeingabe eine Geste und wird gelöscht. Wenn FALSE, ist die Geste Freihand, und ein Stroke-Ereignis wird ausgelöst.

Das Gestenereignisinteresse ist auf TRUE festgelegt (alle anderen Ereignisinteressen werden unverändert beibehalten).

Hinweise

Wenn ein Benutzer versucht, mit der rechten Maustaste zu klicken und den Stift im InkOnly- oder InkAndGesture-Modus zu verschieben, wird freihand von der Stiftspitze ausgeführt. Wenn Sie das Stroke-Ereignis behandeln, sollten Sie die Freihand löschen, die infolge der Stiftbewegung fließt.

Wenn InkCollectionMode auf GestureOnly festgelegt ist (über die CollectionMode-Eigenschaft festgelegt), ist das Timeout zwischen dem Hinzufügen einer Geste durch einen Benutzer und dem Auftreten des Gestenereignisses ein fester Wert, der programmgesteuert nicht geändert werden kann. Die Gestenerkennung ist im InkAndGesture-Modus schneller. Um die Sammlung von Freihand im InkAndGesture-Modus zu verhindern, können Sie Folgendes ausführen:

Wenn Sie diese Enumeration mit dem InkPicture-Steuerelement (oder den InkCollector - oder InkOverlay-Objekten ) auf einem System verwenden, auf dem das Microsoft Windows XP Tablet PC Edition Software Development Kit (SDK) installiert ist, aber keine Erkennungen vorhanden sind, kann der Modus nicht auf GestureOnly oder InkAndGesture festgelegt werden.

Der Freihandsammler erstellt immer entweder einen Strich (InkOnly-Modus) oder eine Geste (Geste) und manchmal beides (InkAndGesture-Modus).

Es folgen typische Szenarien für jeden Modus.

Unerwünschtes Verhalten kann auftreten, wenn die CollectionMode-Eigenschaft auf InkAndGesture festgelegt ist und das Interesse eines Objekts oder Steuerelements an einer bekannten Geste festgelegt wird (durch Aufrufen der SetGestureStatus-Methode ). Wenn ein Benutzer Freihandzeichen zeichnet, die einer Geste ähnelt, die sich in der Erkennungsliste der Erkennungs-Alternativen befindet, wird das Gestenereignis ausgelöst und die Freihandeingabe verschwindet, auch wenn die Geste nicht die oberste Alternative ist. Um zu verhindern, dass die Freihandeingabe verschwindet und die Sammlung der Geste abbricht, legen Sie Abbrechen auf TRUE fest, wenn es sich bei dem Ereignis um ein Ereignis handelt, auf das die Erkennung nicht reagieren soll.

Anforderungen

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

Weitere Informationen

CollectionMode-Eigenschaft [InkCollector-Klasse]

Gestenereignis

InkCollector-Klasse

InkOverlay-Klasse

InkPicture-Steuerelementreferenz

Strichereignis