DragDrop.Drop Événement attaché
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit lorsqu’un objet est supprimé dans les limites d’un élément qui agit comme une cible de déplacement.
see AddDropHandler, and RemoveDropHandlersee AddDropHandler, and RemoveDropHandlersee AddDropHandler, and RemoveDropHandlerExemples
L’exemple suivant montre le Drop gestionnaire d’événements d’un Ellipse élément. Ce code applique les effets de l’opération de glisser-déplacer. Il vérifie si le DataObject fait d’être déplacé sur l’ellipse contient des données de chaîne qui peuvent être converties en un Brush. Dans ce cas, l’ellipse Brush est appliquée. Si les données ne peuvent pas être converties en un 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 fois lorsqu’un objet est supprimé dans les limites d’un élément agissant en tant que 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 de glisser-déplacer.
Dans le Drop gestionnaire d’événements, vous extrayez les données transférées et DataObject effectuez tout traitement des données requises par votre application. Pour notifier la source de glissement de l’effet de la liste déroulante, telle 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 glisser-déplacer. Si la valeur retournée ne correspond pas à DoDragDropl’une allowedEffects des valeurs spécifiées dans l’appel, 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é qu’une valeur allowedEffects s’est produite.
Informations sur les événements routés
| Élément | Valeur |
|---|---|
| Champ d’identificateur | DropEvent |
| Stratégie de routage | Bouillonnant |
| Délégué | DragEventHandler |
L’événement de tunneling correspondant est PreviewDrop.
