IInkOverlay::get_CollectionMode-Methode (msinkaut.h)

Artikel
08/24/2023

Ruft den Auflistungsmodus ab, der bestimmt, ob Freihand, Geste oder beides beim Schreiben des Benutzers erkannt werden, oder legt diesen fest.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_CollectionMode(
  InkCollectionMode *Mode
);

Parameter

Mode

Rückgabewert

Keine

Bemerkungen

Eine Liste der Modi, die Sie verwenden können, finden Sie im Enumerationstyp InkCollectionMode . Wenn Sie jedoch die CollectionMode-Eigenschaft auf einem System verwenden, auf dem Microsoft Windows vorhanden ist? XP Tablet PC Edition Software Development Kit (SDK) installiert, aber die Erkennung ist nicht installiert. Der Modus kann nicht auf Gestenonly oder InkAndGesture festgelegt werden.

Hinweis Das InkCollector-Objekt , das InkOverlay-Objekt oder das InkPicture-Steuerelement generiert einen Fehler, wenn Sie versuchen, die CollectionMode-Eigenschaft zu ändern, während Freihand erfasst wird. Um diesen Konflikt zu vermeiden, überprüfen Sie die CollectingInk-Eigenschaft , bevor Sie die CollectionMode-Eigenschaft ändern.

Für jeden CollectionMode-Wert treten die folgenden Verhaltensweisen auf:

InkOnly-Modus

Es wird nur Freihand gesammelt. Gesten sind nicht vorhanden.
Das Gestenereignisinteresse ist auf FALSE festgelegt (alle anderen Ereignisinteressen bleiben unverändert).

Gesteonly-Modus

Es werden nur Gesten gesammelt. Freihand ist nicht. Die Striche werden gelöscht, nachdem sie an die Gestenerkennung gesendet wurden.
Das Gestenereignisinteresse ist auf TRUE festgelegt (alle anderen Ereignisinteressen bleiben unverändert).
Der Freihandsammler löst die folgenden Strich- und Paketereignisse nicht aus: Die Ereignisse CursorDown, Stroke, NewPackets und NewInAirPackets .
Cursorereignisse werden ausgelöst.
Freihand wird immer gelöscht.

InkAndGesture-Modus

Sowohl Freihand als auch Gesten werden gesammelt.
Es werden nur Gesten mit einem Strich erkannt.
Das Gestenereignisinteresse ist auf TRUE festgelegt (alle anderen Ereignisinteressen bleiben unverändert).
Das Gestenereignis wird zuerst ausgelöst, sodass Sie die Geste annehmen oder abbrechen können. Um die Geste abzubrechen, legen Sie den Cancel-Parameter auf TRUE fest. Das Abbrechen der Geste zwingt den Freihandsammler, die Freihandeingabe zu sammeln.

Das Ändern des Sammlungsmodus ändert nicht die status einzelner Gesten.

Unerwünschtes Verhalten kann auftreten, wenn CollectionMode auf InkAndGesture festgelegt ist und das Interesse eines Objekts/Steuerelements an einer bekannten Geste festgelegt wird (durch Aufrufen der SetGestureStatus-Methode ). Wenn Sie Freihand zeichnen, die etwa wie die bekannte Geste aussieht und die bekannte Geste in der Liste der Alternativen der Erkennung enthalten ist, wird das Gestenereignis ausgelöst, und die Freihandeingabe verschwindet, auch wenn die Geste nicht die erste Alternative ist. Um zu verhindern, dass die Freihandeingabe verschwindet und die Sammlung der Geste abbricht, legen Sie den Cancel-Parameter auf TRUE fest, wenn es sich bei dem Ereignis um ein Ereignis handelt, an dem Sie kein Interesse haben.

Wenn CollectionMode auf GestureOnly festgelegt ist, 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 die CollectionMode-Eigenschaft auf InkAndGesture fest.
Löschen Sie im Stroke-Ereignis den Strich.
Verarbeiten Sie im Gestenereignis die Geste.
Legen Sie DynamicRendering auf FALSE fest, um den Freihandfluss beim Gestikieren zu verhindern.

Anforderungen


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