Sdílet prostřednictvím

DragDrop.DragOver Přidružená událost

Definice

Obor názvů:
System.Windows
Sestavení:
PresentationCore.dll

Probíhá nepřetržitě, když je objekt přetažen v mezích elementu, který funguje jako cíl přetažení.

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

Příklady

Následující příklad ukazuje obslužnou Ellipse rutinu DragOver události pro element. Tento kód zkontroluje, jestli DataObject přetahování přes tři tečky obsahuje řetězcová data, která lze převést na Brush. Pokud ano, nastaví DragEventArgs.Effects vlastnost na Copy. To značí zdroj přetažení, že lze data zkopírovat do tří teček. Pokud data nelze převést na , BrushDragEventArgs.Effects vlastnost je nastavena na None. To značí zdroj přetažení, že tři tečky nejsou platným cílem přetažení dat.

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

Poznámky

Tato událost je vyvolána nepřetržitě, zatímco přetažený objekt je v mezích prvku, který funguje jako cíl přetažení. Tato událost není vyvolána, pokud je falsevlastnost elementu AllowDrop .

Událost DragOver se spáruje s událostí GiveFeedback ve zdroji přetažení. V obslužné rutině DragOver události obvykle zkontrolujete, že přenášená data jsou ve formátu, který může cíl přetažení zpracovat. Můžete také zkontrolovat, jestli jsou stisknuty nějaké modifikační klávesy, což obvykle značí, jestli uživatel hodlá přesunout nebo zkopírovat akci. Po provedení těchto kontrol nastavíte DragEventArgs.Effects vlastnost tak, aby upozorňovat zdroj přetažení, jaký efekt budou mít data. Zdroj přetažení obdrží tyto informace ve Effects vlastnosti GiveFeedback argumentů události a může nastavit odpovídající kurzor, který uživateli poskytne zpětnou vazbu.

Informace o směrované události

Položka Hodnota
Pole Identifikátor DragOverEvent
Strategie směrování Bublající
Delegát DragEventHandler

Odpovídající událost tunelování je PreviewDragOver.

Platí pro

Viz také