InkCollectorCursorInRangeEventHandler, délégué

Article
11/05/2008

Mise à jour : November 2007

Représente la méthode qui gère l'événement CursorInRange d'un objet InkCollector.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Delegate Sub InkCollectorCursorInRangeEventHandler ( _
    sender As Object, _
    e As InkCollectorCursorInRangeEventArgs _
)
'Utilisation
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 ne prend pas en charge les délégués.

Paramètres

sender
Type : System.Object
Objet InkCollector source de cet événement.

e
Type : Microsoft.Ink.InkCollectorCursorInRangeEventArgs
Objet InkCollectorCursorInRangeEventArgs qui contient les données d'événement.

Notes

Lorsque vous créez un délégué InkCollectorCursorInRangeEventHandler, vous identifiez la méthode qui gère l'événement. Pour associer l'événement au gestionnaire d'événements, ajoutez une instance du délégué à l'événement. Le gestionnaire d'événements est appelé chaque fois qu'un événement se produit, sauf si vous supprimez le délégué. L'intérêt d'événement par défaut est activé.

L'événement CursorInRange se déclenche en mode de sélection ou de suppression, et pas uniquement en mode d'entrée manuscrite. Vous devez surveiller le mode de modification (que vous êtes chargé de définir) et connaître le mode avant d'interpréter l'événement. Ces conditions offrent une plus grande liberté d'innovation sur la plateforme grâce à une sensibilité accrue des événements de plateforme.

Exemples

Dans cet exemple, lorsque l'événement CursorInRange se déclenche, un contrôle vérifie si c'est la première fois que l'objet InkCollector entre en contact avec cet objet Cursor spécifique. Si c'est le cas, un clone de la propriété DefaultDrawingAttributes est assigné à la propriété DrawingAttributes. Ainsi, lors de l'accès suivant à la propriété, DrawingAttributes aucune exception de référence null n'est levée.

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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.