InkCollector.CursorButtonUp 事件

InkCollector 检测到 CursorButton 对象凸起时发生。

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

语法

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

平台

Windows Vista

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

版本信息

.NET Framework

受以下版本支持:3.0

另请参见

参考

InkCollector 类

InkCollector 成员

Microsoft.Ink 命名空间

Cursor

CursorButton

InkCollector.CursorButtonDown

InkCollector.CursorDown