InkCollectorCursorButtonDownEventHandler (Delegado)

Artículo
11/26/2008

Actualización: noviembre 2007

Representa el método que controla el evento CursorButtonDown de un objeto InkCollector.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Delegate Sub InkCollectorCursorButtonDownEventHandler ( _
    sender As Object, _
    e As InkCollectorCursorButtonDownEventArgs _
)
'Uso
Dim instance As New InkCollectorCursorButtonDownEventHandler(AddressOf HandlerMethod)

public delegate void InkCollectorCursorButtonDownEventHandler(
    Object sender,
    InkCollectorCursorButtonDownEventArgs e
)

public delegate void InkCollectorCursorButtonDownEventHandler(
    Object^ sender, 
    InkCollectorCursorButtonDownEventArgs^ e
)

/** @delegate */
public delegate void InkCollectorCursorButtonDownEventHandler(
    Object sender,
    InkCollectorCursorButtonDownEventArgs e
)

JScript no admite delegados.

Parámetros

sender
Tipo: System.Object
Objeto InkCollector de origen de este evento.

e
Tipo: Microsoft.Ink.InkCollectorCursorButtonDownEventArgs
Objeto InkCollectorCursorButtonDownEventArgs que contiene los datos del evento.

Comentarios

Un botón de la punta de una pluma está presionado cuando el usuario sitúa la pluma sobre el digitalizador y comienza a dibujar un trazo. Un botón de un menú contextual de una pluma está activado cuando está presionado.

Cuando se crea un delegado de InkCollectorCursorButtonDownEventHandler, se identifica el método que controla el evento. Para asociarlo al controlador de eventos, se debe agregar al evento una instancia del delegado. Siempre que se produce el evento, se llama a su controlador, a menos que se quite el delegado. Para mejorar el rendimiento, el interés del evento predeterminado está desactivado, pero se activa automáticamente en el código administrado si se agrega un controlador de eventos.

Al presionar el botón secundario del mouse, se reciben dos eventos CursorButtonDown: uno para el botón secundario presionado y otro para el botón primario presionado.

Ejemplos

En el ejemplo siguiente se muestra cómo puede suscribirse al evento CursorInRange, al evento CursorButtonDown y al evento CursorButtonUp para que el puntero de la entrada manuscrita (cuando se usa el mouse) aparezca en un color diferente al de la propia entrada manuscrita.

Cuando se desencadena el evento CursorInRange, se realiza una comprobación para evaluar si se trata de la primera vez que el objeto InkCollector ha entrado en contacto con este objeto Cursor específico. En caso afirmativo, a la propiedad DrawingAttributes se le asigna un clon de la propiedad DefaultDrawingAttributes. De este modo, se garantiza que el acceso posterior a la propiedad DrawingAttributes no desencadene una excepción de referencia nula. Si se está utilizando el mouse, el color de la entrada manuscrita se establece en rojo.

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;
        }
    }
}

Cuando se activa el evento CursorButtonDown, se realiza una comprobación para evaluar si el objeto Cursor proporcionado al evento es el mouse. En caso afirmativo, la propiedad Color() se establece en el color azul.

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;
    }

}

Cuando se activa el evento CursorButtonUp, se realiza una comprobación para evaluar si el objeto Cursor proporcionado al evento es el mouse. En caso afirmativo, la propiedad Color() se establece de nuevo en el color rojo.

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;
    }
}

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.