Control.QueryContinueDrag Událost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

Control.cs

Nastane během operace přetažení a umožňuje zdroji přetažení určit, zda má být operace přetažení zrušena.

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 

Event Type

QueryContinueDragEventHandler

Příklady

Tento výňatek kódu ukazuje použití QueryContinueDrag události ke zrušení operace přetažení, pokud se operace přetažení přesune mimo hranice formuláře. Podívejte se na DoDragDrop metodu kompletního příkladu kódu.

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

Poznámky

Událost QueryContinueDrag se vyvolá, když během operace přetažení dojde ke změně stavu klávesnice nebo tlačítka myši. Událost QueryContinueDrag umožňuje zdroji přetažení určit, zda má být operace přetažení zrušena.

Následující článek popisuje, jak a kdy jsou vyvolány události související s operacemi přetažení myší.

Metoda DoDragDrop určuje ovládací prvek pod aktuálním umístěním kurzoru. Pak zkontroluje, jestli je ovládací prvek platným cílem odstranění.

Pokud je ovládací prvek platným cílem přetažení, GiveFeedback je událost vyvolána se zadaným efektem přetažení. Seznam efektů přetažení najdete v výčtu DragDropEffects .

Změny v poloze kurzoru myši, stavu klávesnice a stavu tlačítka myši jsou sledovány.

• Pokud se uživatel přesune mimo okno, DragLeave vyvolá se událost.

• Pokud myš vstoupí do jiného ovládacího prvku, DragEnter je pro tento ovládací prvek vyvolán.

• Pokud se myš přesune, ale zůstane ve stejném ovládacím prvku, DragOver vyvolá se událost.

Pokud dojde ke změně stavu klávesnice nebo tlačítka myši, QueryContinueDrag událost se vyvolá a určí, zda má pokračovat přetažením, přetažením dat nebo zrušením operace na základě hodnoty Action vlastnosti události QueryContinueDragEventArgs.

• Pokud je Continuehodnota DragAction , DragOver událost je vyvolána, aby pokračovala v operaci a GiveFeedback událost je vyvolána s novým efektem, aby bylo možné nastavit odpovídající vizuální zpětnou vazbu. Seznam platných efektů přetažení najdete ve výčtu DragDropEffects .

  Poznámka:

  Události DragOver a GiveFeedback události jsou spárované tak, aby se myš pohybuje přes cíl přetažení, uživatel dostane nejvíce up-to- datum zpětné vazby na pozici myši.

• Pokud je Drophodnota DragAction , vrátí se hodnota efektu poklesu do zdroje, takže zdrojová aplikace může provést příslušnou operaci se zdrojovými daty, například vyjmout data, pokud byla operace přesunutím.

• Pokud je Cancelhodnota DragAction , DragLeave je vyvolána událost.

Ve výchozím nastavení se událost nastaví Action na Cancel inDragAction, QueryContinueDrag pokud byla stisknuta klávesa ESC a nastavena Action na DragActionDrop hodnotu, pokud je stisknuto levé, prostřední nebo pravé tlačítko myši.

Další informace o zpracování událostí naleznete v tématu Zpracování a vyvolávání událostí.

Viz také

• OnQueryContinueDrag(QueryContinueDragEventArgs)