InkCollector.MouseWheel 事件

發行項
10/29/2008

會在使用者於 InkCollector 物件獲得焦點 (Focus) 時移動滑鼠滾輪時發生。

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

語法

'宣告
Public Event MouseWheel As InkCollectorMouseWheelEventHandler
'用途
Dim instance As InkCollector
Dim handler As InkCollectorMouseWheelEventHandler

AddHandler instance.MouseWheel, handler

public event InkCollectorMouseWheelEventHandler MouseWheel

public:
 event InkCollectorMouseWheelEventHandler^ MouseWheel {
    void add (InkCollectorMouseWheelEventHandler^ value);
    void remove (InkCollectorMouseWheelEventHandler^ value);
}

/** @event */
public void add_MouseWheel (InkCollectorMouseWheelEventHandler value)
/** @event */
public void remove_MouseWheel (InkCollectorMouseWheelEventHandler value)

JScript 不支援事件。

備註

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

在建立 InkCollectorMouseDownEventHandler 委派時，您要識別處理事件的方法。若要使事件與您的事件處理常式產生關聯，請將委派的執行個體加入至事件。除非您移除委派，否則每當事件發生時就會呼叫事件處理常式。基於效能考量，相關事件的預設是關閉的，但會在您加入事件處理常式時自動開啟。

若要改善即時筆墨效能，請在使用筆墨書寫時隱藏滑鼠游標。若要執行這項操作，請在 MouseDown 事件處理常式中隱藏滑鼠游標，並且在 MouseUp 事件處理常式中顯示滑鼠游標。

注意事項：
CancelMouseEventArgs 物件的 X 和 Y 屬性使用像素單位，而不使用與筆墨空間相關聯的 HIMETRIC 單位。這是因為這個事件取代了應用程式中非畫筆感知的相關滑鼠事件，而該類型應用程式是以像素描述。

範例

在這個範例中，當 MouseWheel 事件引發時，會依據滑鼠滾輪旋轉量和方向捲動所有筆劃。

Private Sub mInkObject_MouseWheel(ByVal sender As Object, ByVal e As CancelMouseEventArgs)
    Using S As Strokes = mInkObject.Ink.Strokes
        If (S.Count > 0) Then
            S.Move(0, e.Delta)
            panelInkCanvas.Invalidate()
        End If
    End Using
End Sub

private void mInkObject_MouseWheel(object sender, CancelMouseEventArgs e)
{
    using (Strokes S = mInkObject.Ink.Strokes)
    {
        if (S.Count > 0)
        {
            S.Move(0, e.Delta);
            panelInkCanvas.Invalidate();
        }
    }
}