DragDrop.Drop DragDrop.Drop DragDrop.Drop Attached Event

Definition

Tritt auf, wenn ein Objekt in den Begrenzungen eines Elements abgelegt wird, das als Drop-Ziel fungiert.Occurs when an object is dropped within the bounds of an element that is acting as a drop target.

see AddDropHandler, and RemoveDropHandler
see AddDropHandler, and RemoveDropHandler
see AddDropHandler, and RemoveDropHandler

Beispiele

Das folgende Beispiel zeigt den Drop-Ereignishandler für ein Ellipse-Element.The following example shows the Drop event handler for an Ellipse element. Dieser Code wendet die Auswirkungen des Drag & Drop-Vorgangs an.This code applies the effects of the drag-and-drop operation. Er überprüft, ob das DataObject, das über die Ellipse gezogen wird, Zeichenfolgendaten enthält, die in einen Brush konvertiert werden können.It checks to see if the DataObject being dragged over the ellipse contains string data that can be converted to a Brush. In diesem Fall wird der Brush auf die Ellipse angewendet.If so, the Brush is applied to the ellipse. Wenn die Daten nicht in einen Brush konvertiert werden können, wird keine Aktion ausgeführt.If the data cannot be converted to a Brush, no action is performed.

private void ellipse_Drop(object sender, DragEventArgs e)
{
    Ellipse ellipse = sender as Ellipse;
    if (ellipse != null)
    {
        // If the DataObject contains string data, extract it.
        if (e.Data.GetDataPresent(DataFormats.StringFormat))
        {
            string dataString = (string)e.Data.GetData(DataFormats.StringFormat);

            // If the string can be converted into a Brush, 
            // convert it and apply it to the ellipse.
            BrushConverter converter = new BrushConverter();
            if (converter.IsValid(dataString))
            {
                Brush newFill = (Brush)converter.ConvertFromString(dataString);
                ellipse.Fill = newFill;
            }
        }
    }
}
Private Sub Ellipse_Drop(ByVal sender As System.Object, ByVal e As System.Windows.DragEventArgs)
    Dim ellipse = TryCast(sender, Ellipse)
    If ellipse IsNot Nothing Then

        ' If the DataObject contains string data, extract it.
        If e.Data.GetDataPresent(DataFormats.StringFormat) Then
            Dim dataString = e.Data.GetData(DataFormats.StringFormat)

            ' If the string can be converted into a Brush, convert it.
            Dim converter As New BrushConverter()
            If converter.IsValid(dataString) Then
                Dim newFill As Brush = CType(converter.ConvertFromString(dataString), Brush)
                ellipse.Fill = newFill
            End If
        End If
    End If
End Sub

Hinweise

Das Drop -Ereignis wird einmal ausgelöst, wenn ein Objekt innerhalb der Begrenzungen eines Elements abgelegt wird, das als Ablage Ziel fungiert.The Drop event is raised once when an object is dropped within the bounds of an element that is acting as a drop target. Dieses Ereignis wird nicht ausgelöst, wenn die- AllowDrop Eigenschaft des falseElements ist.This event is not raised if the element's AllowDrop property is false. Dieses Ereignis beendet den Drag & Drop-Vorgang.This event ends the drag-and-drop operation.

Im- DataObject Ereignishandler extrahieren Sie die übertragenen Daten aus dem und führen eine beliebige Verarbeitung der Daten durch, die für die Anwendung erforderlich sind. DropIn the Drop event handler, you extract the transferred data from the DataObject and perform any processing of the data that your application requires. Legen Sie die- DragEventArgs.Effects Eigenschaft Drop im-Ereignishandler fest, um die Zieh Quelle der Auswirkungen des Löschens (z. b. Kopieren oder verschieben) zu benachrichtigen.To notify the drag source of the effect of the drop, such as a copy or move, set the DragEventArgs.Effects property in the Drop event handler. Der Wert dieser Eigenschaft ist der Rückgabewert DoDragDrop der Methode, die den Drag & Drop-Vorgang initiiert hat.The value of this property is the return value of the DoDragDrop method that initiated the drag-and-drop operation. Wenn der zurückgegebene Wert nicht mit einem der allowedEffects im DoDragDrop-Befehl angegebenen identisch ist, wird der Drag & Drop-Vorgang nicht ausgeführt.If the value that is returned does not match one of the allowedEffects specified in the call to DoDragDrop, the drag-and-drop operation is not performed. Der Anfangswert der DragEventArgs.Effects -Eigenschaft ist identisch allowedEffects mit dem, der im Aufrufe der DoDragDrop -Methode angegeben ist.The initial value of the DragEventArgs.Effects property is the same as the allowedEffects specified in the call to the DoDragDrop method. Wenn Sie die DragEventArgs.Effects -Eigenschaft nicht festlegen, wird dieser Anfangswert zurückgegeben, und es wird davon ausgegangen allowedEffects , dass eine der aufgetreten ist.If you do not set the DragEventArgs.Effects property, this initial value is returned and it is assumed that one the allowedEffects occurred.

Informationen zum RoutingereignisRouted Event Information

BezeichnerfeldIdentifier field DropEvent
Routing StrategieRouting strategy BlasenBubbling
delegateDelegate DragEventHandler

Das entsprechende tunnelingereignis ist PreviewDrop.The corresponding tunneling event is PreviewDrop.

Gilt für:

Siehe auch