DragDrop.Drop Toegevoegde gebeurtenis
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Treedt op wanneer een object binnen de grenzen van een element valt dat fungeert als een doel voor neerzetten.
see AddDropHandler, and RemoveDropHandlersee AddDropHandler, and RemoveDropHandlersee AddDropHandler, and RemoveDropHandlerVoorbeelden
In het volgende voorbeeld ziet u de Drop gebeurtenis-handler voor een Ellipse element. Met deze code worden de effecten van de bewerking slepen en neerzetten toegepast. Er wordt gecontroleerd of het DataObject te slepen over het beletselteken tekenreeksgegevens bevat die kunnen worden geconverteerd naar een Brush. Zo ja, dan wordt het Brush toegepast op het beletselteken. Als de gegevens niet naar een Brushkunnen worden geconverteerd, wordt er geen actie uitgevoerd.
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
Opmerkingen
De Drop gebeurtenis wordt eenmaal gegenereerd wanneer een object wordt verwijderd binnen de grenzen van een element dat fungeert als een doel voor neerzetten. Deze gebeurtenis wordt niet gegenereerd als de eigenschap van AllowDrop het element is false. Met deze gebeurtenis wordt de bewerking slepen en neerzetten beëindigd.
In de Drop gebeurtenis-handler extraheert u de overgedragen gegevens uit de DataObject en voert u eventuele verwerking uit van de gegevens die uw toepassing nodig heeft. Stel de eigenschap in de gebeurtenis-handler in DragEventArgs.Effects om de bron van slepen op de hoogte te stellen van het effect van de neerzetbewerking, zoals een kopie of verplaatsingDrop. De waarde van deze eigenschap is de retourwaarde van de DoDragDrop methode waarmee de bewerking slepen en neerzetten is gestart. Als de geretourneerde waarde niet overeenkomt met een van de allowedEffects opgegeven waarden in de aanroep, DoDragDropwordt de bewerking slepen en neerzetten niet uitgevoerd. De initiële waarde van de DragEventArgs.Effects eigenschap is hetzelfde als de allowedEffects waarde die is opgegeven in de aanroep van de DoDragDrop methode. Als u de DragEventArgs.Effects eigenschap niet instelt, wordt deze initiële waarde geretourneerd en wordt ervan uitgegaan dat er een is allowedEffects opgetreden.
Gerouteerde gebeurtenisgegevens
| Item | Waarde |
|---|---|
| Id-veld | DropEvent |
| Routeringsstrategie | Borrelen |
| Gedelegeerde | DragEventHandler |
De bijbehorende tunneling-gebeurtenis is PreviewDrop.
