Control.QueryContinueDrag Événement

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 enables the drag source to determine whether the drag-and-drop operation should be canceled.

public:
 event System::Windows::Forms::QueryContinueDragEventHandler ^ QueryContinueDrag;
public event System.Windows.Forms.QueryContinueDragEventHandler QueryContinueDrag;
member this.QueryContinueDrag : System.Windows.Forms.QueryContinueDragEventHandler 
Public Custom Event QueryContinueDrag As QueryContinueDragEventHandler 

Exemples

Cet extrait de code illustre l’utilisation de l’événement QueryContinueDrag pour annuler l’opération de glisser-déplacer si l’opération glisser est déplacée en dehors des limites du formulaire.This code excerpt demonstrates using the QueryContinueDrag event to cancel the drag-and-drop operation if the drag operation moves outside the bounds of the form. Pour obtenir un exemple de code complet, consultez la méthode DoDragDrop.See the DoDragDrop method for the complete code example.

void ListDragSource_QueryContinueDrag( Object^ sender, System::Windows::Forms::QueryContinueDragEventArgs^ e )
{
   // Cancel the drag if the mouse moves off the form.
   ListBox^ lb = dynamic_cast<ListBox^>(sender);
   if ( lb != nullptr )
   {
      Form^ f = lb->FindForm();

      // Cancel the drag if the mouse moves off the form. The screenOffset
      // takes into account any desktop bands that may be at the top or left
      // side of the screen.
      if ( ((Control::MousePosition.X - screenOffset.X) < f->DesktopBounds.Left) || ((Control::MousePosition.X - screenOffset.X) > f->DesktopBounds.Right) || ((Control::MousePosition.Y - screenOffset.Y) < f->DesktopBounds.Top) || ((Control::MousePosition.Y - screenOffset.Y) > f->DesktopBounds.Bottom) )
      {
         e->Action = DragAction::Cancel;
      }
   }
}
private void ListDragSource_QueryContinueDrag(object sender, System.Windows.Forms.QueryContinueDragEventArgs e) {
    // Cancel the drag if the mouse moves off the form.
    ListBox lb = sender as ListBox;

    if (lb != null) {

        Form f = lb.FindForm();

        // Cancel the drag if the mouse moves off the form. The screenOffset
        // takes into account any desktop bands that may be at the top or left
        // side of the screen.
        if (((Control.MousePosition.X - screenOffset.X) < f.DesktopBounds.Left) ||
            ((Control.MousePosition.X - screenOffset.X) > f.DesktopBounds.Right) ||
            ((Control.MousePosition.Y - screenOffset.Y) < f.DesktopBounds.Top) ||
            ((Control.MousePosition.Y - screenOffset.Y) > f.DesktopBounds.Bottom)) {

            e.Action = DragAction.Cancel;
        }
    }
}
Private Sub ListDragSource_QueryContinueDrag(ByVal sender As Object, ByVal e As QueryContinueDragEventArgs) Handles ListDragSource.QueryContinueDrag
    ' Cancel the drag if the mouse moves off the form.
    Dim lb as ListBox = CType(sender, System.Windows.Forms.ListBox)

    If (lb isNot nothing) Then

        Dim f as Form = lb.FindForm()

        ' Cancel the drag if the mouse moves off the form. The screenOffset
        ' takes into account any desktop bands that may be at the top or left
        ' side of the screen.
        If (((Control.MousePosition.X - screenOffset.X) < f.DesktopBounds.Left) Or _
            ((Control.MousePosition.X - screenOffset.X) > f.DesktopBounds.Right) Or _
            ((Control.MousePosition.Y - screenOffset.Y) < f.DesktopBounds.Top) Or _
            ((Control.MousePosition.Y - screenOffset.Y) > f.DesktopBounds.Bottom)) Then

            e.Action = DragAction.Cancel
        End If
    End if
End Sub

Remarques

L’événement QueryContinueDrag 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’événement QueryContinueDrag permet à la source de glissement de déterminer si l’opération de glisser-déplacer doit être annulée.The QueryContinueDrag event enables the drag source to determine whether the drag-and-drop operation should be canceled.

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.The following describes how and when events related to drag-and-drop operations are raised.

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

Si le contrôle est une cible de déplacement valide, l’événement GiveFeedback est déclenché avec l’effet de glisser-déplacer spécifié.If the control 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 font l'objet d'un suivi.Changes in the mouse cursor position, keyboard state, and mouse button state are tracked.

  • 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 contrôle, l'événement DragEnter du contrôle est déclenché.If the mouse enters another control, the DragEnter for that control is raised.

  • Si la souris se déplace uniquement dans les limites du même contrôle, l'événement DragOver est déclenché.If the mouse moves but stays within the same control, the DragOver event is raised.

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 l’opération glisser, déplacer les données ou annuler l’opération en fonction de la valeur de la propriété Action du QueryContinueDragEventArgs 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’événement DragOver est déclenché pour poursuivre l’opération et l’événement GiveFeedback 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.

    Notes

    Les événements DragOver et GiveFeedback sont associés de telle 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.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.

  • 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, coupez 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’événement DragLeave est déclenché.If the value of DragAction is Cancel, the DragLeave event is raised.

Par défaut, l’événement QueryContinueDrag définit Action sur Cancel dans DragAction Si la touche ÉCHAP a été enfoncée et définit Action sur Drop dans DragAction si le bouton gauche, central ou droit de la souris est enfoncé.By default, the QueryContinueDrag event sets Action to Cancel in DragAction if the ESC key was pressed and sets Action to Drop in DragAction if the left, middle, or right mouse button is pressed.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.For more information about handling events, see Handling and Raising Events.

S’applique à

Voir aussi