ToolStripItem.GiveFeedback ToolStripItem.GiveFeedback ToolStripItem.GiveFeedback ToolStripItem.GiveFeedback Event

Définition

Se produit pendant une opération glisser.Occurs during a drag operation.

public:
 event System::Windows::Forms::GiveFeedbackEventHandler ^ GiveFeedback;
[System.ComponentModel.Browsable(false)]
public event System.Windows.Forms.GiveFeedbackEventHandler GiveFeedback;
member this.GiveFeedback : System.Windows.Forms.GiveFeedbackEventHandler 
Public Custom Event GiveFeedback As GiveFeedbackEventHandler 
Attributs

Exemples

L’exemple de code suivant illustre l’utilisation de ce membre.The following code example demonstrates the use of this member. Dans l’exemple, un gestionnaire d’événements des rapports sur l’occurrence de la GiveFeedback événement.In the example, an event handler reports on the occurrence of the GiveFeedback event. Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider à déboguer.This report helps you to learn when the event occurs and can assist you in debugging. Pour générer un rapport sur plusieurs événements ou sur les événements qui se produisent fréquemment, envisagez de remplacer MessageBox.Show avec Console.WriteLine ou ajouter le message à un multiligne TextBox.To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Pour exécuter l’exemple de code, collez-le dans un projet qui contient une instance d’un type qui hérite de ToolStripItem, comme un ToolStripButton ou ToolStripMenuItem.To run the example code, paste it into a project that contains an instance of a type that inherits from ToolStripItem, such as a ToolStripButton or ToolStripMenuItem. Ensuite, nommez l’instance ToolStripItem1 et vous assurer que le Gestionnaire d’événements est associé à la GiveFeedback événement.Then name the instance ToolStripItem1 and ensure that the event handler is associated with the GiveFeedback event.

private void ToolStripItem1_GiveFeedback(Object sender, GiveFeedbackEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Effect", e.Effect );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "UseDefaultCursors", e.UseDefaultCursors );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "GiveFeedback Event" );
}
Private Sub ToolStripItem1_GiveFeedback(sender as Object, e as GiveFeedbackEventArgs) _ 
     Handles ToolStripItem1.GiveFeedback

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Effect", e.Effect)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "UseDefaultCursors", e.UseDefaultCursors)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"GiveFeedback Event")

End Sub

Remarques

Le GiveFeedback événement est déclenché lorsqu’une opération de glisser-déplacer commence.The GiveFeedback event is raised when a drag-and-drop operation is started. Le GiveFeedback événement permet à la source d’un événement glisser de modifier l’apparence du pointeur de la souris pour fournir une rétroaction visuelle pendant une opération de glisser-déplacer.The GiveFeedback event allows the source of a drag event to modify the appearance of the mouse pointer in order to give the user visual feedback during a drag-and-drop operation.

Les notes suivantes décrivent comment et quand les événements liés aux opérations de glisser-déplacer sont déclenchés.The following remarks describe how and when events related to drag-and-drop operations are raised.

Le DoDragDrop méthode détermine l’élément sous l’emplacement du curseur.The DoDragDrop method determines the item under the current cursor location. Elle vérifie ensuite si l’élément est une cible de dépôt valide.It then checks to see if the item is a valid drop target.

Si l’élément est une cible de dépôt valide, le GiveFeedback événement est déclenché avec l’effet de glisser-déplacer spécifié.If the item is a valid drop target, the GiveFeedback event is raised with the drag-and-drop effect specified. Pour obtenir la liste des effets de glisser-déposer, consultez l’énumération DragDropEffects.For a list of drag-and-drop effects, see the DragDropEffects enumeration.

Les modifications de la position du curseur de la souris, état du clavier et état du bouton de la souris sont suivies de la manière suivante :Changes in the mouse cursor position, keyboard state, and mouse button state are tracked in the following manner:

  • Si l'utilisateur se déplace hors de la fenêtre, l'événement DragLeave est déclenché.If the user moves out of a window, the DragLeave event is raised.

  • Si la souris entre dans un autre élément, le DragEnter pour ce contrôle est déclenché.If the mouse enters another item, the DragEnter for that control is raised.

  • Si la souris se déplace uniquement dans le même élément, le DragOver événement est déclenché.If the mouse moves but stays within the same item, the DragOver event is raised.

S’il existe une modification de l’état de bouton de souris ou le clavier, la QueryContinueDrag événement est déclenché et détermine s’il faut continuer l’opération 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.If there is a change in the keyboard or mouse button state, the QueryContinueDrag event is raised and determines whether to continue the drag, to drop the data, or to cancel the operation based on the value of the Action property of the event's QueryContinueDragEventArgs.

Si la valeur de DragAction est Continue, le DragOver événement est déclenché pour poursuivre l’opération et le GiveFeedback événement est déclenché avec le nouvel effet, pour rétroaction visuelle appropriée.If the value of DragAction is Continue, the DragOver event is raised to continue the operation and the GiveFeedback event is raised with the new effect so appropriate visual feedback can be set. Pour obtenir la liste des effets de dépôt valides, consultez l’énumération DragDropEffects.For a list of valid drop effects, see the DragDropEffects enumeration.

Le DragOver et GiveFeedback les événements sont associés afin que lorsque la souris se trouve sur la cible de déplacement, l’utilisateur reçoit les commentaires les plus actuels sur la position de la souris, comme suit :The DragOver and GiveFeedback events are paired so that as the mouse moves across the drop target, the user is given the most up-to-date feedback on the mouse's position, as follows:

  • Si la valeur de DragAction est Drop, la valeur d’effet de déplacement est retournée à la source, afin de 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.If the value of DragAction is Drop, the drop effect value is returned to the source, so the source application can perform the appropriate operation on the source data; for example, cut the data if the operation was a move.

  • Si la valeur de DragAction est Cancel, le DragLeave événement est déclenché.If the value of DragAction is Cancel, the DragLeave event is raised.

S’applique à