InkCollector.CursorOutOfRange 事件

發行項
10/29/2008

當游標離開手寫板內容的實體偵測範圍 (鄰近) 時發生。

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

語法

'宣告
Public Event CursorOutOfRange As InkCollectorCursorOutOfRangeEventHandler
'用途
Dim instance As InkCollector
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 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();
        }
    }
}