DragDrop.Drop Evento adjunto

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationCore.dll

Se produce cuando un objeto se coloca dentro de los límites de un elemento que actúa como un destino para colocar.

see AddDropHandler, and RemoveDropHandler

see AddDropHandler, and RemoveDropHandler

see AddDropHandler, and RemoveDropHandler

Ejemplos

El ejemplo siguiente muestra el controlador de eventos Drop para un elemento Ellipse. Este código aplica los efectos de la operación de arrastrar y colocar. Comprueba si el DataObject que se está arrastrando sobre la elipse contiene datos de cadena que se pueden convertir en un Brush. Si es así, el Brush se aplica a la elipse. Si los datos no se pueden convertir en un Brush, no se lleva a cabo ninguna acción.

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

Comentarios

El Drop evento se genera una vez cuando un objeto se quita dentro de los límites de un elemento que actúa como destino de colocación. Este evento no se genera si la propiedad del AllowDrop elemento es false. Este evento finaliza la operación de arrastrar y colocar.

En el Drop controlador de eventos, extrae los datos transferidos de DataObject y realiza cualquier procesamiento de los datos que requiere la aplicación. Para notificar al origen de arrastre el efecto de la colocación, como una copia o un movimiento, establezca la DragEventArgs.Effects propiedad en el Drop controlador de eventos. El valor de esta propiedad es el valor devuelto del DoDragDrop método que inició la operación de arrastrar y colocar. Si el valor devuelto no coincide con uno de los allowedEffects especificados en la llamada a DoDragDrop, no se realiza la operación de arrastrar y colocar. El valor inicial de la DragEventArgs.Effects propiedad es el mismo que el allowedEffects especificado en la llamada al DoDragDrop método . Si no establece la DragEventArgs.Effects propiedad , se devuelve este valor inicial y se supone que se produjo uno allowedEffects .

Información sobre eventos enrutados

Campo identificador	DropEvent
Estrategia de enrutamiento	Burbujeante
Delegado	DragEventHandler

El evento de tunelización correspondiente es PreviewDrop.

Consulte también

• DragOver
• Drop
• AddDropHandler(DependencyObject, DragEventHandler)
• RemoveDropHandler(DependencyObject, DragEventHandler)