Intersoft ClientUI Documentation
DragEnter Event (DropTargetBehavior)



Intersoft.Client.UI.Controls.Interactivity Namespace > DropTargetBehavior Class : DragEnter Event
Occurs when drag drop is entering drop target.
Syntax
Public Event DragEnter As DragEventHandler
Dim instance As DropTargetBehavior
Dim handler As DragEventHandler
 
AddHandler instance.DragEnter, handler
public event DragEventHandler DragEnter
public:
event DragEventHandler^ DragEnter
Event Data

The event handler receives an argument of type DragEventArgs containing data related to this event. The following DragEventArgs properties provide information specific to this event.

PropertyDescription
AllowedEffects Gets allowed effects.
Data Gets data carried.
Effects Gets current drag effects.
Handled (Inherited from Intersoft.Client.Framework.ISRoutedEventArgs) Gets or sets a value that indicates the present state of the event handling for a routed event as it travels the route.
HandledBy (Inherited from Intersoft.Client.Framework.ISRoutedEventArgs)Gets or sets the source object that handles this event.
IsHandledByPrimitive (Inherited from Intersoft.Client.Framework.ISRoutedEventArgs)Determines whether this event is handled internally by control infrastructure.
KeyStates Gets current key states.
OriginalSource (Inherited from Intersoft.Client.Framework.ISRoutedEventArgs)Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class.
RoutedEvent (Inherited from Intersoft.Client.Framework.ISRoutedEventArgs)Gets or sets the RoutedEvent associated with this RoutedEventArgs instance.
Source (Inherited from Intersoft.Client.Framework.ISRoutedEventArgs) Gets or sets a reference to the object that raised the event.
Remarks

This event raised when an object is entering the drop target.

Example

The following code shows how to change the tooltip at DragEnter event. 

All drag-drop events are built on routed event architecture including the DragEnterEvent. To learn more about routed event, see Routed Events overview.
XAML
Copy Code 
<StackPanel HorizontalAlignment="Left" VerticalAlignment="Top">
    <i:Interaction.Behaviors>
        <Intersoft:DragDropBehavior IsDragable="False" TooltipIcon="NotAllowed.png" TooltipText="Not Allowed"/>
    </i:Interaction.Behaviors>
    <Image Source="folder.png" Height="64" Width="64">
        <i:Interaction.Behaviors>
                <Intersoft:DragDropPointBehavior IsDragable="True"/>
        </i:Interaction.Behaviors>
    </Image>
    <TextBlock Text="My Archive" HorizontalAlignment="Center" VerticalAlignment="Center"/>
</StackPanel>
<Image Source="RecycleBin.png" HorizontalAlignment="Center" Height="100" VerticalAlignment="Center" Width="100" AllowDrop=True>
</Image>
C#
Copy Code 
public MainPage()
{
    // Required to initialize variables
    InitializeComponent();

    ISEventManager.RegisterInstanceHandler(
        this.LayoutRoot, // any element in the routed path which applicable in your scenario
        DragDrop.DragEnterEvent, // the routed event
        new Intersoft.Client.UI.Controls.Interactivity.DragEventHandler(DropTarget_DragEnter), // the event handler
        true);
}

private void DropTarget_DragEnter(object sender, Intersoft.Client.UI.Controls.Interactivity.DragEventArgs e)
{
    e.SetCustomTooltip(new BitmapImage(new Uri("Remove.png", UriKind.RelativeOrAbsolute)));
    e.SetCustomTooltip("Remove to recycle bin.");
}
Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

DropTargetBehavior Class
DropTargetBehavior Members

Concepts

Drag-drop Framework Overview

Send Feedback