DragDrop.Drop Événement attaché

Définition

Espace de noms:

System.Windows

Assembly:

PresentationCore.dll

Se produit quand un objet est déposé dans les limites d’un élément qui fait office de cible de dépôt.

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. Ce code applique les effets de l’opération glisser-déplacer. 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. Dans ce cas, le Brush est appliqué à l'ellipse. Si les données ne peuvent pas être converties en Brush, aucune action n'est effectuée.

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 seule fois lorsqu’un objet est supprimé dans les limites d’un élément qui agit comme une cible de déplacement. Cet événement n’est pas déclenché si la propriété de l’élément AllowDrop est false. Cet événement met fin à l’opération glisser-déplacer.

Dans le Drop gestionnaire d’événements, vous extrayez les données transférées du DataObject et effectuez tout traitement des données dont votre application a besoin. Pour notifier la source de glissement de l’effet du déplacement, tel qu’une copie ou un déplacement, définissez la DragEventArgs.Effects propriété dans le Drop gestionnaire d’événements. La valeur de cette propriété est la valeur de retour de la DoDragDrop méthode qui a lancé l’opération de glisser-déplacer. Si la valeur retournée ne correspond pas à l’un allowedEffects des spécifiés dans l’appel à DoDragDrop, l’opération glisser-déplacer n’est pas effectuée. La valeur initiale de la DragEventArgs.Effects propriété est la même que celle allowedEffects spécifiée dans l’appel à la DoDragDrop méthode . Si vous ne définissez pas la DragEventArgs.Effects propriété, cette valeur initiale est retournée et il est supposé que l’une a allowedEffects eu lieu.

Informations sur les événements acheminés

Champ Identificateur	DropEvent
Stratégie de routage	Bouillonnant
Délégué	DragEventHandler

L’événement de tunneling correspondant est PreviewDrop.

Voir aussi

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