Control.GiveFeedback Événement

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

Control.cs

Se produit pendant une opération de glissement.

public:
 event System::Windows::Forms::GiveFeedbackEventHandler ^ GiveFeedback;

public event System.Windows.Forms.GiveFeedbackEventHandler? GiveFeedback;

member this.GiveFeedback : System.Windows.Forms.GiveFeedbackEventHandler 

Public Custom Event GiveFeedback As GiveFeedbackEventHandler 

Type d'événement

GiveFeedbackEventHandler

Exemples

L’exemple de code suivant illustre une opération de glisser-déplacer entre deux ListBox contrôles. L’exemple appelle la DoDragDrop méthode au démarrage de l’action glisser. L’action glisser démarre si la souris a été déplacée plus que SystemInformation.DragSize de l’emplacement de la souris pendant l’événement MouseDown . La IndexFromPoint méthode est utilisée pour déterminer l’index de l’élément à faire glisser pendant l’événement MouseDown .

L’exemple montre également l’utilisation de curseurs personnalisés pour l’opération de glisser-déplacer. L’exemple nécessite que deux fichiers de curseur et3dwno.cur, 3dwarro.cur respectivement, existent dans le répertoire de l’application, pour les curseurs de glisser-déplacer personnalisés. Les curseurs personnalisés seront utilisés si l’option UseCustomCursorsCheckCheckBox est cochée. Les curseurs personnalisés sont définis dans le gestionnaire d’événements GiveFeedback .

L’état du clavier est évalué dans le DragOver gestionnaire d’événements de droite ListBoxpour déterminer ce que l’opération de glisser sera basée sur l’état des touches Maj, Ctrl, Alt ou Ctrl+Alt. L’emplacement dans lequel ListBox la suppression se produit est également déterminé pendant l’événement DragOver . Si les données à supprimer ne sont pas un String, la valeur DragEventArgs.Effect est définie None dans DragDropEffects. Enfin, l’état de la suppression s’affiche dans le DropLocationLabelLabel.

Les données à supprimer pour la droite ListBox sont déterminées dans le DragDrop gestionnaire d’événements et la String valeur est ajoutée à l’emplacement approprié dans le ListBox. Si l’opération de glissement se déplace en dehors des limites du formulaire, l’opération de glisser-déplacer est annulée dans le QueryContinueDrag gestionnaire d’événements.

Cet extrait de code illustre l’utilisation de l’événement GiveFeedback . Consultez la DoDragDrop méthode de l’exemple de code complet.

void ListDragSource_GiveFeedback( Object^ /*sender*/, System::Windows::Forms::GiveFeedbackEventArgs^ e )
{
   // Use custom cursors if the check box is checked.
   if ( UseCustomCursorsCheck->Checked )
   {
      // Sets the custom cursor based upon the effect.
      e->UseDefaultCursors = false;
      if ( (e->Effect & DragDropEffects::Move) == DragDropEffects::Move )
                  ::Cursor::Current = MyNormalCursor;
      else
                  ::Cursor::Current = MyNoDropCursor;
   }
}

private void ListDragSource_GiveFeedback(object sender, GiveFeedbackEventArgs e)
{
    // Use custom cursors if the check box is checked.
    if (UseCustomCursorsCheck.Checked)
    {
        // Sets the custom cursor based upon the effect.
        e.UseDefaultCursors = false;
        if ((e.Effect & DragDropEffects.Move) == DragDropEffects.Move)
            Cursor.Current = MyNormalCursor;
        else
            Cursor.Current = MyNoDropCursor;
    }
}

Private Sub ListDragSource_GiveFeedback(ByVal sender As Object, ByVal e As GiveFeedbackEventArgs) Handles ListDragSource.GiveFeedback
    ' Use custom cursors if the check box is checked.
    If (UseCustomCursorsCheck.Checked) Then

        ' Set the custom cursor based upon the effect.
        e.UseDefaultCursors = False
        If ((e.Effect And DragDropEffects.Move) = DragDropEffects.Move) Then
            Cursor.Current = MyNormalCursor
        Else
            Cursor.Current = MyNoDropCursor
        End If
    End If

End Sub

Remarques

L’événement GiveFeedback est déclenché lorsqu’une opération de glisser-déplacer est démarrée. Avec l’événement GiveFeedback , la source d’un événement de glisser peut modifier l’apparence du pointeur de la souris afin de donner un retour visuel utilisateur lors d’une opération de glisser-déplacer.

L’exemple suivant décrit 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 le contrôle sous l’emplacement actuel du curseur. Il vérifie ensuite si le contrôle est une cible de suppression valide.

Si le contrôle 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éplacer, 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.

• Si l’utilisateur se déplace hors d’une fenêtre, l’événement DragLeave est déclenché.

• Si la souris entre dans un autre contrôle, le DragEnter contrôle est déclenché.

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

S’il existe une 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-déplacer, déplacer 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 est DragActionContinue, l’événement DragOver est déclenché pour poursuivre 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 suppression valides, consultez l’énumération DragDropEffects .

  Note

  Les DragOver événements et GiveFeedback les événements sont associés de sorte que lorsque la souris se déplace sur la cible de déplacement, l’utilisateur reçoit les commentaires les plus up-to-date sur la position de la souris.

• Si la valeur est DragActionDrop, la valeur de 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 est DragActionCancel, l’événement DragLeave est déclenché.

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

Voir aussi

• OnGiveFeedback(GiveFeedbackEventArgs)