ToolStripItem.QueryContinueDrag ToolStripItem.QueryContinueDrag ToolStripItem.QueryContinueDrag ToolStripItem.QueryContinueDrag Event

Définition

Se produit pendant une opération glisser-déplacer et permet à la source de cette opération de déterminer si l'opération doit être annulée.Occurs during a drag-and-drop operation and allows the drag source to determine whether the drag-and-drop operation should be canceled.

public:
 event System::Windows::Forms::QueryContinueDragEventHandler ^ QueryContinueDrag;
[System.ComponentModel.Browsable(false)]
public event System.Windows.Forms.QueryContinueDragEventHandler QueryContinueDrag;
member this.QueryContinueDrag : System.Windows.Forms.QueryContinueDragEventHandler 
Public Custom Event QueryContinueDrag As QueryContinueDragEventHandler 
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 signale l’occurrence de QueryContinueDrag l’événement.In the example, an event handler reports on the occurrence of the QueryContinueDrag event. Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider à effectuer un débogage.This report helps you to learn when the event occurs and can assist you in debugging. Pour effectuer un rapport sur plusieurs événements ou sur des événements qui se produisent MessageBox.Show fréquemment Console.WriteLine , envisagez de remplacer ou d' TextBoxajouter le message à une ligne multiligne.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 ToolStripItemhérite de, ToolStripButton tel ToolStripMenuItemque ou.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. Nommez ensuite l' ToolStripItem1 instance et assurez-vous que le gestionnaire d' QueryContinueDrag événements est associé à l’événement.Then name the instance ToolStripItem1 and ensure that the event handler is associated with the QueryContinueDrag event.

private void ToolStripItem1_QueryContinueDrag(Object sender, QueryContinueDragEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "KeyState", e.KeyState );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "EscapePressed", e.EscapePressed );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Action", e.Action );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "QueryContinueDrag Event" );
}
Private Sub ToolStripItem1_QueryContinueDrag(sender as Object, e as QueryContinueDragEventArgs) _ 
     Handles ToolStripItem1.QueryContinueDrag

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "KeyState", e.KeyState)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "EscapePressed", e.EscapePressed)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Action", e.Action)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"QueryContinueDrag Event")

End Sub

Remarques

L' QueryContinueDrag événement est déclenché en cas de modification de l’état du clavier ou du bouton de la souris pendant une opération de glisser-déplacer.The QueryContinueDrag event is raised when there is a change in the keyboard or mouse button state during a drag-and-drop operation. L' QueryContinueDrag événement permet à la source de glissement de déterminer si l’opération de glisser-déplacer doit être annulée.The QueryContinueDrag event allows the drag source to determine whether the drag-and-drop operation should be canceled.

Les remarques 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.

La DoDragDrop méthode détermine l’élément situé sous l’emplacement actuel du curseur.The DoDragDrop method determines the item under the current cursor location. Il 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éplacement valide, GiveFeedback l’é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 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 :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 DragEnter , le 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 mais reste dans le même élément, DragOver l’événement est déclenché.If the mouse moves but stays within the same item, the DragOver event is raised.

En cas de modification de l’état du clavier ou du bouton de la QueryContinueDrag souris, l’événement est déclenché et détermine s’il faut continuer l’opération glisser, déplacer les données ou annuler l’opération en fonction de la Action valeur de la QueryContinueDragEventArgspropriété de l’événement.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, l' DragOver événement est déclenché pour poursuivre l’opération et l' GiveFeedback événement est déclenché avec le nouvel effet, si bien que la rétroaction visuelle appropriée peut être définie.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.

Les DragOver événements GiveFeedback et sont associés de telle sorte que lorsque la souris passe sur la cible de déplacement, l’utilisateur reçoit les commentaires les plus à jour 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 de l’effet de dépôt est retournée à la source. ainsi, 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, l' DragLeave événement est déclenché.If the value of DragAction is Cancel, the DragLeave event is raised.

S’applique à