ToolStripItem.DragEnter Événement

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Se produit lorsque l'utilisateur fait glisser un élément dans la zone cliente de cet élément.

public:
 event System::Windows::Forms::DragEventHandler ^ DragEnter;

[System.ComponentModel.Browsable(false)]
public event System.Windows.Forms.DragEventHandler? DragEnter;

[<System.ComponentModel.Browsable(false)>]
member this.DragEnter : System.Windows.Forms.DragEventHandler 

Public Custom Event DragEnter As DragEventHandler 

Type d'événement

DragEventHandler

Attributs

BrowsableAttribute

Exemples

L’exemple de code suivant montre comment convertir les X propriétés et Y en client Point. Cet exemple de code fait partie d’un exemple plus grand fourni pour la ToolStripRenderer classe .

// This method defines the DragOver event behavior. 
protected override void OnDragOver(DragEventArgs dea)
{
    base.OnDragOver(dea);

    // Get the ToolStripButton control 
    // at the given mouse position.
    Point p = new Point(dea.X, dea.Y);
    ToolStripButton item = this.GetItemAt(
        this.PointToClient(p)) as ToolStripButton;

    // If the ToolStripButton control is the empty cell,
    // indicate that the move operation is valid.
    if( item == this.emptyCellButton )
    {
        // Set the drag operation to indicate a valid move.
        dea.Effect = DragDropEffects.Move;
    }
}

' This method defines the DragOver event behavior. 
Protected Overrides Sub OnDragOver(dea As DragEventArgs)
   MyBase.OnDragOver(dea)
   
   ' Get the ToolStripButton control 
   ' at the given mouse position.
   Dim p As New Point(dea.X, dea.Y)
   Dim item As ToolStripButton = CType(Me.GetItemAt(Me.PointToClient(p)), ToolStripButton)
   
   
   ' If the ToolStripButton control is the empty cell,
   ' indicate that the move operation is valid.
     If item Is Me.emptyCellButton Then
         ' Set the drag operation to indicate a valid move.
         dea.Effect = DragDropEffects.Move
     End If
 End Sub

Remarques

L’événement DragEnter est déclenché lorsque l’utilisateur fait glisser le curseur de la souris sur l’élément pendant une opération de glisser-déplacer.

Les remarques suivantes décrivent comment et quand les événements liés aux opérations de glisser-déplacer sont déclenchés.

La DoDragDrop méthode détermine l’élément sous l’emplacement actuel du curseur. Il vérifie ensuite si l’élément est une cible de suppression valide.

Si l’élément est une cible de déplacement valide, l’événement GiveFeedback est déclenché avec l’effet glisser-déplacer spécifié. Pour obtenir la liste des effets de glisser-déposer, consultez l’énumération DragDropEffects.

Les modifications apportées à la position du curseur de la souris, à l’état du clavier et à l’état du bouton de la souris sont suivies de la manière suivante :

• Si l'utilisateur se déplace hors de la fenêtre, l'événement DragLeave est déclenché.

• Si la souris entre un autre élément, le DragEnter pour ce contrôle est déclenché.

• Si la souris se déplace mais reste dans le même élément, l’événement DragOver est déclenché.

En cas de modification de l’état du clavier ou du bouton de la souris, l’événement QueryContinueDrag est déclenché et détermine s’il faut continuer le glisser, supprimer les données ou annuler l’opération en fonction de la valeur de la Action propriété de l’événement QueryContinueDragEventArgs.

Si la valeur de DragAction est Continue, l’événement DragOver est déclenché pour continuer l’opération et l’événement GiveFeedback est déclenché avec le nouvel effet afin que les commentaires visuels appropriés puissent être définis. Pour obtenir la liste des effets de dépôt valides, consultez l’énumération DragDropEffects.

Les DragOver événements et GiveFeedback sont associés de sorte que lorsque la souris se déplace sur la cible de suppression, l’utilisateur reçoit les commentaires les plus à jour sur la position de la souris, comme suit :

• Si la valeur de est Drop, la valeur de DragAction l’effet de suppression est retournée à la source, de sorte que l’application source peut effectuer l’opération appropriée sur les données sources ; par exemple, couper les données si l’opération était un déplacement.

• Si la valeur de DragAction est Cancel, l’événement DragLeave est déclenché.

Notes

Les X propriétés et Y du sont dans les coordonnées de l’écran DragEventArgs , et non dans les coordonnées du client.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.