Control.QueryContinueDrag Událost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Vyvolá se během operace přetažení a umožňuje zdroji přetažení určit, zda by měla 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 z 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. Kompletní příklad kódu najdete v DoDragDrop metodě.

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 tlačítka klávesnice nebo 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í.

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 vyřazení.

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

Sledují se změny v pozici kurzoru myši, stavu klávesnice a stavu tlačítka myši.

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

• Pokud myš přejde na jiný ovládací prvek, DragEnter vyvolá se hodnota pro tento ovládací prvek.

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

Pokud dojde ke změně stavu klávesnice nebo tlačítka myši, QueryContinueDrag vyvolá se událost a určí, jestli chcete pokračovat v přetažení, odstranit data nebo zrušit operaci na základě hodnoty Action vlastnosti události QueryContinueDragEventArgs.

• Pokud hodnota je DragActionContinue, DragOver událost se vyvolá, aby pokračovala v operaci, a GiveFeedback událost se vyvolá 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 se spárují, takže když se myš přesune přes cíl přetažení, dostane uživatel nejaktuálnější zpětnou vazbu o pozici myši.

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

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

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

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

Viz také

• OnQueryContinueDrag(QueryContinueDragEventArgs)