GestureRecognizer.EnableGestures-Methode

Artikel
11/26/2008

Legt einen Wert fest, der angibt, ob das GestureRecognizer-Objekt Interesse an einer bekannten Anwendungsstiftbewegung hat.

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

Syntax

'Declaration
Public Sub EnableGestures ( _
    gestures As ApplicationGesture() _
)
'Usage
Dim instance As GestureRecognizer
Dim gestures As ApplicationGesture()

instance.EnableGestures(gestures)

public void EnableGestures(
    ApplicationGesture[] gestures
)

public:
void EnableGestures(
    array<ApplicationGesture>^ gestures
)

public void EnableGestures(
    ApplicationGesture[] gestures
)

public function EnableGestures(
    gestures : ApplicationGesture[]
)

Parameter

gestures
Typ: array<Microsoft.Ink.ApplicationGesture[]
Ein Array der ApplicationGesture-Werte, die Anwendungsstiftbewegungen angeben, an denen das GestureRecognizer-Objekt Interesse hat.

Hinweise

Eine ArgumentException wird ausgelöst, wenn Sie AllGestures in Verbindung mit anderen Stiftbewegungen zu aktivieren versuchen.

Beispiele

Dieses C#-Beispiel ist ein Ausschnitt aus dem Load-Ereignishandler eines Formulars. In ihm werden ein GestureRecognizer-Objekt, ein DynamicRenderer-Objekt und zwei RealTimeStylus-Objekte erstellt. Die Objekte werden in einem kaskadierenden RealTimeStylus-Modell angefügt, und über den RealTimeStylus werden dynamisches Rendering, dynamische Stiftbewegungserkennung und dynamische Tablettstiftdatenerfassung aktiviert. Das GestureRecognizer-Objekt wird so festgelegt, dass Stiftbewegungen in einem einzelnen Strich und nur die Right, ChevronRight und ArrowRight Anwendungsstiftbewegungen erkannt werden. Die WindowInputRectangle-Eigenschaft des primären RealTimeStylus-Objekts ist explizit auf die Verwendung des gesamten Steuerelements festgelegt, an das das RealTimeStylus-Objekt angefügt ist. Das Formular selbst implementiert die IStylusAsyncPlugin-Schnittstelle, und es wird an das RealTimeStylus-Objekt angefügt.

using Microsoft.Ink;
using Microsoft.StylusInput;
using Microsoft.StylusInput.PluginData;

// ...

// The panel where the tablet pen data is collected.
private System.Windows.Forms.Panel thePanel;

// Declare the RealTimeStylus objects, the GestureRecognizer plugin,
// and the DynamicRenderer plug-in.
private Microsoft.StylusInput.RealTimeStylus thePrimaryRealTimeStylus = null;
private Microsoft.StylusInput.RealTimeStylus theSecondaryRealTimeStylus = null;
private Microsoft.StylusInput.GestureRecognizer theGestureRecognizer = null;
private Microsoft.StylusInput.DynamicRenderer theDynamicRenderer = null;

// The form's Load event handler.
private void theForm_Load(object sender, System.EventArgs e)
{
    // ...

    // Create a DynamicRenderer attached to the drawing area ,
    // and enable dynamic rendering.
    this.theDynamicRenderer = new DynamicRenderer(this.thePanel);
    this.theDynamicRenderer.Enabled = true;

    // Create a GestureRecognizer, and set it to recognize single-stroke gestures.
    this.theGestureRecognizer = new GestureRecognizer();
    this.theGestureRecognizer.MaxStrokeCount = 1;

    // Allow gesture recognition for specific gestures.
    this.theGestureRecognizer.EnableGestures( new ApplicationGesture[]
        {
            ApplicationGesture.Right,
            ApplicationGesture.ChevronRight,
            ApplicationGesture.ArrowRight
        } );

    // Enable gesture recognition.
    this.theGestureRecognizer.Enabled = true;

    // Create the primary and secondary RealTimeStylus objects.
    this.thePrimaryRealTimeStylus = new RealTimeStylus(this.thePanel);
    this.theSecondaryRealTimeStylus = new RealTimeStylus();

    // Add the secondary RealTimeStylus to the primary's asynchronous plug-in collection.
    this.thePrimaryRealTimeStylus.AsyncPluginCollection.Add(
        this.theSecondaryRealTimeStylus);

    // Add the dynamic renderer to the primary's synchronous plug-in collection.
    this.thePrimaryRealTimeStylus.SyncPluginCollection.Add(this.theDynamicRenderer);

    // Add the gesture recognizer to the secondary's synchronous plug-in collection.
    this.theSecondaryRealTimeStylus.SyncPluginCollection.Add(this.theGestureRecognizer);

    // Add the form to the secondary's asynchronous plug-in colleciton.
    this.theSecondaryRealTimeStylus.AsyncPluginCollection.Add(this);

    // Set the input rectangle to the entire panel for the RealTimeStylus.
    this.thePrimaryRealTimeStylus.WindowInputRectangle = new Rectangle(0,0,0,0);

    // Enable the RealTimeStylus, which allows notifications to flow to the plug-ins.
    this.thePrimaryRealTimeStylus.Enabled = true;

    // ...
}

Plattformen

Windows Vista, Windows XP SP2, Windows Server 2003

.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.