Control.QueryContinueDrag Evento

Definición

Se produce durante una operación de arrastrar y colocar, y permite al origen de arrastre determinar si la operación de arrastrar y colocar tiene que cancelarse.

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 

Tipo de evento

QueryContinueDragEventHandler

Ejemplos

Este fragmento de código muestra el uso del QueryContinueDrag evento para cancelar la operación de arrastrar y colocar si la operación de arrastre se mueve fuera de los límites del formulario. Consulte el método para obtener el DoDragDrop ejemplo de código completo.

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

Comentarios

El QueryContinueDrag evento se genera cuando se produce un cambio en el estado del teclado o del botón del mouse durante una operación de arrastrar y colocar. El QueryContinueDrag evento permite al origen de arrastre determinar si se debe cancelar la operación de arrastrar y colocar.

A continuación, se describe cómo y cuándo se generan eventos relacionados con operaciones de arrastrar y colocar.

El DoDragDrop método determina el control bajo la ubicación actual del cursor. A continuación, comprueba si el control es un destino de colocación válido.

Si el control es un destino de colocación válido, el GiveFeedback evento se genera con el efecto de arrastrar y colocar especificado. Para obtener una lista de efectos de arrastrar y colocar, vea la enumeración DragDropEffects.

Se realiza el seguimiento de la posición del cursor del mouse, del estado del teclado y del estado de los botones del mouse.

  • Si el usuario desplaza el mouse fuera de una ventana, se genera el evento DragLeave.

  • Si el mouse entra en otro control, se genera el evento DragEnter para ese control.

  • Si se mueve el mouse dentro del mismo control, se genera el evento DragOver.

Si hay un cambio en el estado del teclado o del botón del mouse, se genera el QueryContinueDrag evento y determina si se debe continuar con la arrastrar, colocar los datos o cancelar la operación en función del valor de la Action propiedad del evento QueryContinueDragEventArgs.

  • Si el valor de DragAction es Continue, se genera el DragOver evento para continuar con la operación y el GiveFeedback evento se genera con el nuevo efecto para que se puedan establecer los comentarios visuales adecuados. Para obtener una lista de efectos de colocar válidos, vea la enumeración DragDropEffects.

    Nota

    Los DragOver eventos y GiveFeedback se emparejan para que, a medida que el mouse se mueva por el destino de colocación, el usuario recibe los comentarios más actualizados sobre la posición del mouse.

  • Si el valor de DragAction es Drop, el valor de efecto de colocación se devuelve al origen, por lo que la aplicación de origen puede realizar la operación adecuada en los datos de origen; por ejemplo, corte los datos si la operación era un movimiento.

  • Si el valor de DragAction es Cancel, se genera el DragLeave evento .

De forma predeterminada, el QueryContinueDrag evento establece Cancel Action en en DragAction si se presionó la tecla ESC y se establece Action Drop en en si DragAction se presiona el botón izquierdo, central o derecho del mouse.

Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.

Se aplica a

Consulte también