情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。
このトピックはまだ評価されていません - このトピックを評価する

GestureRecognizer Class

ジェスチャおよび操作の認識、イベント リスナー、設定を提供します。

構文


var gestureRecognizer = new Windows.UI.Input.GestureRecognizer();

属性

[MarshalingBehavior(None)]
[Version(0x06020000)]

メンバー

GestureRecognizerクラス には次の種類のメンバーがあります。

コンストラクター

GestureRecognizerクラス にはこれらのコンストラクターがあります。

コンストラクター説明
GestureRecognizer Initializes a new instance of a GestureRecognizer object.

 

イベント

GestureRecognizerクラス にはこれらのイベントがあります。

イベント説明
CrossSliding Occurs when a user performs a slide or swipe gesture (through a single touch contact) within a content area that supports panning along a single axis only. The gesture must occur in a direction that is perpendicular to this panning axis.
Dragging Occurs when a user performs a slide or swipe gesture with a mouse or pen/stylus (single contact).
Holding Occurs when a user performs a press and hold gesture (with a single touch, mouse, or pen/stylus contact).
ManipulationCompleted Occurs when the input points are lifted and all subsequent motion (translation, expansion, or rotation) through inertia has ended.
ManipulationInertiaStarting Occurs when all contact points are lifted during a manipulation and the velocity of the manipulation is significant enough to initiate inertia behavior (translation, expansion, or rotation continue after the input pointers are lifted).
ManipulationStarted Occurs when one or more input points have been initiated and subsequent motion (translation, expansion, or rotation) has begun.
ManipulationUpdated Occurs after one or more input points have been initiated and subsequent motion (translation, expansion, or rotation) is under way.
RightTapped Occurs when the pointer input is interpreted as a right-tap gesture.
Tapped Occurs when the pointer input is interpreted as a tap gesture.

 

メソッド

The GestureRecognizer クラス には次のメソッドがあります。 With C#、Visual Basic、および C++ では、以下からもメソッドが継承されます。Object クラス.

メソッド説明
CanBeDoubleTap Identifies whether a tap can still be interpreted as the second tap of a double tap gesture.
CompleteGesture Causes the gesture recognizer to finalize an interaction.
ProcessDownEvent Processes pointer input and raises the GestureRecognizer events appropriate to a pointer down action for the gestures and manipulations specified by the GestureSettings property.
ProcessInertia Performs inertia calculations and raises the various inertia events.
ProcessMouseWheelEvent Processes pointer input and raises the GestureRecognizer events appropriate to a mouse wheel action for the gestures and manipulations specified by the GestureSettings property.
ProcessMoveEvents Processes pointer input and raises the GestureRecognizer events appropriate to a pointer move action for the gestures and manipulations specified by the GestureSettings property.
ProcessUpEvent Processes pointer input and raises the GestureRecognizer events appropriate to a pointer up action for the gestures and manipulations specified by the GestureSettings property.

 

プロパティ

GestureRecognizerクラス には次のプロパティがあります。

プロパティアクセスの種類説明

AutoProcessInertia

読み取り/書き込みGets or sets a value that indicates whether manipulations during inertia are generated automatically.

CrossSlideExact

読み取り/書き込みGets or sets a value that indicates whether the exact distance from initial contact to end of the cross-slide interaction is reported.By default, a small distance threshold is subtracted from the first position reported by the system for cross-slide interactions. If this flag is set, the distance threshold is not subtracted from the initial position.

CrossSlideHorizontally

読み取り/書き込みGets or sets a value that indicates whether the cross-slide axis is horizontal.

CrossSlideThresholds

読み取り/書き込みGets or sets values that indicate the distance thresholds for a CrossSliding interaction.

GestureSettings

読み取り/書き込みGets or sets a value that indicates the gesture and manipulation settings supported by an application.

InertiaExpansion

読み取り/書き込みGets or sets a value that indicates the relative change in size of an object from the start of inertia to the end of inertia (when resizing, or scaling, is complete).

InertiaExpansionDeceleration

読み取り/書き込みGets or sets a value that indicates the rate of deceleration from the start of inertia to the end of inertia (when the resizing, or expansion, manipulation is complete).

InertiaRotationAngle

読み取り/書き込みGets or sets a value that indicates the final angle of rotation of an object at the end of inertia (when the rotation manipulation is complete).

InertiaRotationDeceleration

読み取り/書き込みGets or sets a value that indicates the rate of deceleration from the start of inertia to the end of inertia (when the rotation manipulation is complete).

InertiaTranslationDeceleration

読み取り/書き込みGets or sets a value that indicates the rate of deceleration from the start of inertia to the end of inertia (when the translation manipulation is complete).

InertiaTranslationDisplacement

読み取り/書き込みGets or sets a value that indicates the relative change in the screen location of an object from the start of inertia to the end of inertia (when the translation manipulation is complete).

IsActive

読み取り専用Gets a value that indicates whether an interaction is being processed.

IsInertial

読み取り専用Gets a value that indicates whether a manipulation is still being processed during inertia (no input points are active).

ManipulationExact

読み取り/書き込みGets or sets a value that indicates whether the exact distance from initial contact to end of the interaction is reported.By default, a small distance threshold is subtracted from the first delta reported by the system. This distance threshold is intended to account for slight movements of the contact when processing a tap gesture. If this flag is set, the distance threshold is not subtracted from the first delta.

MouseWheelParameters

読み取り専用Gets a set of properties that are associated with the wheel button of a mouse device.

PivotCenter

読み取り/書き込みGets or sets the center point for a rotation interaction when single pointer input is detected.

PivotRadius

読み取り/書き込みGets or sets the radius, from the PivotCenter to the pointer input, for a rotation interaction when single pointer input is detected.

ShowGestureFeedback

読み取り/書き込みGets or sets a value that indicates whether visual feedback is displayed during an interaction.

 

Windows Phone 8

この API は実装されていません。呼び出された場合は、例外をスローします。「Windows Phone ランタイム API」を参照してください。

解説

メモ  : このクラスはアジャイルではないため、そのスレッド モデルとマーシャリングの動作を考慮する必要があります。詳細については、「スレッド処理とマーシャリング (C++/CX)」および「Using Windows Runtime objects in a multithreaded environment (.NET) (マルチスレッド環境での Windows ランタイム オブジェクトの使用 (.NET))」を参照してください。

ここで、 さまざまなポインターおよびジェスチャを処理するための入力イベント ハンドラーのコレクションを使って、GestureRecognizer オブジェクトを設定します。

Windows ランタイム イベントのリッスンおよび処理方法の詳細については、「JavaScript での Windows ランタイムの使用」を参照してください。

メモ  イベント ハンドラーの GestureRecognizer オブジェクトの代わりに、イベント オブジェクトの target プロパティまたは currentTarget プロパティを使用します。



// inputManager handles gesture recognition for this sample.
function inputManager(target) {
    // Initialize the gesture recognizer.
    var gr = new Windows.UI.Input.GestureRecognizer();

    // Turn off visual feedback for gestures.
    // Visual feedback for pointer input is still displayed. 
    gr.showGestureFeedback = false;

    // Configure gesture recognizer to process the following:
    // double tap               - start questions and timer.
    // tap                      - move to next question.
    // right tap                - show answer.
    // hold and hold with mouse - start clues.
    gr.gestureSettings =
        Windows.UI.Input.GestureSettings.tap |
        Windows.UI.Input.GestureSettings.doubleTap |
        Windows.UI.Input.GestureSettings.rightTap |
        Windows.UI.Input.GestureSettings.hold |
        Windows.UI.Input.GestureSettings.holdWithMouse;

    // Register event listeners for these gestures.
    gr.addEventListener('tapped', tappedHandler);
    gr.addEventListener("holding", holdingHandler);
    gr.addEventListener("righttapped", rightTappedHandler);

    // Register event listeners for DOM pointer events.
    // The event pointer(s) are passed to the gesture recognizer
    // for further processing.
    target.addEventListener('MSPointerDown', pointerDown, false);
    target.addEventListener('MSPointerMove', pointerMove, false);
    target.addEventListener('MSPointerUp', pointerUp, false);
    target.addEventListener("MSPointerOver", pointerOver, true);
    target.addEventListener("MSPointerOut", pointerOut, true);
}

// Handle the pointer move event.
// The holding gesture is routed through this event.
// If pointer move is not handled, holding will not fire.
function pointerMove(evt) {
   _eventLog.innerText += "pointer move || ";

   // Get intermediate PointerPoints
   var pps = evt.intermediatePoints;

   // Pass the array of PointerPoints to the gesture recognizer.
   gr.processMoveEvents(pps);
};

// The pointer move event must also be handled because the 
// holding gesture is routed through this event.
// If pointer move is not handled, holding will not fire.
// A holding event is fired approximately one second after 
// a pointer down if no subsequent movement is detected.
function holdingHandler(evt) {
    if (evt.holdingState == Windows.UI.Input.HoldingState.started) {
        _eventLog.innerText += "holding || ";
    } else if (evt.holdingState == Windows.UI.Input.HoldingState.completed) {
        _eventLog.innerText += "holding completed || ";
    } else {
        _eventLog.innerText += "holding canceled || ";
    }
}

不要な場合には、イベント ハンドラーを削除し、ジェスチャ レコグナイザーを null に設定します:



gr.removeEventListener('MSPointerDown', pointerDown);
gr = null;


要件

最小限サポートされるクライアント

Windows 8 [Windows ストア アプリのみ]

最小限サポートされるサーバー

Windows Server 2012 [Windows ストア アプリのみ]

最小限サポートされる携帯電話

Windows Phone 8 [実装されていません。"解説" を参照してください]

名前空間

Windows.UI.Input
Windows::UI::Input [C++]

メタデータ

Windows.winmd

参照

参照
Windows.UI.Input クラス
Windows.Devices.Input
Windows.UI.Core
Windows.UI.Input
Windows.UI.Input.Inking
Windows.UI.Xaml.Input
概念
ユーザー操作に対する応答
共通ユーザー操作のためのガイドライン
Developing Windows Store apps (JavaScript and HTML) (Windows ストア アプリの開発 (JavaScript および HTML))
JavaScript での Windows ランタイムの使用
タッチ操作の設計
サンプル (DOM)
HTML のスクロール、パン、およびズームのサンプル
入力: DOM ポインターのイベント処理サンプル
入力: インスタンス化可能なジェスチャのサンプル
サンプル (Windows ストア アプリ API)
入力: デバイス機能のサンプル
入力: インクのサンプル
入力: 操作およびジェスチャ (JavaScript) のサンプル
入力: 簡略化されたインクのサンプル
入力: Windows 8 ジェスチャのサンプル
入力: XAML ユーザー入力イベントのサンプル
XAML のスクロール、パン、およびズームのサンプル
サンプル (DirectX)
DirectX のタッチ入力のサンプル
入力: 操作およびジェスチャ (C++) のサンプル
入力: タッチのヒット テストのサンプル
サンプル (Win32/デスクトップ)
入力ソース特定サンプル
タッチ挿入のサンプル
Win32 タッチのヒットテストのサンプル

 

 

この情報は役に立ちましたか。
(残り 1500 文字)
フィードバックをいただき、ありがとうございました
表示:
© 2014 Microsoft. All rights reserved.