InkPicture.CursorOutOfRange 事件

项目
10/28/2008

当光标离开 Tablet 上下文 的物理检测范围（邻近）时发生。

命名空间： 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();
        }
    }
}