DragDrop.Drop Événement attaché

Définition

Se produit quand un objet est déposé dans les limites d’un élément qui fait office de cible de dépôt.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

Exemples

L'exemple suivant illustre le gestionnaire d'événements Drop pour un élément Ellipse.The following example shows the Drop event handler for an Ellipse element. Ce code applique les effets de l’opération de glisser-déplacer.This code applies the effects of the drag-and-drop operation. Il vérifie que le DataObject déplacé sur l'ellipse contient bien des données de chaîne qui peuvent être converties en Brush.It checks to see if the DataObject being dragged over the ellipse contains string data that can be converted to a Brush. Dans ce cas, le Brush est appliqué à l'ellipse.If so, the Brush is applied to the ellipse. Si les données ne peuvent pas être converties en Brush, aucune action n'est effectuée.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

Remarques

L’événement Drop est déclenché une fois quand un objet est déplacé dans les limites d’un élément qui agit comme cible de déplacement.The Drop event is raised once when an object is dropped within the bounds of an element that is acting as a drop target. Cet événement n’est pas déclenché si la propriété AllowDrop de l’élément est false.This event is not raised if the element's AllowDrop property is false. Cet événement met fin à l’opération de glisser-déplacer.This event ends the drag-and-drop operation.

Dans le gestionnaire d’événements Drop, vous extrayez les données transférées à partir de la DataObject et effectuez le traitement des données requises par votre application.In the Drop event handler, you extract the transferred data from the DataObject and perform any processing of the data that your application requires. Pour notifier la source de glissement de l’effet de la suppression, par exemple une copie ou un déplacement, définissez la propriété DragEventArgs.Effects dans le gestionnaire d’événements Drop.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. La valeur de cette propriété est la valeur de retour de la méthode DoDragDrop qui a initié l’opération de glisser-déplacer.The value of this property is the return value of the DoDragDrop method that initiated the drag-and-drop operation. Si la valeur retournée ne correspond pas à l’une des allowedEffects spécifiée dans l’appel à DoDragDrop, l’opération de glisser-déplacer n’est pas effectuée.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. La valeur initiale de la propriété DragEventArgs.Effects est identique à la allowedEffects spécifiée dans l’appel à la méthode DoDragDrop.The initial value of the DragEventArgs.Effects property is the same as the allowedEffects specified in the call to the DoDragDrop method. Si vous ne définissez pas la propriété DragEventArgs.Effects, cette valeur initiale est retournée et il est supposé qu’une allowedEffects s’est produite.If you do not set the DragEventArgs.Effects property, this initial value is returned and it is assumed that one the allowedEffects occurred.

Informations sur les événements acheminésRouted Event Information

Champ d’identificateurIdentifier field DropEvent
Stratégie de routageRouting strategy PropagationBubbling
déléguéDelegate DragEventHandler

L’événement de tunneling correspondant est PreviewDrop.The corresponding tunneling event is PreviewDrop.

S’applique à

Voir aussi