DragDrop.DragOver 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 continuamente enquanto um objeto é arrastado dentro dos limites de um elemento que está atuando como uma reprodução automática.

see AddDragOverHandler, and RemoveDragOverHandler

see AddDragOverHandler, and RemoveDragOverHandler

see AddDragOverHandler, and RemoveDragOverHandler

Exemplos

O exemplo a seguir mostra o DragOver manipulador de eventos de um Ellipse elemento . Esse código 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, ele define a DragEventArgs.Effects propriedade como Copy. Isso indica à origem do arrasto que os dados podem ser copiados para a elipse. Se os dados não puderem ser convertidos em um Brush, a DragEventArgs.Effects propriedade será definida como None. Isso indica à origem do arrasto que a elipse não é um destino de soltar válido para os dados.

private void ellipse_DragOver(object sender, DragEventArgs e)
{
    e.Effects = DragDropEffects.None;

    // 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, allow copying.
        BrushConverter converter = new BrushConverter();
        if (converter.IsValid(dataString))
        {
            e.Effects = DragDropEffects.Copy | DragDropEffects.Move;
        }
    }
}

Private Sub Ellipse_DragOver(ByVal sender As System.Object, ByVal e As System.Windows.DragEventArgs)
    e.Effects = DragDropEffects.None

    ' 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
            e.Effects = DragDropEffects.Copy Or DragDropEffects.Move
        End If
    End If
End Sub

Comentários

Esse evento é gerado continuamente enquanto um objeto arrastado está 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.

O DragOver evento é emparelhado com o GiveFeedback evento na origem de arrastar. DragOver No manipulador de eventos, você normalmente marcar que os dados transferidos estão em um formato que o destino de soltar pode processar. Você também pode marcar se as teclas modificadoras são pressionadas, o que normalmente indica se o usuário pretende mover ou copiar uma ação. Depois que essas verificações forem executadas, você definirá a DragEventArgs.Effects propriedade para notificar a fonte de arrastar qual efeito a remoção dos dados terá. A fonte de arrastar recebe essas informações na Effects propriedade dos argumentos do GiveFeedback evento e pode definir um cursor apropriado para fornecer comentários ao usuário.

Informações de evento encaminhado


Campo Identificador	DragOverEvent
Estratégia de roteamento	Borbulhando
Delegar	DragEventHandler

O evento de túnel correspondente é PreviewDragOver.

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