GestureRecognizer.EnableGestures メソッド

[アーティクル]
10/28/2008

GestureRecognizer オブジェクトが既知のアプリケーションジェスチャを対象とするかどうかを示す値を設定します。

名前空間 : Microsoft.StylusInput
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public Sub EnableGestures ( _
    gestures As ApplicationGesture() _
)
'使用
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[]
)

パラメータ

gestures
型 : array<Microsoft.Ink.ApplicationGesture[]
ApplicationGesture 値の配列。GestureRecognizer オブジェクトが対象とするアプリケーションジェスチャを示します。

解説

他のジェスチャと組み合わせて AllGestures を有効にしようとすると、ArgumentException がスローされます。

例

この C# の例は、フォームの Load イベントハンドラのスニペットです。これにより、GestureRecognizer、DynamicRenderer、および 2 つの RealTimeStylus オブジェクトを作成し、それらオブジェクトを重なった RealTimeStylus モデルとしてアタッチして、RealTimeStylus を介して動的レンダリング、ジェスチャ認識、およびタブレットペンデータの収集を有効にします。GestureRecognizer オブジェクトは、単一ストロークのジェスチャを認識し、Right、ChevronRight、および ArrowRight アプリケーションジェスチャだけを認識するように設定されます。プライマリ RealTimeStylus オブジェクトの WindowInputRectangle プロパティは、RealTimeStylus オブジェクトがアタッチされたコントロール全体を使用するように明示的に設定されます。フォーム自体が IStylusAsyncPlugin インターフェイスを実装し、RealTimeStylus オブジェクトにアタッチされます。

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;

    // ...
}