InkOverlay.CursorButtonDown 事件

InkOverlay 对象检测到凹下的 CursorButton 对象时引发。

命名空间:  Microsoft.Ink
程序集:  Microsoft.Ink(在 Microsoft.Ink.dll 中)

语法

声明
Public Event CursorButtonDown As InkCollectorCursorButtonDownEventHandler
用法
Dim instance As InkOverlay
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 事件激发时,将检查 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;
    }
}

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求

版本信息

.NET Framework

受以下版本支持:3.0

另请参见

参考

InkOverlay 类

InkOverlay 成员

Microsoft.Ink 命名空间

Cursor

CursorButton

InkCollectorCursorButtonDownEventArgs

InkOverlay.CursorButtonUp

InkOverlay.CursorDown