InkCollectorCursorOutOfRangeEventHandler-Delegat

Artikel
10/28/2008

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

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

Syntax

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

public delegate void InkCollectorCursorOutOfRangeEventHandler(
    Object sender,
    InkCollectorCursorOutOfRangeEventArgs e
)

public delegate void InkCollectorCursorOutOfRangeEventHandler(
    Object^ sender, 
    InkCollectorCursorOutOfRangeEventArgs^ e
)

/** @delegate */
public delegate void InkCollectorCursorOutOfRangeEventHandler(
    Object sender,
    InkCollectorCursorOutOfRangeEventArgs e
)

JScript unterstützt keine Delegaten.

Parameter

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

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

Hinweise

Beim Erstellen eines InkCollectorCursorOutOfRangeEventHandler-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 CursorOutOfRange-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 die Farbe des zuletzt erstellten Strichs in die Farbe Rot geändert, wenn das CursorOutOfRange-Ereignis ausgelöst wird.

Private Sub mInkObject_CursorOutOfRange(ByVal sender As Object, ByVal e As InkCollectorCursorOutOfRangeEventArgs)
    Using s As Strokes = mInkObject.Ink.Strokes
        If s.Count > 0 Then
            s(s.Count - 1).DrawingAttributes.Color = Color.Tomato
            ' redraw the ink canvas
            panelInkCanvas.Invalidate()
        End If
    End Using
End Sub

private void mInkObject_CursorOutOfRange(object sender, InkCollectorCursorOutOfRangeEventArgs e)
{
    using (Strokes S = mInkObject.Ink.Strokes)
    {
        if (S.Count > 0)
        {
            S[S.Count - 1].DrawingAttributes.Color = Color.Tomato;
            // redraw the ink canvas
            panelInkCanvas.Invalidate();
        }
    }
}

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.