InkCollectorCursorOutOfRangeEventHandler デリゲート

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

InkCollector オブジェクトの CursorOutOfRange イベントを処理するメソッドを表します。

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

構文

'宣言
Public Delegate Sub InkCollectorCursorOutOfRangeEventHandler ( _
    sender As Object, _
    e As InkCollectorCursorOutOfRangeEventArgs _
)
'使用
Dim instance As New InkCollectorCursorOutOfRangeEventHandler(AddressOf HandlerMethod)

public delegate void InkCollectorCursorOutOfRangeEventHandler(
    Object sender,
    InkCollectorCursorOutOfRangeEventArgs e
)

public delegate void InkCollectorCursorOutOfRangeEventHandler(
    Object^ sender, 
    InkCollectorCursorOutOfRangeEventArgs^ e
)

/** @delegate */
public delegate void InkCollectorCursorOutOfRangeEventHandler(
    Object sender,
    InkCollectorCursorOutOfRangeEventArgs e
)

JScript では、デリゲートは使用できません。

パラメータ

sender
型 : System.Object
このイベントのソース InkCollector オブジェクト。

e
型 : Microsoft.Ink.InkCollectorCursorOutOfRangeEventArgs
イベントデータを格納している InkCollectorCursorOutOfRangeEventArgs オブジェクト。

解説

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

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

例

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

Private Sub mInkObject_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
            panelInkCanvas.Invalidate()
        End If
    End Using
End Sub

private void mInkObject_CursorOutOfRange(object sender, InkCollectorCursorOutOfRangeEventArgs e)
{
    using (Strokes S = mInkObject.Ink.Strokes)
    {
        if (S.Count > 0)
        {
            S[S.Count - 1].DrawingAttributes.Color = Color.Tomato;
            // redraw the ink canvas
            panelInkCanvas.Invalidate();
        }
    }
}