GestureRecognizer 類別

定義

命名空間:

System.Windows.Ink

組件:

PresentationCore.dll

辨識筆跡手勢。

public ref class GestureRecognizer sealed : System::Windows::DependencyObject, IDisposable

public sealed class GestureRecognizer : System.Windows.DependencyObject, IDisposable

type GestureRecognizer = class
    inherit DependencyObject
    interface IDisposable

Public NotInheritable Class GestureRecognizer
Inherits DependencyObject
Implements IDisposable

繼承

Object

DispatcherObject

DependencyObject

GestureRecognizer

實作

IDisposable

範例

以下範例說明如何判斷 a Stroke 是否為 ScratchOut 手勢。

private bool InterpretScratchoutGesture(Stroke stroke)
{
    // Attempt to instantiate a recognizer for scratchout gestures.
    ApplicationGesture[] gestures = { ApplicationGesture.ScratchOut };
    GestureRecognizer recognizer = new GestureRecognizer(gestures);

    if (!recognizer.IsRecognizerAvailable)
        return false;

    // Determine if the stroke was a scratchout gesture.
    StrokeCollection gestureStrokes = new StrokeCollection();
    gestureStrokes.Add(stroke);

    ReadOnlyCollection<GestureRecognitionResult> results = recognizer.Recognize(gestureStrokes);

    if (results.Count == 0)
        return false;

    // Results are returned sorted in order strongest-to-weakest; 
    // we need only analyze the first (strongest) result.
    if (results[0].ApplicationGesture == ApplicationGesture.ScratchOut &&
          results[0].RecognitionConfidence == RecognitionConfidence.Strong)
    {
        // Use the scratchout stroke to perform hit-testing and 
        // erase existing strokes, as necessary.
        return true;
    }
    else
    {
        // Not a gesture: display the stroke normally.
        return false;
    }
}

Private Function InterpretScratchoutGesture(ByVal stroke As Stroke) As Boolean
    ' Attempt to instantiate a recognizer for scratchout gestures.
    Dim gestures() As ApplicationGesture = {ApplicationGesture.ScratchOut}

    Dim recognizer As New GestureRecognizer(gestures)

    If Not recognizer.IsRecognizerAvailable Then
        Return False
    End If

    ' Determine if the stroke was a scratchout gesture.
    Dim gestureStrokes As StrokeCollection = New StrokeCollection()
    gestureStrokes.Add(stroke)

    Dim results As ReadOnlyCollection(Of GestureRecognitionResult)
    results = recognizer.Recognize(gestureStrokes)

    If results.Count = 0 Then
        Return False
    End If

    ' Results are returned sorted in order strongest-to-weakest; 
    ' we need only analyze the first (strongest) result.
    If (results(0).ApplicationGesture = ApplicationGesture.ScratchOut) Then

        ' Use the scratchout stroke to perform hit-testing and 
        ' erase existing strokes, as necessary.
        Return True
    Else
        ' Not a gesture: display the stroke normally.
        Return False
    End If
End Function

備註

A GestureRecognizer 識別出墨水手勢。 你可以設定 GestureRecognizer 辨識全部或部分應用程式手勢。 要設定 以 GestureRecognizer 識別可用手勢的子集，請將陣列傳 ApplicationGesture 給建構子或使用該 SetEnabledGestures 方法。 要判斷 a StrokeCollection 是否包含手勢，請呼叫該 Recognize 方法。

XAML 文字使用

你無法在 XAML 中使用這個類別。

建構函式

名稱	Description
GestureRecognizer()	初始化 GestureRecognizer 類別的新執行個體。
GestureRecognizer(IEnumerable<ApplicationGesture>)	初始化 GestureRecognizer 類別的新執行個體。

屬性

名稱	Description
DependencyObjectType	會取得 DependencyObjectType 包裹此實例 CLR 類型的 。 (繼承來源 DependencyObject)
Dispatcher	了解 Dispatcher 這與此 DispatcherObject 有關。 (繼承來源 DispatcherObject)
IsRecognizerAvailable	會獲得一個布林值，顯示使用者系統是否可用的手勢辨識器。
IsSealed	會獲得一個值，表示該實例目前是否封存（唯讀）。 (繼承來源 DependencyObject)

方法

名稱	Description
CheckAccess()	判斷呼叫執行緒是否能存取此 DispatcherObject。 (繼承來源 DispatcherObject)
ClearValue(DependencyProperty)	清算房產的當地價值。 要清除的屬性由識別 DependencyProperty 碼指定。 (繼承來源 DependencyObject)
ClearValue(DependencyPropertyKey)	清除只讀屬性的局部值。 要清除的屬性由 DependencyPropertyKey指定。 (繼承來源 DependencyObject)
CoerceValue(DependencyProperty)	強制設定指定的依賴性質值。 這是透過在屬性CoerceValueCallback中指定的依賴屬性元資料中，呼叫 的依賴屬性中的任何DependencyObject函式來達成的。 (繼承來源 DependencyObject)
Dispose()	釋放 GestureRecognizer所使用的所有資源。
Equals(Object)	判斷所給的 DependencyObject 是否等同於電流 DependencyObject。 (繼承來源 DependencyObject)
GetEnabledGestures()	能看到他們 GestureRecognizer 認得的手勢。
GetHashCode()	會得到一個 DependencyObject雜湊碼。 (繼承來源 DependencyObject)
GetLocalValueEnumerator()	建立專門的枚舉器，用以判斷哪些相依屬性在局部 DependencyObject設定值。 (繼承來源 DependencyObject)
GetValue(DependencyProperty)	回傳此實例 DependencyObject上依賴屬性的當前有效值。 (繼承來源 DependencyObject)
InvalidateProperty(DependencyProperty)	重新評估指定相依性質的有效值。 (繼承來源 DependencyObject)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	當任何依賴性財產 DependencyObject 的實際價值更新時，該權利會被調用。 變更的具體相依屬性會在事件資料中報告。 (繼承來源 DependencyObject)
ReadLocalValue(DependencyProperty)	回傳依賴屬性的局部值（若存在）。 (繼承來源 DependencyObject)
Recognize(StrokeCollection)	尋找指定的 StrokeCollection手勢。
SetCurrentValue(DependencyProperty, Object)	設定依賴屬性的值，且不改變其值來源。 (繼承來源 DependencyObject)
SetEnabledGestures(IEnumerable<ApplicationGesture>)	設定應用程式 GestureRecognizer 能辨識的手勢。
SetValue(DependencyProperty, Object)	設定依賴屬性的局部值，並由其依賴屬性識別碼指定。 (繼承來源 DependencyObject)
SetValue(DependencyPropertyKey, Object)	設定只讀相依屬性的本地值，該值由 DependencyPropertyKey 相依屬性的識別碼指定。 (繼承來源 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	回傳一個值，指示序列化程序是否應該將所提供的相依屬性的值序列化。 (繼承來源 DependencyObject)
VerifyAccess()	強制呼叫執行緒能存取此 DispatcherObject。 (繼承來源 DispatcherObject)