InkCollector.CursorOutOfRange, événement

Article
11/05/2008

Mise à jour : November 2007

Se produit lorsqu'un curseur quitte la plage de détection physique (proximité) du contexte de la tablette.

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

Syntaxe

'Déclaration
Public Event CursorOutOfRange As InkCollectorCursorOutOfRangeEventHandler
'Utilisation
Dim instance As InkCollector
Dim handler As InkCollectorCursorOutOfRangeEventHandler

AddHandler instance.CursorOutOfRange, handler

public event InkCollectorCursorOutOfRangeEventHandler CursorOutOfRange

public:
 event InkCollectorCursorOutOfRangeEventHandler^ CursorOutOfRange {
    void add (InkCollectorCursorOutOfRangeEventHandler^ value);
    void remove (InkCollectorCursorOutOfRangeEventHandler^ value);
}

/** @event */
public void add_CursorOutOfRange (InkCollectorCursorOutOfRangeEventHandler value)
/** @event */
public void remove_CursorOutOfRange (InkCollectorCursorOutOfRangeEventHandler value)

JScript ne prend pas en charge les événements.

Notes

Le gestionnaire d'événements reçoit un argument de type InkCollectorCursorOutOfRangeEventArgs qui contient des données concernant cet événement.

Lorsque vous créez un délégué InkCollectorCursorOutOfRangeEventHandler, 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 CursorOutOfRange 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 CursorOutOfRange se déclenche, la couleur du dernier trait à créer passe au rouge.

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

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.