DragDrop.Drop Evento anexado

Referência

Definição

Namespace:: System.Windows

Assembly:: PresentationCore.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Ocorre quando um objeto é solto nos limites de um elemento que está atuando como uma reprodução automática.

see AddDropHandler, and RemoveDropHandler

see AddDropHandler, and RemoveDropHandler

see AddDropHandler, and RemoveDropHandler

Exemplos

O exemplo a seguir mostra o Drop manipulador de eventos de um Ellipse elemento . Esse código aplica os efeitos da operação de arrastar e soltar. Ele verifica se o DataObject que está sendo arrastado sobre a elipse contém dados de cadeia de caracteres que podem ser convertidos em um Brush. Nesse caso, o Brush é aplicado à elipse. Se os dados não puderem ser convertidos em um Brush, nenhuma ação será executada.

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

Comentários

O Drop evento é gerado uma vez quando um objeto é descartado dentro dos limites de um elemento que está agindo como um destino de soltar. Esse evento não será gerado se a propriedade do AllowDrop elemento for false. Esse evento encerra a operação de arrastar e soltar.

Drop No manipulador de eventos, você extrai os dados transferidos do DataObject e executa qualquer processamento dos dados exigidos pelo aplicativo. Para notificar a origem do arrastar do efeito da queda, como uma cópia ou movimentação, defina a DragEventArgs.Effects propriedade no Drop manipulador de eventos. O valor dessa propriedade é o valor retornado do DoDragDrop método que iniciou a operação de arrastar e soltar. Se o valor retornado não corresponder a allowedEffects um dos especificados na chamada para DoDragDrop, a operação de arrastar e soltar não será executada. O valor inicial da DragEventArgs.Effects propriedade é o mesmo que o allowedEffects especificado na chamada para o DoDragDrop método . Se você não definir a DragEventArgs.Effects propriedade , esse valor inicial será retornado e supõe-se que um ocorreu allowedEffects .

Informações de evento encaminhado


Campo Identificador	DropEvent
Estratégia de roteamento	Borbulhando
Delegar	DragEventHandler

O evento de túnel correspondente é PreviewDrop.

Aplica-se a

Produto	Versões
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Compartilhar via