InkCollector.CursorButtonDown 事件

项目
11/04/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 委托时，需要标识将处理该事件的方法。若要将该事件与事件处理程序关联，请将该委托的一个实例添加到事件中。除非移除了该委托，否则每当发生该事件时就会调用此事件处理程序。出于性能方面的原因，默认事件关注处于关闭状态，但如果添加事件处理程序，它将自动打开。

按鼠标右键时，实际上接收到两个 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;
    }
}