Freigeben über

Control.DragEnter-Ereignis

  • Artikel

Tritt ein, wenn ein Objekt in den Bereich des Steuerelements gezogen wird.

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

Syntax

'Declaration
Public Event DragEnter As DragEventHandler
'Usage
Dim instance As Control
Dim handler As DragEventHandler

AddHandler instance.DragEnter, handler

public event DragEventHandler DragEnter

public:
event DragEventHandler^ DragEnter {
    void add (DragEventHandler^ value);
    void remove (DragEventHandler^ value);
}

/** @event */
public void add_DragEnter (DragEventHandler value)

/** @event */
public void remove_DragEnter (DragEventHandler value)

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

Hinweise

Das DragEnter-Ereignis wird ausgelöst, wenn während eines Drag & Drop-Vorgangs der Mauszeiger über das Steuerelement bewegt wird.

Hinweis

Wenn Sie in Versionen vor Microsoft .NET Framework, Version 2.0 ein UserControl mit einem DragEnter-Ereignis und einem DragDrop-Ereignis auf einem Windows Form abgelegt haben und zur Entwurfszeit ein Element auf das UserControl gezogen haben, wurde das DropDrop-Ereignis und das DropEnter-Ereignis ausgelöst. Wenn Sie allerdings die Projektmappe schließen und erneut öffnen, werden das DragEnter-Ereignis und das DragDrop-Ereignis nicht mehr ausgelöst.

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.

    Hinweis

    Die X-Eigenschaft und die Y-Eigenschaft der DragEventArgs geben Bildschirmkoordinaten an, nicht Clientkoordinaten. Die folgende Visual C#-Codezeile wandelt die Eigenschaften in einen Client-Point um:

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 DragEnter-Ereignisses veranschaulicht. Das vollständige Codebeispiel finden Sie unter der DoDragDrop-Methode.

Private Sub ListDragTarget_DragEnter(ByVal sender As Object, ByVal e As DragEventArgs) Handles ListDragTarget.DragEnter

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

private void ListDragTarget_DragEnter(object sender, System.Windows.Forms.DragEventArgs e) {
    // Reset the label text.
    DropLocationLabel.Text = "None";
}

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

private void listDragTarget_DragEnter(Object sender, 
    System.Windows.Forms.DragEventArgs e)
{
    // Reset the label text.
    dropLocationLabel.set_Text("None");
} //listDragTarget_DragEnter

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
OnDragEnter