Freigeben über

Control.DragLeave-Ereignis

  • Artikel

Tritt ein, wenn ein Objekt aus dem Bereich des Steuerelements gezogen wird.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Event DragLeave As EventHandler
'Usage
Dim instance As Control
Dim handler As EventHandler

AddHandler instance.DragLeave, handler

public event EventHandler DragLeave

public:
event EventHandler^ DragLeave {
    void add (EventHandler^ value);
    void remove (EventHandler^ value);
}

/** @event */
public void add_DragLeave (EventHandler value)

/** @event */
public void remove_DragLeave (EventHandler value)

JScript unterstützt die Verwendung von Ereignissen, aber nicht die Deklaration von neuen Ereignissen.

Hinweise

Das DragLeave-Ereignis wird ausgelöst, wenn der Cursor aus dem Steuerelement bewegt oder der aktuelle Drag & Drop-Vorgang abgebrochen wird.

Nachfolgend wird beschrieben, wie und wann Ereignisse für Drag & Drop-Vorgänge ausgelöst werden.

Die DoDragDrop-Methode bestimmt das Steuerelement an der aktuellen Cursorposition. Anschließend überprüft sie, ob es sich bei diesem Steuerelement um ein gültiges Ablageziel handelt.

Wenn es sich bei dem Steuerelement um ein gültiges Ablageziel handelt, wird das GiveFeedback-Ereignis mit dem angegebenen Drag & Drop-Effekt ausgelöst. Eine Liste der Drag & Drop-Effekte finden Sie unter der DragDropEffects-Enumeration.

Änderungen der Mauszeigerposition, des Tastaturzustands und des Zustands der Maustasten werden nachverfolgt.

  • Wenn die Benutzeraktion das Fenster verlässt, wird das DragLeave-Ereignis ausgelöst.

  • Wenn der Mauszeiger in ein anderes Steuerelement bewegt wird, wird DragEnter für dieses Steuerelement ausgelöst.

  • Wenn die Maus bewegt wird, ohne das Steuerelement zu verlassen, wird das DragOver-Ereignis ausgelöst.

Wenn der Tastatur- oder Maustastenzustand geändert wird, wird das QueryContinueDrag-Ereignis ausgelöst, das entsprechend dem Wert der Action-Eigenschaft von QueryContinueDragEventArgs des Ereignisses bestimmt, ob der Ziehvorgang fortgesetzt, die Daten abgelegt oder der Vorgang abgebrochen werden soll.

  • Wenn der Wert von DragActionContinue ist, wird das DragOver-Ereignis ausgelöst, um den Vorgang fortzusetzen. Außerdem wird das GiveFeedback-Ereignis ausgelöst, damit eine entsprechende visuelle Rückmeldung festgelegt werden kann. Eine Liste der gültigen Ablageeffekte finden Sie unter der DragDropEffects-Enumeration.

    Hinweis

    Das DragOver-Ereignis und das GiveFeedback-Ereignis werden zusammengefasst, damit Benutzer beim Bewegen der Maus über das Ablageziel eine aktuelle Rückmeldung von der Mausposition erhalten.

  • Wenn der Wert von DragActionDrop ist, wird der Wert des Ablageeffekts an die Quelle zurückgegeben. Die Quellanwendung kann dadurch den entsprechenden Vorgang für die Quelldaten ausführen, z. B. die Daten ausschneiden, wenn es sich um einen Verschiebevorgang handelt.

  • Wenn der Wert von DragActionCancel ist, wird das DragLeave-Ereignis ausgelöst.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln von Ereignissen.

Beispiel

Im folgenden Beispiel wird ein Drag & Drop-Vorgang zwischen zwei ListBox-Steuerelementen veranschaulicht. In diesem Beispiel wird die DoDragDrop-Methode aufgerufen, wenn der Ziehvorgang begonnen wird. Der Ziehvorgang beginnt, wenn die Maus um mehr als SystemInformation.DragSize von der Mausposition während des MouseDown-Ereignisses verschoben wurde. Mit der IndexFromPoint-Methode kann der Index des im MouseDown-Ereignis zu ziehenden Elements bestimmt werden.

Im Beispiel wird außerdem die Verwendung eines benutzerdefinierten Cursors bei einem Drag & Drop-Vorgang veranschaulicht. Bei diesem Beispiel müssen die beiden Cursordateien 3dwarro.cur und 3dwno.cur für den benutzerdefinierten Ziehcursor bzw. den Cursor, der angezeigt wird, wenn ein Ablegen nicht möglich ist, im Anwendungsverzeichnis vorhanden sein. Ein benutzerdefinierter Cursor wird verwendet, wenn die UseCustomCursorsCheckCheckBox aktiviert wurde. Ein benutzerdefinierter Cursor wird im GiveFeedback-Ereignishandler festgelegt.

Der Tastaturzustand wird vom DragOver-Ereignishandler für die rechte ListBox ausgewertet, um je nach Zustand der UMSCHALTTASTE oder von STRG, ALT bzw. STRG+ALT den auszuführenden Ziehvorgang zu ermitteln. Außerdem wird beim DragOver-Ereignis auch die Position in der ListBox bestimmt, für die der Ablegevorgang ausgeführt wird. Wenn die abzulegenden Daten kein String sind, wird DragEventArgs.Effect in DragDropEffects auf None festgelegt. Abschließend wird der Status des Ablegevorgangs im DropLocationLabelLabel angezeigt.

Die in der rechten ListBox abzulegenden Daten werden im DragDrop-Ereignishandler bestimmt. Der String-Wert wird an der entsprechenden Stelle in die ListBox eingefügt. Wenn der Ziehvorgang außerhalb der Grenzen des Formulars beendet wird, wird der Drag & Drop-Vorgang im QueryContinueDrag-Ereignishandler abgebrochen.

In diesem Codeauszug wird die Verwendung des DragLeave-Ereignisses veranschaulicht. Das vollständige Codebeispiel finden Sie unter der DoDragDrop-Methode.

Private Sub ListDragTarget_DragLeave(ByVal sender As Object, ByVal e As System.EventArgs) Handles ListDragTarget.DragLeave

    ' Reset the label text.
    DropLocationLabel.Text = "None"
End Sub

private void ListDragTarget_DragLeave(object sender, System.EventArgs e) {
    // Reset the label text.
    DropLocationLabel.Text = "None";
}

void ListDragTarget_DragLeave( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
  // Reset the label text.
   DropLocationLabel->Text = "None";
}

private void listDragTarget_DragLeave(Object sender, System.EventArgs e)
{
    // Reset the label text.
    dropLocationLabel.set_Text("None");
} //listDragTarget_DragLeave

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
OnDragLeave