InkPicture.CursorOutOfRange イベント

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

カーソルがタブレットコンテキストの物理検出領域 (近接) を離れたときに発生します。

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

構文

'宣言
Public Event CursorOutOfRange As InkCollectorCursorOutOfRangeEventHandler
'使用
Dim instance As InkPicture
Dim handler As InkCollectorCursorOutOfRangeEventHandler

AddHandler instance.CursorOutOfRange, handler

public event InkCollectorCursorOutOfRangeEventHandler CursorOutOfRange

public:
 event InkCollectorCursorOutOfRangeEventHandler^ CursorOutOfRange {
    void add (InkCollectorCursorOutOfRangeEventHandler^ value);
    void remove (InkCollectorCursorOutOfRangeEventHandler^ value);
}

/** @event */
public void add_CursorOutOfRange (InkCollectorCursorOutOfRangeEventHandler value)
/** @event */
public void remove_CursorOutOfRange (InkCollectorCursorOutOfRangeEventHandler value)

JScript では、イベントは使用できません。

解説

イベントハンドラは、このイベントについてのデータを格納している InkCollectorCursorOutOfRangeEventArgs 型の引数を受け取ります。

InkCollectorCursorOutOfRangeEventHandler デリゲートを作成する場合は、イベントを処理するメソッドを指定します。イベントをイベントハンドラに関連付けるには、デリゲートのインスタンスをイベントに追加します。デリゲートを削除しない限り、そのイベントが発生すると常にイベントハンドラが呼び出されます。既定のイベント対象は有効です。

CursorOutOfRange イベントは、インクモードの場合のみではなく選択モードまたは消去モードの場合でも発生します。このため、編集モードを監視し (設定が必要)、イベントを解釈する前にモードを認識する必要があります。この要件の利点は、プラットフォームイベントの認識がより容易になることにより、プラットフォーム上での新しい技術の導入がより可能になることです。

例

この例では、CursorOutOfRange イベントが発生するときに、作成される最後のストロークの色が赤に変更されます。

Private Sub mInkPicture_CursorOutOfRange(ByVal sender As Object, ByVal e As InkCollectorCursorOutOfRangeEventArgs)
    Using s As Strokes = mInkObject.Ink.Strokes
        If s.Count > 0 Then
            s(s.Count - 1).DrawingAttributes.Color = Color.Tomato
            ' redraw the ink canvas
            mInkPicture.Invalidate()
        End If
    End Using
End Sub

private void mInkPicture_CursorOutOfRange(object sender, InkCollectorCursorOutOfRangeEventArgs e)
{
    using (Strokes S = mInkObject.Ink.Strokes)
    {
        if (S.Count > 0)
        {
            S[S.Count - 1].DrawingAttributes.Color = Color.Tomato;
            mInkPicture.Invalidate();
        }
    }
}