InkOverlay.CursorButtonUp 事件

發行項
10/29/2008

會在 InkOverlay 物件偵測到 CursorButton 物件已放開時發生。

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

語法

'宣告
Public Event CursorButtonUp As InkCollectorCursorButtonUpEventHandler
'用途
Dim instance As InkOverlay
Dim handler As InkCollectorCursorButtonUpEventHandler

AddHandler instance.CursorButtonUp, handler

public event InkCollectorCursorButtonUpEventHandler CursorButtonUp

public:
 event InkCollectorCursorButtonUpEventHandler^ CursorButtonUp {
    void add (InkCollectorCursorButtonUpEventHandler^ value);
    void remove (InkCollectorCursorButtonUpEventHandler^ value);
}

/** @event */
public void add_CursorButtonUp (InkCollectorCursorButtonUpEventHandler value)
/** @event */
public void remove_CursorButtonUp (InkCollectorCursorButtonUpEventHandler value)

JScript 不支援事件。

備註

當使用者完成筆劃並將畫筆舉離「數位板」時，筆尖上的按鈕是放開的。未按下筆桿上的按鈕時，按鈕會處於放開狀態。

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

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

在放開滑鼠右鍵時，會接收兩個 CursorButtonUp 事件，一個是滑鼠右鍵放開的事件，一個是滑鼠左鍵放開的事件。

範例

下列範例說明如何訂閱 CursorInRange 事件、CursorButtonDown 事件及 CursorButtonUp 事件，以便使用與筆墨本身不同的色彩顯示筆墨指標 (使用滑鼠進行筆墨書寫時)。

當 CursorInRange 事件引發時，會檢查 InkOverlay 物件是否為第一次與這個特定 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;
        }
    }
}

當 CursorButtonDown 事件引發時，會檢查對事件提供的 Cursor 物件是否為滑鼠。如果是，則會將 Color() 屬性設定為藍色。

Private Sub mInkObject_CursorButtonDown(ByVal sender As Object, ByVal e As InkCollectorCursorButtonDownEventArgs)
    Const MOUSE_CURSOR_ID As Integer = 1
    If (MOUSE_CURSOR_ID = e.Cursor.Id) Then
        e.Cursor.DrawingAttributes.Color = Color.Blue
    End If
End Sub

private void mInkObject_CursorButtonDown(object sender, InkCollectorCursorButtonDownEventArgs e)
{
    const int MOUSE_CURSOR_ID = 1;

    if (MOUSE_CURSOR_ID == e.Cursor.Id)
    {
        e.Cursor.DrawingAttributes.Color = Color.Blue;
    }

}

當 CursorButtonUp 事件引發時，會檢查對事件提供的 Cursor 物件是否為滑鼠。如果是，則會將 Color() 屬性設回紅色。

Private Sub mInkObject_CursorButtonUp(ByVal sender As Object, ByVal e As InkCollectorCursorButtonUpEventArgs)
    Const MOUSE_CURSOR_ID As Integer = 1
    If (MOUSE_CURSOR_ID = e.Cursor.Id) Then
        e.Cursor.DrawingAttributes.Color = Color.Red
    End If
End Sub

private void mInkObject_CursorButtonUp(object sender, InkCollectorCursorButtonUpEventArgs e)
{
    const int MOUSE_CURSOR_ID = 1;

    if (MOUSE_CURSOR_ID == e.Cursor.Id)
    {
        e.Cursor.DrawingAttributes.Color = Color.Red;
    }
}