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.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

Die Drop Ereignis wird ausgelöst, sobald bei der ein Objekt innerhalb der Grenzen eines Elements abgelegt wird, das als Ablageziel 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 des Elements des AllowDrop Eigenschaft false.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.

In der Drop Ereignishandler, extrahieren Sie die übertragenen Daten aus der DataObject und verarbeitet die Daten, die Ihre Anwendung erfordert.In the Drop event handler, you extract the transferred data from the DataObject and perform any processing of the data that your application requires. Benachrichtigen Sie die Quelle des Ziehvorgangs der Auswirkungen das ablegen, z. B. kopieren oder verschieben, legen Sie die DragEventArgs.Effects -Eigenschaft in der Drop -Ereignishandler.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 von der DoDragDrop -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. Entspricht der zurückgegebene Wert nicht eines der allowedEffects im Aufruf angegeben DoDragDrop, der Drag & Drop-Vorgang nicht ausgeführt wird.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 mit der allowedEffects angegeben, die im Aufruf von der DoDragDrop Methode.The initial value of the DragEventArgs.Effects property is the same as the allowedEffects specified in the call to the DoDragDrop method. Wenn Sie nicht Festlegen der DragEventArgs.Effects -Eigenschaft dieser anfänglichen Wert wird zurückgegeben, und wird davon ausgegangen, dass eine der allowedEffects 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

Feld "ID"Identifier field DropEvent
Routing-StrategieRouting strategy BubblingBubbling
delegateDelegate DragEventHandler

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

Gilt für:

Siehe auch