InkCollectionMode-Enumeration (msinkaut.h)

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:

• Legen Sie CollectionMode auf InkAndGesture fest.
• Löschen Sie im Stroke-Ereignis den Strich.
• Verarbeiten Sie im Gestenereignis die Geste.
• Legen Sie DynamicRendering auf FALSE fest.

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.

• InkOnly:
  1. CursorInRange-Ereignis wird ausgelöst.
  2. Das NewInAirPackets-Ereignis wird ausgelöst.
  3. CursorDown-Ereignis wird ausgelöst.
  4. Das NewPackets-Ereignis wird ausgelöst.
  5. Das IInkStrokeDisp-Objekt wird erstellt.
  6. CursorOutOfRange-Ereignis wird ausgelöst.
  Hinweis Möglicherweise möchten Sie das CursorOutOfRange-Ereignis nicht immer auslösen. Wenn Sie das Zeichnen von Freihand fortsetzen möchten, können Sie zu den Ereignissen NewInAirPackets oder CursorDown zurückkehren, nachdem ein Strich abgeschlossen wurde.
   
• GestureOnly:
  1. CursorInRange-Ereignis wird ausgelöst.
  2. Das NewInAirPackets-Ereignis wird ausgelöst.
  3. CursorDown-Ereignis wird ausgelöst.
  4. Das NewPackets-Ereignis wird ausgelöst.
  5. Entweder wird ein IInkGesture-Objekt erstellt, oder, wenn die Cursorbewegung keine Geste darstellt, geschieht nichts.
  6. CursorOutOfRange-Ereignis wird ausgelöst.
  Hinweis In diesem Modus werden Gesten mit einem oder mehreren Strichen akzeptiert.
   
• InkAndGesture:
  1. CursorInRange-Ereignis wird ausgelöst.
  2. Das NewInAirPackets-Ereignis wird ausgelöst.
  3. CursorDown-Ereignis wird ausgelöst.
  4. Das NewPackets-Ereignis wird ausgelöst.
  5. Es wird entweder ein IInkGesture-Objekt oder ein IInkStrokeDisp-Objekt erstellt.
  6. CursorOutOfRange-Ereignis wird ausgelöst.
  Hinweis In diesem Modus werden nur Gesten mit einem Strich akzeptiert.
   

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