Control.QueryContinueDrag É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 de glisser-déplacer et active la source de glisser-déplacer pour déterminer si l’opération glisser-déplacer doit être annulée.
public:
event System::Windows::Forms::QueryContinueDragEventHandler ^ QueryContinueDrag;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 Type d'événement
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 de glisser-déplacer se déplace en dehors des limites du formulaire. Consultez la DoDragDrop méthode de l’exemple de code complet.
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, 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, 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é lorsqu’il existe une modification de l’état du clavier ou du bouton de la souris lors d’une opération de glisser-déplacer. L’événement QueryContinueDrag permet à la source de glisser-déplacer de déterminer si l’opération glisser-déplacer doit être annulée.
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 DragAction
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 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 DragAction
Drop, 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 DragAction
Cancel, l’événement DragLeave est déclenché.
Par défaut, l’événement QueryContinueDrag est défini DragActionActionCancel sur la touche échap si la touche Échap a été enfoncée et est activée ActionDropDragAction si le bouton gauche, central ou droit de la souris est enfoncé.
Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.
