Introduction
The is the second article on adding drag and drop to WPF applications using the GongSolutions.Wpf.DragDrop library. You can find the first part here: Drag and Drop in WPF Part I.
Background
In the first article, I described how to add simple drag and drop behaviour to an ItemsControl using attached properties, and showed how drop behaviour could be customised by adding a drop handler. If you've not seen that article, I'd recommend reading it first.
Using the Code
In this article, I'll explain how to customise drag behaviour with drag handlers, how to display a drag adorner, and how to handle multiple selections.
Drag Handlers
In the same way that drop handlers allow us to write code to customise the handling of a drop on a control, drag handlers allow us to customise the drag itself. To demonstrate this, I'm going to use the example we constructed in part 1: the Schools example.
In our application, let's suppose that there are certain pupils who don't want to be moved out of their school. For the sake of this example, I'm going to hardcode a pupil by his name - "Tom Jefferson". In a real-life application, you'd obviously not be hard-coding information like this, but for the sake of keeping the example simple, that's exactly what I'm going to do!
To prevent Tom Jefferson being moved, we first need to add a DragHandler to the pupils ListBox:
<ListBox Grid.Column="1"
ItemsSource="{Binding Schools.CurrentItem.Pupils}"
DisplayMemberPath="FullName"
dd:DragDrop.IsDragSource="True" dd:DragDrop.IsDropTarget="True"
dd:DragDrop.DragHandler="{Binding}"/>
Here, like the DropHandler, we're binding the drag handler to the MainViewModel. To make MainViewModel a drag handler, we need to implement the IDragSource interface:
void IDragSource.StartDrag(DragInfo dragInfo)
{
PupilViewModel pupil = (PupilViewModel)dragInfo.SourceItem;
if (pupil.FullName != "Tom Jefferson")
{
dragInfo.Effects = DragDropEffects.Copy | DragDropEffects.Move;
dragInfo.Data = pupil;
}
}
The IDragSource interface only defines a single method, StartDrag. In our implementation, we first check that the pupil is not named "Tom Jefferson", and if not, we tell the framework that both Copy and Move operations are allowed. Next, we set the drag data - both the Effects and Data properties must be set in a drag handler to allow a drag to start.
Run your program, and there it is: Tom Jefferson is no longer draggable.
Displaying a Drag Adorner
A drag adorner is a transparent image that shows a preview of the data being dragged. When we drag a pupil, we're going to display a drag adorner that looks like this:
Apologies for my lack of artistic skill on the icon, but you should get the idea. Feel free to use a better icon of your own :)
To show the adorner, first, we create a DataTemplate. We'll place it in the Window's Resources section:
<Window.Resources>
<DataTemplate x:Key="PupilDragAdorner">
<StackPanel>
<Image Source="/Person.png" Width="64"
HorizontalAlignment="Center"/>
<TextBlock Text="{Binding FullName}" HorizontalAlignment="Center"/>
</StackPanel>
</DataTemplate>
</Window.Resources>
This DataTemplate consists of a StackPanel which vertically arranges two controls: an Image holding the icon and a TextBlock to display the pupil's name.
Now, we just need to set the DragAdornerTemplate attached property on the our ListBox:
<ListBox Grid.Column="1"
ItemsSource="{Binding Schools.CurrentItem.Pupils}"
DisplayMemberPath="FullName"
dd:DragDrop.IsDragSource="True" dd:DragDrop.IsDropTarget="True"
dd:DragDrop.DragHandler="{Binding}"
dd:DragDrop.DragAdornerTemplate="{StaticResource PupilDragAdorner}"/>
And Hey Presto! The adorner appears when you drag an item from the pupils ListBox.
Multiple Selections
If multiple selection is available on the source ItemsControl, then the default drag handler will handle this. However, when more than one item of data is dropped, you'll no longer receive a single object, but a collection of objects. The simplest way to deal with this in your drop handler is to check whether the dragged data is either an object of the accepted type or an IEnumerable of the accepted type. So, the DragOver method in the example method would need to change to this:
void IDropTarget.DragOver(DropInfo dropInfo)
{
if ((dropInfo.Data is PupilViewModel || dropInfo.Data
is IEnumerable<PupilViewModel>) &&
dropInfo.TargetItem is SchoolViewModel)
{
dropInfo.DropTargetAdorner = DropTargetAdorners.Highlight;
dropInfo.Effects = DragDropEffects.Move;
}
}
Here we're checking to see if the data is a PupilViewModel or an IEnumerable<PupilViewModel>.
You'll also need to handle the possibility of a multiple selection in your IDropTarget.Drop method, but I'll leave that as an exercise to the reader.
Similarly, to enable an IDragSource to handle multiple selections, you need to look at the DragInfo.SourceItems property rather than the DragInfo.SourceItem property in your StartDrag method.
Points of Interest
Dragging a multiple selection is currently slightly broken. In WPF, if a user has made a multiple selection on an ItemsControl and then clicks on one of these items to start a drag, the multiple selection is cleared! So the framework checks to see if this is the case, and if so, swallows the click so that the multiple selection is not lost. However, this has the side-effect that if all items in the control are selected, there's nowhere for them to click to remove the multiple selection! Any hints on how to solve this problem will be gratefully received.
