DragDrop.DragOver DragDrop.DragOver DragDrop.DragOver Attached Event

Definition

Tritt fortlaufend auf, während ein Objekt innerhalb der Grenzen eines Elements gezogen wird, das als Ablageziel fungiert.Occurs continuously while an object is dragged within the bounds of an element that is acting as a drop target.

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

Beispiele

Das folgende Beispiel zeigt den DragOver-Ereignishandler für ein Ellipse-Element.The following example shows the DragOver event handler for an Ellipse element. Dieser Code überprüft, ob das über die Ellipse gezogene DataObject Zeichenfolgendaten enthält, die in einen Brush konvertiert werden können.This code checks to see if the DataObject being dragged over the ellipse contains string data that can be converted to a Brush. In diesem Fall legt er die DragEventArgs.Effects-Eigenschaft als Copy fest.If so, it sets the DragEventArgs.Effects property to Copy. Dies zeigt der Ziehquelle an, dass die Daten zur Ellipse kopiert werden können.This indicates to the drag source that the data can be copied to the ellipse. Wenn die Daten nicht in einen Brush konvertiert werden können, wird die Eigenschaft DragEventArgs.Effects auf None festgelegt.If the data cannot be converted to a Brush, the DragEventArgs.Effects property is set to None. Dieses zeigt der Datenquelle an, dass die Ellipse kein gültiges Ablageziel für die Daten darstellt.This indicates to the drag source that the ellipse is not a valid drop target for the data.

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

Hinweise

Dieses Ereignis wird fortlaufend ausgelöst, während sich ein gezogenes Objekt innerhalb der Grenzen eines Elements befindet, das als Ablage Ziel fungiert.This event is raised continuously while a dragged object is within the bounds of an element that is acting as a drop target. Dieses Ereignis wird nicht ausgelöst, wenn die- AllowDrop Eigenschaft des falseElements ist.This event is not raised if the element's AllowDrop property is false.

Das DragOver Ereignis wird mit dem GiveFeedback Ereignis auf der Zieh Quelle gekoppelt.The DragOver event is paired with the GiveFeedback event on the drag source. Im- DragOver Ereignishandler überprüfen Sie in der Regel, ob die übertragenen Daten in einem Format vorliegen, das vom Ablage Ziel verarbeitet werden kann.In the DragOver event handler, you typically check that the transferred data is in a format that the drop target can process. Sie können auch überprüfen, ob Modifizierertasten gedrückt werden, was in der Regel angibt, ob der Benutzer eine verschiebe-oder Kopier Aktion beabsichtigt.You can also check whether any modifier keys are pressed, which typically indicates whether the user intends a move or a copy action. Nachdem diese Prüfungen vorgenommen wurden, legen Sie die DragEventArgs.Effects-Eigenschaft fest, um die Ziehquelle zu benachrichtigen, welche Auswirkungen das Ablegen der Daten hat.After these checks are performed, you set the DragEventArgs.Effects property to notify the drag source what effect dropping the data will have. Die Zieh Quelle empfängt diese Informationen in der Effects -Eigenschaft GiveFeedback der Ereignis Argumente und kann einen geeigneten Cursor festlegen, um dem Benutzer Feedback zu geben.The drag source receives this information in the Effects property of the GiveFeedback event arguments, and can set an appropriate cursor to give feedback to the user.

Informationen zum RoutingereignisRouted Event Information

BezeichnerfeldIdentifier field DragOverEvent
Routing StrategieRouting strategy BlasenBubbling
delegateDelegate DragEventHandler

Das entsprechende tunnelingereignis ist PreviewDragOver.The corresponding tunneling event is PreviewDragOver.

Gilt für:

Siehe auch