Control.QueryContinueDrag Evento

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Si verifica durante un'operazione di trascinamento della selezione e consente all'origine del trascinamento di determinare se l'operazione deve essere annullata.

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 evento

QueryContinueDragEventHandler

Esempio

Questo estratto di codice illustra l'utilizzo dell'evento QueryContinueDrag per annullare l'operazione di trascinamento della selezione se l'operazione di trascinamento si sposta all'esterno dei limiti del form. Vedere il DoDragDrop metodo per l'esempio di codice 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

Commenti

L'evento QueryContinueDrag viene generato quando si verifica una modifica nello stato della tastiera o del pulsante del mouse durante un'operazione di trascinamento della selezione. L'evento QueryContinueDrag consente all'origine di trascinamento di determinare se l'operazione di trascinamento deve essere annullata.

Di seguito vengono illustrate le modalità e le circostanze in cui vengono generati eventi relativi a operazioni di trascinamento.

Il DoDragDrop metodo determina il controllo sotto la posizione corrente del cursore. Verifica quindi se il controllo è una destinazione di rilascio valida.

Se il controllo è una destinazione di rilascio valida, l'evento GiveFeedback viene generato con l'effetto di trascinamento della selezione specificato. Per un elenco degli effetti di trascinamento e rilascio, vedere l'enumerazione DragDropEffects.

Viene tenuta traccia delle modifiche apportate alla posizione del cursore del mouse, allo stato della tastiera e allo stato dei pulsanti del mouse.

• Se l'utente si sposta al di fuori di una finestra, verrà generato un evento DragLeave.

• Se il mouse viene spostato su un altro controllo, verrà generato l'evento DragEnter per tale controllo.

• Se il mouse viene spostato ma sempre all'interno dello stesso controllo, verrà generato l'evento DragOver.

Se si verifica una modifica nello stato della tastiera o del pulsante del mouse, l'evento QueryContinueDrag viene generato e determina se continuare il trascinamento, rilasciare i dati o annullare l'operazione in base al valore della Action proprietà dell'evento QueryContinueDragEventArgs.

• Se il valore di DragAction è Continue, l'evento DragOver viene generato per continuare l'operazione e l'evento viene generato con il GiveFeedback nuovo effetto in modo che sia possibile impostare il feedback visivo appropriato. Per un elenco degli effetti di trascinamento validi, vedere l'enumerazione DragDropEffects.

  Nota

  Gli DragOver eventi e GiveFeedback vengono associati in modo che quando il mouse si sposta attraverso la destinazione di rilascio, all'utente viene assegnato il feedback più aggiornato sulla posizione del mouse.

• Se il valore di è Drop, il valore dell'effetto di rilascio viene restituito all'origine, in modo che l'applicazione di origine possa eseguire l'operazione appropriata sui dati di DragAction origine, ad esempio tagliare i dati se l'operazione è stata spostata.

• Se il valore di DragAction è Cancel, viene generato l'evento DragLeave .

Per impostazione predefinita, l'evento QueryContinueDrag imposta CancelAction su in DragAction se il tasto ESC è stato premuto e imposta su ActionDrop se DragAction viene premuto il pulsante sinistro, centrale o destro del mouse.

Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.

Vedi anche

• OnQueryContinueDrag(QueryContinueDragEventArgs)