InkPicture.SystemGesture 事件

會在辨識系統筆勢時發生。

命名空間：  Microsoft.Ink
組件：  Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
Public Event SystemGesture As InkCollectorSystemGestureEventHandler
'用途
Dim instance As InkPicture
Dim handler As InkCollectorSystemGestureEventHandler

AddHandler instance.SystemGesture, handler

public event InkCollectorSystemGestureEventHandler SystemGesture

public:
 event InkCollectorSystemGestureEventHandler^ SystemGesture {
    void add (InkCollectorSystemGestureEventHandler^ value);
    void remove (InkCollectorSystemGestureEventHandler^ value);
}

/** @event */
public void add_SystemGesture (InkCollectorSystemGestureEventHandler value)
/** @event */
public void remove_SystemGesture (InkCollectorSystemGestureEventHandler value)

JScript 不支援事件。

備註

系統筆勢會提供正用於建立筆勢之 Cursor 物件的相關資訊。這些屬性還提供滑鼠事件組合的捷徑，同時也是偵測滑鼠事件的有效方式。

舉例來說，與其接聽一對 MouseUp (英文) 和 MouseDown (英文) 事件，但在這兩者之間卻不會發生任何滑鼠事件，不如接聽 Tap 或 RightTap 系統筆勢。

又如另一個例子，與其接聽 MouseDown (英文) 和 MouseMove (英文) 事件，但卻取得許多 MouseMove (英文) 訊息，還不如只要不需要每個滑鼠位置的 (x, y) 座標時就接聽 Drag 或 RightDrag 系統筆勢，這樣便能只收到一個訊息，而非許多 MouseMove (英文) 訊息。

如需特定的系統筆勢清單，請參閱 SystemGesture 列舉型別。如需系統筆勢的詳細資訊，請參閱Using Gestures和 Command Input on the Tablet PC。

事件處理常式會收到 InkCollectorSystemGestureEventArgs 型別的引數，其中包含這個事件的相關資料。

在建立 InkCollectorSystemGestureEventHandler 委派時，您要識別處理事件的方法。若要使事件與您的事件處理常式產生關聯，請將委派的執行個體加入至事件。除非您移除委派，否則每當事件發生時就會呼叫事件處理常式。

範例

這個範例中的事件處理常式會在狀態列標籤 statusLabelSysGesture 上顯示系統筆勢資訊。

Private Sub Event_OnSystemGesture(ByVal sender As Object, ByVal e As InkCollectorSystemGestureEventArgs)
    Select Case e.Id
        Case SystemGesture.Tap
            Me.statusLabelSysGesture.Text = "Tap"
        Case SystemGesture.DoubleTap
            Me.statusLabelSysGesture.Text = "Double Tap"

    End Select
End Sub

private void Event_OnSystemGesture(object sender, InkCollectorSystemGestureEventArgs e)
{
    switch (e.Id)
    {
        case SystemGesture.Tap:
            this.statusLabelSysGesture.Text = "Tap";
            break;
        case SystemGesture.DoubleTap:
            this.statusLabelSysGesture.Text = "Double Tap";
            break;
    }

}

收集系統筆勢之前，InkPicture 物件 (變數名稱為 mInkPicture) 會先註冊事件處理常式。

' register the SystemGesture event handler
AddHandler mInkPicture.SystemGesture, New InkCollectorSystemGestureEventHandler(AddressOf Event_OnSystemGesture)

// register the SystemGesture event handler
mInkPicture.SystemGesture += new InkCollectorSystemGestureEventHandler(Event_OnSystemGesture);

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱 .NET Framework 系統需求。

版本資訊

.NET Framework

支援版本：3.0

請參閱

參考

InkPicture 類別

InkPicture 成員

Microsoft.Ink 命名空間

Cursor

InkCollectorSystemGestureEventArgs

SystemGesture

其他資源

Using Gestures