InkCollectorCursorInRangeEventHandler-Delegat

Artikel
11/26/2008

Stellt die Methode dar, die das CursorInRange-Ereignis eines InkCollector-Objekts behandelt.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Delegate Sub InkCollectorCursorInRangeEventHandler ( _
    sender As Object, _
    e As InkCollectorCursorInRangeEventArgs _
)
'Usage
Dim instance As New InkCollectorCursorInRangeEventHandler(AddressOf HandlerMethod)

public delegate void InkCollectorCursorInRangeEventHandler(
    Object sender,
    InkCollectorCursorInRangeEventArgs e
)

public delegate void InkCollectorCursorInRangeEventHandler(
    Object^ sender, 
    InkCollectorCursorInRangeEventArgs^ e
)

/** @delegate */
public delegate void InkCollectorCursorInRangeEventHandler(
    Object sender,
    InkCollectorCursorInRangeEventArgs e
)

JScript unterstützt keine Delegaten.

Parameter

sender
Typ: System.Object
Das InkCollector-Quellobjekt dieses Ereignisses.

e
Typ: Microsoft.Ink.InkCollectorCursorInRangeEventArgs
Das InkCollectorCursorInRangeEventArgs-Objekt, das die Ereignisdaten enthält.

Hinweise

Beim Erstellen eines InkCollectorCursorInRangeEventHandler-Delegaten bestimmen Sie die Methode für die Ereignisbehandlung. Um dem Ereignishandler das Ereignis zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu. Der Ereignishandler wird bei jedem Eintreten des Ereignisses aufgerufen, sofern der Delegat nicht entfernt wird. Das Standardinteresse an Ereignissen ist aktiviert.

Das CursorInRange-Ereignis wird selbst im Auswahl- oder Löschmodus ausgelöst, nicht nur im Freihandmodus. Dies erfordert, dass Sie den Bearbeitungsmodus (den Sie festlegen müssen) überwachen und den Modus kennen, bevor Sie das Ereignis interpretieren. Der Vorteil dieser Anforderung besteht in einer größeren Flexibilität für Neuerungen auf der Plattform, da Plattformereignisse besser erkannt werden können.

Beispiele

In diesem Beispiel wird überprüft, ob das InkCollector-Objekt zum ersten Mal Kontakt mit diesem Cursor-Objekt hat, wenn das CursorInRange-Ereignis ausgelöst wird. Wenn dies der Fall ist, wird die DrawingAttributes-Eigenschaft einem Klon der DefaultDrawingAttributes-Eigenschaft zugewiesen. Hierdurch wird verhindert, dass durch den anschließenden Zugriff auf die DrawingAttributes-Eigenschaft eine NULL-Verweisausnahme ausgelöst wird.

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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.