DragDrop.Drop Evento Anexado
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando um objeto é largado dentro dos limites de um elemento que atua como alvo de queda.
see AddDropHandler, and RemoveDropHandlersee AddDropHandler, and RemoveDropHandlersee AddDropHandler, and RemoveDropHandlerExemplos
O exemplo seguinte mostra o Drop gestor de eventos para um Ellipse elemento. Este código aplica os efeitos da operação de arrastar e largar. Verifica se o DataObject ser arrastado sobre a elipse contém dados de cadeia que podem ser convertidos em um Brush. Se sim, aplica-se à Brush elipse. Se os dados não puderem ser convertidos para um Brush, não é realizada nenhuma ação.
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
Observações
O Drop evento é ativado uma vez quando um objeto é largado dentro dos limites de um elemento que atua como alvo de queda. Este evento não é elevado se a propriedade do AllowDrop elemento for false. Este evento termina a operação de arrastar e largar.
No Drop gestor de eventos, extrai os dados transferidos e DataObject realiza qualquer processamento dos dados que a sua aplicação necessite. Para notificar a fonte do arrasto sobre o efeito do drop, como uma cópia ou movimento, defina a DragEventArgs.Effects propriedade no Drop gestor de eventos. O valor desta propriedade é o valor de retorno do DoDragDrop método que iniciou a operação de arrastar e largar. Se o valor devolvido não corresponder a um dos allowedEffects especificados na chamada para DoDragDrop, a operação de arrastar e largar não é realizada. O valor inicial da DragEventArgs.Effects propriedade é o mesmo especificado allowedEffects na chamada ao DoDragDrop método. Se não definir a DragEventArgs.Effects propriedade, este valor inicial é devolvido e assume-se que um dos allowedEffects ocorreu.
Informação sobre Eventos Roteados
| Iteme | Value |
|---|---|
| Campo identificador | DropEvent |
| Estratégia de encaminhamento | Borbulhar |
| Delegar | DragEventHandler |
O evento correspondente de tunelamento é PreviewDrop.
