InkCollectorCursorButtonUpEventHandler 委托

项目
11/04/2008

表示处理 InkCollector 对象的 CursorButtonUp 事件的方法。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
Public Delegate Sub InkCollectorCursorButtonUpEventHandler ( _
    sender As Object, _
    e As InkCollectorCursorButtonUpEventArgs _
)
用法
Dim instance As New InkCollectorCursorButtonUpEventHandler(AddressOf HandlerMethod)

public delegate void InkCollectorCursorButtonUpEventHandler(
    Object sender,
    InkCollectorCursorButtonUpEventArgs e
)

public delegate void InkCollectorCursorButtonUpEventHandler(
    Object^ sender, 
    InkCollectorCursorButtonUpEventArgs^ e
)

/** @delegate */
public delegate void InkCollectorCursorButtonUpEventHandler(
    Object sender,
    InkCollectorCursorButtonUpEventArgs e
)

JScript 不支持委托。

参数

sender
类型：System.Object
此事件的源 InkCollector 对象。

e
类型：Microsoft.Ink.InkCollectorCursorButtonUpEventArgs
包含事件数据的 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;
    }
}