Control.GiveFeedback Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit pendant une opération glisser.
public:
event System::Windows::Forms::GiveFeedbackEventHandler ^ GiveFeedback;
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
Exemples
L’exemple de code suivant illustre une opération glisser-déplacer entre deux ListBox contrôles. L’exemple appelle la DoDragDrop méthode au démarrage de l’action de glisser. L’action glisser démarre si la souris s’est 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 glisser-déplacer. L’exemple exige que deux fichiers de curseur, 3dwarro.cur
et 3dwno.cur
, existent dans le répertoire de l’application, pour les curseurs de glisser-déplacer personnalisés, respectivement. Les curseurs personnalisés sont utilisés si est UseCustomCursorsCheck
CheckBox activé. 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 pour le bon ListBox
, afin de déterminer ce que sera l’opération de glissement en fonction de l’état des touches Maj, Ctrl, Alt ou Ctrl+Alt. L’emplacement dans le ListBox
où la suppression se produirait est également déterminé pendant l’événement DragOver
. Si les données à supprimer ne sont pas un String
, le DragEventArgs.Effect est défini sur None
dans DragDropEffects. Enfin, le status de la suppression s’affiche dans le DropLocationLabel
Label.
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 glisser-déplacer est annulée dans le gestionnaire d’événements QueryContinueDrag .
Cet extrait de code illustre l’utilisation de l’événement GiveFeedback . Consultez la DoDragDrop méthode pour obtenir 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 glisser-déplacer est démarrée. Avec l’événement GiveFeedback , la source d’un événement de glissement peut modifier l’apparence du pointeur de la souris afin de donner à l’utilisateur un retour visuel lors d’une opération de glisser-déplacer.
Les lignes suivantes décrivent de quelle façon et à quel moment se déclenchent les événements liés aux opérations de glisser-déplacer.
La DoDragDrop méthode détermine le contrôle sous l’emplacement du curseur actuel. Il vérifie ensuite si le contrôle est une cible de déplacement 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é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 font l'objet d'un suivi.
Si l'utilisateur se déplace hors de la fenêtre, l'événement DragLeave est déclenché.
Si la souris entre dans un autre contrôle, l'événement DragEnter du contrôle est déclenché.
Si la souris se déplace uniquement dans les limites du même contrôle, 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 à glisser, déposer 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 de pouvoir définir un retour visuel approprié. Pour obtenir la liste des effets de dépôt valides, consultez l’énumération DragDropEffects.Notes
Les DragOver événements et GiveFeedback 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 à jour sur la position de la souris.
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é.
Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.
S’applique à
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Envoyer et afficher des commentaires pour