InkPicture.CursorInRange 事件

發行項
10/29/2008

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

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

語法

'宣告
Public Event CursorInRange As InkCollectorCursorInRangeEventHandler
'用途
Dim instance As InkPicture
Dim handler As InkCollectorCursorInRangeEventHandler

AddHandler instance.CursorInRange, handler

public event InkCollectorCursorInRangeEventHandler CursorInRange

public:
 event InkCollectorCursorInRangeEventHandler^ CursorInRange {
    void add (InkCollectorCursorInRangeEventHandler^ value);
    void remove (InkCollectorCursorInRangeEventHandler^ value);
}

/** @event */
public void add_CursorInRange (InkCollectorCursorInRangeEventHandler value)
/** @event */
public void remove_CursorInRange (InkCollectorCursorInRangeEventHandler value)

JScript 不支援事件。

備註

事件處理常式會接收 InkCollectorCursorInRangeEventArgs 型別的引數，其中包含這個事件的相關資料。

在建立 InkCollectorCursorInRangeEventHandler 委派時，您要識別處理事件的方法。若要使事件與您的事件處理常式產生關聯，請將委派的執行個體加入至事件。除非您移除委派，否則每當事件發生時就會呼叫事件處理常式。基於效能考量，相關事件的預設是關閉的，但會在您加入事件處理常式時自動開啟。

並不僅止於在筆墨模式下，即使是在選取或清除模式下，也會引發 CursorInRange 事件。這會需要您監視編輯模式 (您必須負責其設定)，並且在解譯事件之前注意模式。這個需求的優點是透過覺察平台事件，獲得平台創新的更大自由。

範例

在這個範例中，當 CursorInRange 事件引發時，會檢查 InkPicture 物件是否第一次接觸這個特定 Cursor 物件。如果是，則會將 DefaultDrawingAttributes 屬性的複製品指派給 DrawingAttributes 屬性。這樣可確定後續對 DrawingAttributes 屬性的存取不會擲回 null 參考例外狀況。

Private Sub mInkObject_CursorInRange(ByVal sender As Object, ByVal e As InkCollectorCursorInRangeEventArgs)
    Const MOUSE_CURSOR_ID As Integer = 1
    If e.NewCursor Then
        ' mInkObject can be InkCollector, InkOverlay, or InkPicture
        e.Cursor.DrawingAttributes = mInkObject.DefaultDrawingAttributes.Clone()
        ' if this cursor is the mouse, we'll set color to red
        If (MOUSE_CURSOR_ID = e.Cursor.Id) Then
            e.Cursor.DrawingAttributes.Color = Color.Red
        End If

    End If
End Sub

private void mInkObject_CursorInRange(object sender, InkCollectorCursorInRangeEventArgs e)
{
    const int MOUSE_CURSOR_ID = 1;

    if (e.NewCursor)
    {
        // mInkObject can be InkCollector, InkOverlay, or InkPicture
        e.Cursor.DrawingAttributes = mInkObject.DefaultDrawingAttributes.Clone();
        // if this cursor is the mouse, we'll set color to red
        if (MOUSE_CURSOR_ID == e.Cursor.Id)
        {
            e.Cursor.DrawingAttributes.Color = Color.Red;
        }
    }
}