DragDrop.DragOver DragDrop.DragOver DragDrop.DragOver Attached Event

Définition

Se produit en continu pendant qu’un objet est déplacé par glissement dans les limites d’un élément qui est une cible de déplacement.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

Exemples

L'exemple suivant illustre le gestionnaire d'événements DragOver pour un élément Ellipse.The following example shows the DragOver event handler for an Ellipse element. Ce code vérifie que le DataObject déplacé sur l'ellipse contient bien des données de chaîne qui peuvent être converties en Brush.This code checks to see if the DataObject being dragged over the ellipse contains string data that can be converted to a Brush. Si tel est le cas, il attribue à la propriété DragEventArgs.Effects la valeur Copy.If so, it sets the DragEventArgs.Effects property to Copy. Cela indique à la source du glissement que les données peuvent être copiées vers l'ellipse.This indicates to the drag source that the data can be copied to the ellipse. Si les données ne peuvent pas être converties en Brush, la propriété DragEventArgs.Effects prend la valeur None.If the data cannot be converted to a Brush, the DragEventArgs.Effects property is set to None. Cela indique à la source du glissement que l’ellipse n’est pas une cible de dépôt valide pour les données.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

Remarques

Cet événement est déclenché en continu lorsqu’un objet glissé est dans les limites d’un élément qui agit comme cible de déplacement.This event is raised continuously while a dragged object is within the bounds of an element that is acting as a drop target. Cet événement n’est pas déclenché si la propriété AllowDrop de l’élément est false.This event is not raised if the element's AllowDrop property is false.

L’événement DragOver est associé à l’événement GiveFeedback sur la source de glissement.The DragOver event is paired with the GiveFeedback event on the drag source. Dans le gestionnaire d’événements DragOver, vous vérifiez généralement que les données transférées sont dans un format que la cible de déplacement peut traiter.In the DragOver event handler, you typically check that the transferred data is in a format that the drop target can process. Vous pouvez également vérifier si des touches de modification sont enfoncées, ce qui indique généralement si l’utilisateur envisage une action de déplacement ou de copie.You can also check whether any modifier keys are pressed, which typically indicates whether the user intends a move or a copy action. Une fois ces vérifications effectuées, définissez la propriété DragEventArgs.Effects pour notifier la source de glissement de l’effet prévu du dépôt des données.After these checks are performed, you set the DragEventArgs.Effects property to notify the drag source what effect dropping the data will have. La source de glissement reçoit ces informations dans la propriété Effects des arguments d’événement GiveFeedback et peut définir un curseur approprié pour fournir des commentaires à l’utilisateur.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.

Informations sur les événements acheminésRouted Event Information

Champ d’identificateurIdentifier field DragOverEvent
Stratégie de routageRouting strategy PropagationBubbling
déléguéDelegate DragEventHandler

L’événement de tunneling correspondant est PreviewDragOver.The corresponding tunneling event is PreviewDragOver.

S’applique à

Voir aussi