Freigeben über

CollectionMode-Enumeration

  • Artikel

Definiert Werte, die festlegen, ob Freihandeingaben, Stiftbewegungen oder beide erkannt werden, während der Benutzer schreibt.

Namespace:  Microsoft.Ink
Assembly:  Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Enumeration CollectionMode
'Usage
Dim instance As CollectionMode

public enum CollectionMode

public enum class CollectionMode

public enum CollectionMode

public enum CollectionMode

Member

Membername Beschreibung
InkOnly Erfasst nur Freihandeingaben und erstellt einen Strich. Das Interesse an InkCollector.Gesture, InkOverlay.Gesture-Ereignissen oder InkPicture.Gesture-Ereignissen wird auf false festgelegt, was bedeutet, dass Stiftbewegungen nicht erfasst werden (alle anderen Ereignisinteressen bleiben unverändert).
GestureOnly Erfasst nur Stiftbewegungen und erstellt keinen Strich. Stiftbewegungen können aus einem einzigen Strich oder aus mehreren Strichen bestehen. Stiftbewegungen mit mehreren Strichen sind zulässig, wenn die Striche innerhalb der Zeitspanne gemacht werden, die vom integrierten Zeitgeber des Erkennungsmoduls festgelegt wird. Alle strichbezogenen und paketbezogenen Ereignisse werden nicht vom InkCollector-Objekt, InkOverlay-Objekt oder InkPicture-Steuerelement ausgelöst. Cursorereignisse werden ausgelöst, und Freihandeingaben werden immer gelöscht. Das Interesse an InkCollector.Gesture, InkOverlay.Gesture-Ereignissen oder InkPicture.Gesture-Ereignissen wird auf true festgelegt, was bedeutet, dass Stiftbewegungen erfasst werden (alle anderen Ereignisinteressen bleiben unverändert).
InkAndGesture Es werden nur Stiftbewegungen in einem einzelnen Strich akzeptiert. Das InkCollector.Gesture-Ereignis, InkOverlay.Gesture-Ereignis oder InkPicture.Gesture-Ereignis wird als Erstes ausgelöst, und Sie haben die Möglichkeit, das Ereignis abzubrechen oder zu akzeptieren. Standardmäßig wird das Ereignis akzeptiert, außer wenn der NoGesture-Wert von ApplicationGesture die primäre Stiftbewegung ist. Wenn die Stiftbewegung akzeptiert wird, werden die Freihandeingaben gelöscht. Wenn die Stiftbewegung abgebrochen wird, wird der Strich nicht gelöscht und ein InkCollector.Stroke-Ereignis, InkOverlay.Stroke-Ereignis oder InkPicture.Stroke-Ereignis wird ausgelöst. Das Interesse an InkCollector.Gesture, InkOverlay.Gesture-Ereignissen oder InkPicture.Gesture-Ereignissen wird auf true festgelegt, was bedeutet, dass Stiftbewegungen erfasst werden (alle anderen Ereignisinteressen bleiben unverändert).

Hinweise

Wenn ein Benutzer mit der rechten Maustaste und den Stift im InkOnly-Modus oder im InkAndGesture-Modus bewegt, fließen Freihandeingaben aus der Stiftspitze. Wenn das InkCollector.Stroke, InkOverlay.Stroke-Ereignis oder das InkPicture.Stroke-Ereignis behandelt wird, löschen Sie die Freihandeingaben, die als Ergebnis der Stiftbewegung herausgeflossen ist.

Wenn die InkCollector.CollectionMode-Eigenschaft, die InkOverlay.CollectionMode-Eigenschaft oder die InkPicture.CollectionMode-Eigenschaft auf GestureOnly festgelegt ist, ist das Timeout zwischen dem Zeitpunkt, an dem ein Benutzer eine Stiftbewegung hinzufügt, und dem Zeitpunkt, an dem das InkCollector.Gesture-Ereignis, das InkOverlay.Gesture-Ereignis oder das InkPicture.Gesture-Ereignis eintritt, ein fester Wert, der nicht programmgesteuert geändert werden kann. Die Stiftbewegungserkennung ist im InkAndGesture-Modus schneller. Sie können folgendermaßen vorgehen, um die Freihandauflistung im InkAndGesture-Modus zu verhindern:

Wenn diese Enumeration mit dem InkPicture-Steuerelement, dem InkCollector-Objekt oder dem InkOverlay-Objekt verwendet wird, kann der Modus eines Systems, auf dem das Microsoft® Windows® XP Tablet PC Edition Software Development Kit (SDK), jedoch kein Erkennungsmodul installiert ist, nicht auf GestureOnly oder InkAndGesture festgelegt werden.

Typische Szenarien werden nachfolgend für jeden Auflistungsmodus beschrieben.

Hinweis

Wenn der Cursor zwischen Strichen nicht den Gültigkeitsbereich des Auflistungsobjekts verlässt, werden die Ereignisse für den Cursor außerhalb des Gültigkeitsbereichs und innerhalb des Gültigkeitsbereichs nicht ausgelöst.

Wenn die InkCollector.CollectionMode, InkOverlay.CollectionMode-Eigenschaft oder die InkPicture.CollectionMode-Eigenschaft auf festgelegt ist und das Interesse eines Objekts oder eines Steuerelements für eine bekannte Stiftbewegung festgelegt wird (durch Aufrufen der InkCollector.SetGestureStatus, InkOverlay.SetGestureStatus-Methode oder der InkPicture.SetGestureStatus-Methode), kann es zu unerwartetem Verhalten kommen. Wenn ein Benutzer eine Freihandeingabe zeichnet, die einer Stiftbewegung aus der Alternativenliste des Erkennungsmoduls ähnelt, wird das Gesture-Ereignis ausgelöst und die Freihandeingabe gelöscht, selbst wenn es sich bei der Stiftbewegung nicht um die erste Alternative handelt. Legen Sie die geerbte Cancel-Eigenschaft von InkCollectorGestureEventArgs auf true fest, wenn das Erkennungsmodul nicht auf das Ereignis reagieren soll. So wird verhindert, dass eine Freihandeingabe gelöscht und die Erfassung der Stiftbewegung abgebrochen wird.

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0

Siehe auch

Referenz

Microsoft.Ink-Namespace

InkCollector.CollectionMode

InkOverlay.CollectionMode

InkPicture.CollectionMode