InkCollector.CursorButtonDown 事件

發行項
10/29/2008

會在 InkCollector 物件偵測到 CursorButton 物件已按下時發生。

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

語法

'宣告
Public Event CursorButtonDown As InkCollectorCursorButtonDownEventHandler
'用途
Dim instance As InkCollector
Dim handler As InkCollectorCursorButtonDownEventHandler

AddHandler instance.CursorButtonDown, handler

public event InkCollectorCursorButtonDownEventHandler CursorButtonDown

public:
 event InkCollectorCursorButtonDownEventHandler^ CursorButtonDown {
    void add (InkCollectorCursorButtonDownEventHandler^ value);
    void remove (InkCollectorCursorButtonDownEventHandler^ value);
}

/** @event */
public void add_CursorButtonDown (InkCollectorCursorButtonDownEventHandler value)
/** @event */
public void remove_CursorButtonDown (InkCollectorCursorButtonDownEventHandler value)

JScript 不支援事件。

備註

當使用者將畫筆接近「數位板」並開始描繪筆劃時，筆尖上的按鈕是按下的。按下筆桿上的按鈕時，按鈕會處於按下狀態。

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

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

在按滑鼠右鍵時，實際上會接收兩個 CursorButtonDown 事件，一是滑鼠右鍵按下的事件，二是滑鼠左鍵按下的事件。

範例

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

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