Win10/UWP新特性—Drag&Drop 拖出元素到其他App

    在以前的文章中，写过微软新特性Drag&Drop，当时可能由于处于Win10预览版，使用的VS也是预览版，只实现了从桌面拖拽文件到UWP App中，没能实现从UWP拖拽元素到Desktop App & UWP App中。昨天重新研究了Win10 拖拽这一块，发现以前没能实现的功能，在正式版的环境下都可以实现了，做个笔记以防日后忘记。

    在UWP中，想要拖动元素到Desktop或者另一个UWP App中，除了设置元素的CanDrag="True"我们要使用元素的DragStarting事件，CanDrag属性设置元素能被拖动，DragStarting事件中我们便可以为拖动准备数据，改变拖动时的UI等一些操作。

    我们依然使用上篇Drag&Drop文章中例子，在底部新增一个Img元素，设置如下：

<Image  x:Name="img" 
        CanDrag="True"
        Source="Assets/I Am 1%.jpg"
        DragStarting="Image_DragStarting"/>

我们要用到事件的DragStartingEventArgs参数，在该参数中我们可以为拖动准备拖动的数据，更改UI设置，其中有几个重要的属性和方法：

<!--/* DragStartingEventArgs.Data中可以设置很多类型的数据：

        ·public void SetBitmap(RandomAccessStreamReference value); 设置 DataPackage 中包含的位图图像。
        
        ·public void SetData(System.String formatId, [HasVariant] System.Object value); 设置 RandomAccessStream 格式的 DataPackage 中包含的数据。
        
        ·public void SetHtmlFormat(System.String value); 向 DataPackage 添加 HTML 内容。
        
        ·public void SetRtf(System.String value); 设置 DataPackage 中包含 RTF 格式内容。
        
        ·public void SetStorageItems(IEnumerable<IStorageItem> value); 设置存储对象
        
        ·public void SetStorageItems(IEnumerable<IStorageItem> value, System.Boolean readOnly);设置存储对象 只读模式
        
        ·public void SetText(System.String value); 设置 DataPackage 包含的文本。
        
        ·public void SetUri(Uri value); 设置一个Uri
        
        ·public void SetWebLink(Uri value); 设置一个WebLink
        
        //设置拖动时的图标
        
        ·args.DragUI.SetContentFromBitmapImage     设置一个bitmap图片
        
        ·args.DragUI.SetContentFromDataPackage(); 设置来源于拖动的数据
        
         
        
        注：
        
        拖动源设置了相应的数据类型后，如果拖动元素到另一个UWP App中（接收者），
        
        则接收者需要根据相应的数据类型才能取出数据，
        
        如果不确定数据类型可以使用DragEventArgs参数的DataView.Contains(StandardDataFormats formats)方法来确定是否包含某种数据类型
        
        然后再进行取出，没有判断直接强制取出，如果类型不匹配接收者会报错

*/-->

我们在DragStarting事件中处理拖动如下:

private async void Image_DragStarting(UIElement sender, DragStartingEventArgs args)
{
    //设置预览拖动时的图标 来源于数据
    args.DragUI.SetContentFromDataPackage();
 
    // 设置一个图片替换拖动时的图标
    // args.DragUI.SetContentFromBitmapImage(new BitmapImage(new Uri("ms-appx:///Assets/Data-Export.png")) { DecodePixelWidth = 48, DecodePixelHeight = 48 },new Point(0,0));
 
    // 拖动的行为，这里选择Copy 注意，如果选择 Move，拖动完成后会删除源文件
    args.Data.RequestedOperation = DataPackageOperation.Copy;
 
    /*  DragStartingEventArgs.Data中可以设置很多类型的数据：
        ·public void SetBitmap(RandomAccessStreamReference value);      设置 DataPackage 中包含的位图图像。
        ·public void SetData(System.String formatId, [HasVariant] System.Object value);     设置 RandomAccessStream 格式的 DataPackage 中包含的数据。
        ·public void SetHtmlFormat(System.String value);     向 DataPackage 添加 HTML 内容。
        ·public void SetRtf(System.String value);       设置 DataPackage 中包含 RTF 格式内容。
        ·public void SetStorageItems(IEnumerable<IStorageItem> value); 设置存储对象
        ·public void SetStorageItems(IEnumerable<IStorageItem> value, System.Boolean readOnly);设置存储对象 只读模式
        ·public void SetText(System.String value);  设置 DataPackage 包含的文本。
        ·public void SetUri(Uri value);     设置一个Uri
        ·public void SetWebLink(Uri value);     设置一个WebLink
 
        注：
        拖动源设置了相应的数据类型后，如果拖动元素到另一个UWP App中（接收者），
        则接收者需要根据相应的数据类型才能取出数据，
        如果不确定数据类型可以使用DragEventArgs参数的DataView.Contains(StandardDataFormats formats)方法来确定是否包含某种数据类型
        然后再进行取出，没有判断直接强制取出，如果类型不匹配接收者会报错
    */
 
 
    // 设置拖动data 添加一些StorageItems数据，这里取一些img图片，这些图片拖动后会copy到拖动目标上
    // 如果拖动到桌面文件夹，则会copy文件到文件夹
    var folder = await Package.Current.InstalledLocation.GetFolderAsync(@"Imgs");
    args.Data.SetStorageItems(await folder.GetFilesAsync());
 
    // 设置BitMap数据  
    var sf = await Package.Current.InstalledLocation.GetFileAsync(@"AssetsI Am 1%.jpg");
    args.Data.SetBitmap(RandomAccessStreamReference.CreateFromFile(sf));
}

上面我们一共设置两种数据，第一种是通过args.Data.SetStorageItems()方法将指定文件夹下的图片赋值到拖动Data上，第二种我们通过args.Data.SetBitmap()方法设置了一个图片到Data的BitMap中。

使用时，我们在拖动元素到另一个App（接收者）中时，就要根据上面具体设置的数据类型来获取到相应的数据。

接下来我们创建一个新的UWP App（接收者） ,界面上放置一个ListView，并设置可接受拖动数据，然后订阅相关的拖动事件如下：

<Grid x:Name="MainGrid"  
    AllowDrop="True"   
    Drop="VcBorder_Drop"
    DragOver="VcBorder_DragOver"
      Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <ListView Margin="8" x:Name="ImgList"/>
</Grid>

我们要实现的功能就是，从一个App中拖动元素到这个App中，拖动完成后获取拖动数据（一组图片和一个BitMap对象），获取的图片添加到ListView中，获取的BitMap对象则给Grid容器的背景色赋值。

DragOver事件中，我们可以更改拖动元素到目标范围内时的UI外观，定制如下：

private void VcBorder_DragOver(object sender, DragEventArgs e)
{
    Debug.WriteLine("[Info] DragOver");
    //设置操作类型
    e.AcceptedOperation = DataPackageOperation.Copy;
 
    //设置提示文字
    e.DragUIOverride.Caption = "拖放此处即可添加文件 o(^▽^)o";
}

Drop事件中我们来处理拖动完成时的逻辑，如下：

private async void VcBorder_Drop(object sender, DragEventArgs e)
{
    /*
        接收端可以根据e.DataView.Contains(StandardDataFormats formats) 来确定拖动过来的数据中是否包含某种数据类型
        如果数据类型不匹配就取的话则会报错
    */
    if (e.DataView.Contains(StandardDataFormats.StorageItems))
    {
        //获取存储对象
        var items = await e.DataView.GetStorageItemsAsync();
 
        //咨询是否接受文件
        var dialog = new ContentDialog
        {
            Title = "提示",
            Content = new TextBlock {Text = $"从其他App中拖动来{items.Count}个文件，是否接受？"},
            IsPrimaryButtonEnabled = true,
            IsSecondaryButtonEnabled = true,
            PrimaryButtonText = "Ok",
            SecondaryButtonText = "Cancel"
        };
        dialog.PrimaryButtonClick += async (s, a) =>
        {
            //开始接受文件 并添加到ImgList中 ，或者也可以做其他操作，例如保存文件到App中
            //过滤下文件，只取jpg文件
            foreach (var item in items.OfType<StorageFile>()
                .Where(i => i.FileType.Equals(".jpg")).ToList())
            {
                var bitmapImage = new BitmapImage();
                await bitmapImage.SetSourceAsync(await item.OpenAsync(FileAccessMode.Read));
                ImgList.Items?.Add(new Image {Source = bitmapImage});
            }
        };
        dialog.SecondaryButtonClick += (s, a) => { dialog.Hide(); };
        await dialog.ShowAsync();
    }
 
    if (e.DataView.Contains(StandardDataFormats.Bitmap))
    {
        //获取bitmap对象
        var items = await e.DataView.GetBitmapAsync();
        var bitmap = new BitmapImage();
        await bitmap.SetSourceAsync(await items.OpenReadAsync());
        //设置MainGrid背景图片
        MainGrid.Background = new ImageBrush {ImageSource = bitmap};
    }
}

有关更多Drop事件&DragOver事件详细设置请参与文章：UWP/Win10新特性系列—Drag&Drop拖动打开文件

这样我们就实现了从一个UWP中拖动元素到其他App中，例如可以拖动到文件夹中快速保存图片，也可以拖动到outlook中快速插入附件，也可以拖动图片到另一个App中进行操作等。

效果图：

推荐一个UWP开发群：53078485 大家可以进来一起学习