DragDrop.DragOver Evento Anexado

Definição

Ocorre continuamente enquanto um objeto é arrastado dentro dos limites de um elemento que atua como alvo de queda.

see AddDragOverHandler, and RemoveDragOverHandler
see AddDragOverHandler, and RemoveDragOverHandler
see AddDragOverHandler, and RemoveDragOverHandler

Exemplos

O exemplo seguinte mostra o DragOver gestor de eventos para um Ellipse elemento. Este código verifica se o DataObject ser arrastado sobre a elipse contém dados de cadeia que podem ser convertidos para um Brush. Se assim for, define a DragEventArgs.Effects propriedade para Copy. Isto indica à fonte de arrasto que os dados podem ser copiados para a elipse. Se os dados não puderem ser convertidos para um Brush, a DragEventArgs.Effects propriedade é definida para None. Isto indica à fonte de arrastar que a elipse não é um alvo 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

Observações

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

O DragOver evento é emparelhado com o GiveFeedback evento na fonte de arrasto. No gestor de DragOver eventos, normalmente verifica-se se os dados transferidos estão num formato que o drop target consiga processar. Também pode verificar se alguma tecla modificadora está pressionada, o que normalmente indica se o utilizador pretende um movimento ou uma ação de cópia. Depois destas verificações, defines a DragEventArgs.Effects propriedade para notificar a fonte do arrasto qual o efeito que a largada dos dados terá para ser. A fonte de arrastar recebe esta informação na Effects propriedade dos GiveFeedback argumentos do evento e pode definir um cursor apropriado para dar feedback ao utilizador.

Informação sobre Eventos Roteados

Iteme Value
Campo identificador DragOverEvent
Estratégia de encaminhamento Borbulhar
Delegar DragEventHandler

O evento correspondente de tunelamento é PreviewDragOver.

Aplica-se a

Ver também