InkOverlay.MouseWheel イベント

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

InkOverlay オブジェクトにフォーカスがあるときにユーザーがマウスホイールを動かすと発生します。

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

構文

'宣言
Public Event MouseWheel As InkCollectorMouseWheelEventHandler
'使用
Dim instance As InkOverlay
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 単位ではありません。これは、このイベントがペンの動きを認識しないアプリケーションの関連するマウスイベントを置き換えて、その種類のアプリケーションがピクセル単位で描かれるからです。

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();
        }
    }
}