InkCollectorCursorButtonUpEventHandler, délégué

Article
11/05/2008

Mise à jour : November 2007

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

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

Syntaxe

'Déclaration
Public Delegate Sub InkCollectorCursorButtonUpEventHandler ( _
    sender As Object, _
    e As InkCollectorCursorButtonUpEventArgs _
)
'Utilisation
Dim instance As New InkCollectorCursorButtonUpEventHandler(AddressOf HandlerMethod)

public delegate void InkCollectorCursorButtonUpEventHandler(
    Object sender,
    InkCollectorCursorButtonUpEventArgs e
)

public delegate void InkCollectorCursorButtonUpEventHandler(
    Object^ sender, 
    InkCollectorCursorButtonUpEventArgs^ e
)

/** @delegate */
public delegate void InkCollectorCursorButtonUpEventHandler(
    Object sender,
    InkCollectorCursorButtonUpEventArgs 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.InkCollectorCursorButtonUpEventArgs
Objet InkCollectorCursorButtonUpEventArgs qui contient les données d'événement.

Notes

Le bouton du stylet est relâché lorsque l'utilisateur ôte le stylet du digitaliseur à la fin d'un trait. Le bouton du stylet est relâché lorsqu'il n'est pas activé.

Lorsque vous créez un délégué InkCollectorCursorButtonUpEventHandler, 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é. Pour des raisons de performances, l'intérêt d'événement par défaut est désactivé. Toutefois, il est automatiquement activé dans le code managé si vous ajoutez un gestionnaire d'événements.

Lorsque vous relâchez le bouton droit de la souris, vous recevez deux événements CursorButtonUp : un signalant le relâchement du bouton droit et l'autre le relâchement du bouton gauche.

Exemples

L'exemple suivant montre comment s'abonner aux événements CursorInRange, CursorButtonDown et CursorButtonUp afin que le pointeur d'entrée manuscrite (lors d'une saisie manuscrite à l'aide de la souris) s'affiche avec une couleur différente de celle de l'entrée manuscrite proprement dite.

Lorsque l'événement CursorInRange se déclenche, un contrôle est effectué pour déterminer s'il s'agit du premier contact de l'objet InkCollector 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. Si la souris est utilisée, la couleur de l'entrée manuscrite a la valeur rouge.

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

Lorsque l'événement CursorButtonDown se déclenche, un contrôle est effectué pour déterminer si l'objet Cursor fourni à l'événement est la souris. Dans ce cas, la propriété Color() a la valeur bleu.

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

}

Lorsque l'événement CursorButtonUp se déclenche, un contrôle est effectué pour déterminer si l'objet Cursor fourni à l'événement est la souris. Dans ce cas, la propriété Color() reprend la valeur rouge.

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

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.