IInkOverlay::get_CollectionMode-Methode (msinkaut.h)
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.
- Es wird nur Freihand gesammelt. Gesten sind nicht vorhanden.
- Das Gestenereignisinteresse ist auf FALSE festgelegt (alle anderen Ereignisinteressen bleiben unverändert).
- 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.
- 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.
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 |