WPF 与Surface 2.0 SDK 亲密接触–LibraryBar 篇

LibraryBar 介绍

     与LibraryStack 类似LibraryBar 也属于ItemsControl，在LibraryBar 里的组件会以水平平铺方式展示，并且也可以对其中的组件进行按组分类。同样LibraryBar 也是默认支持拖拽操作。

     下面的例子将通过LibraryBar 展示一组Sample 图片。首先，仍然可以使用DataTemplate 作为LibraryBar 的样式模板用来绑定图片资源。接下来在Grid 中添加LibraryBar 控件，并设置好ItemTemplate 数据模板。我们可以通过修改Rows 参数调整LibraryBar 中组件显示的行数。

<s:SurfaceWindow x:Class="Demo.SurfaceWindow1"      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"      xmlns:s="http://schemas.microsoft.com/surface/2008"      Title="LibraryBar"  >      <s:SurfaceWindow.Resources>          <DataTemplate x:Key="LibraryBarItemTemplate">              <Image Source="{Binding}"/>          </DataTemplate>      </s:SurfaceWindow.Resources>        <Grid>          <s:LibraryBar x:Name="mLibraryBar" Rows="3"
                      ItemTemplate="{StaticResource LibraryBarItemTemplate}"/>      </Grid>  </s:SurfaceWindow>  

     为LiraryBar 添加图片数据源。注意，同样不能将图片string[] 数组直接赋给LiraryBar，需要借助ObservableCollection。

string imagesPath = @"C:\Users\Public\Pictures\Sample Pictures\";  try  {      string[] files = System.IO.Directory.GetFiles(imagesPath, "*.jpg");      ObservableCollection<string> items = new ObservableCollection<string>(files);      mLibraryBar.ItemsSource = items;  }  catch (System.IO.DirectoryNotFoundException)  {      // Error info.  }

默认两行模式：

三行模式：

LibraryBar 分组

     接下来我们将图片进行分组操作，先增加一个PhotoAlbum 类，其中包含图片的路径、标签、组名信息。

class PhotoAlbum  {      private string label;      private string fileName;      private string groupName;      private BitmapImage bitmap;        public PhotoAlbum(string fileName, string label, string groupName)      {          this.fileName = fileName;          this.label = label;          this.groupName = groupName;          this.bitmap = new BitmapImage(new Uri(fileName, UriKind.Absolute));      }        public string Label      {          get { return label; }      }
      public string FileName      {          get { return fileName; }      }  
      public string GroupName      {          get { return groupName; }      }        public BitmapSource Bitmap      {          get { return bitmap; }      }  }

对DataTemplate 稍作修改，添加图片标签<Label>。

<s:SurfaceWindow.Resources>      <DataTemplate x:Key="LibraryBarItemTemplate">          <Grid>              <Image Source="{Binding Bitmap}"/>              <Label FontSize="14" Content="{Binding Label}"/>          </Grid>      </DataTemplate>  </s:SurfaceWindow.Resources>    <Grid>      <s:LibraryBar x:Name="mLibraryBar" Rows="2"                    ItemTemplate="{StaticResource LibraryBarItemTemplate}"/>  </Grid>  

     依据GroupName 作为分组的方式，为GroupDescriptions 默认的集合浏览方式添加PropertyGroupDescription 对象，并赋给ItemsSource 属性。

ObservableCollection<PhotoAlbum> items = new ObservableCollection<PhotoAlbum>();  string imagesPath = @"C:\Users\Public\Pictures\Sample Pictures\";    items.Add(new PhotoAlbum(imagesPath + "Hydrangeas.jpg", "Hydrangeas", "Nature"));  items.Add(new PhotoAlbum(imagesPath + "Lighthouse.jpg", "Lighthouse", "Nature"));  items.Add(new PhotoAlbum(imagesPath + "Tulips.jpg", "Tulips", "Nature"));  items.Add(new PhotoAlbum(imagesPath + "Jellyfish.jpg", "Jellyfish", "Animal"));  items.Add(new PhotoAlbum(imagesPath + "Koala.jpg", "Koala", "Animal"));  items.Add(new PhotoAlbum(imagesPath + "Penguins.jpg", "Penguins", "Animal"));    mLibraryBar.ItemsSource = items;  ICollectionView defaultView = CollectionViewSource.GetDefaultView(items);  defaultView.GroupDescriptions.Add(new PropertyGroupDescription("GroupName"));

LibraryBar 拖拽

     从上面的示例中可以发现，我们无法将图片从LibraryBar 中拖拽出来，当拖拽操作结束后图片会自动返回到LibraryBar。接下来将实现把图片拖拽到ScatterView 控件。

     首先，对XAML 控件进行下修改，将LibraryBar 放入ScatterView 控件。这里需要将ScatterView 的AllwoDrop 属性设为True，背景也要填充颜色，可设置为Transparent 透明，这样才能保证LibraryBar 中的组件可以拖拽到ScatterView 中。

<Grid>      <s:ScatterView x:Name="scatterView" s:SurfaceDragDrop.Drop="scatterView_Drop"                     AllowDrop="True" Background="Transparent">          <s:ScatterViewItem Width="500" Height="300">              <s:LibraryBar x:Name="mLibraryBar" Rows="2"                             ItemTemplate="{StaticResource LibraryBarItemTemplate}"/>          </s:ScatterViewItem>      </s:ScatterView>  </Grid>  

     其次，为ScatterView 添加SurfaceDragDrop.Drop 事件用于处理拖拽的操作。在事件触发时，新建一个ScatterViewItem（newItem） 用于装载被拖动的图片组件。将e.Cursor.Data 转化为PhotoAlbum，借助FileName 属性新建MediaElement。将MediaElement（mediaItem）赋给newItem.Content，并通过GetPosition 获取到拖拽动作的位置作为newItem 在ScatterView 中的显示位置。

private void scatterView_Drop(object sender, SurfaceDragDropEventArgs e)  {      PhotoAlbum data = e.Cursor.Data as PhotoAlbum;            ScatterViewItem newItem = new ScatterViewItem();      MediaElement mediaItem = new MediaElement();      mediaItem.Source = new Uri(data.FileName);      newItem.Background = Brushes.Transparent;      newItem.Content = mediaItem;      newItem.Center = e.Cursor.GetPosition(scatterView);            scatterView.Items.Add(newItem);  }

     这样我们就实现了将LibraryBar 中的组件拖拽到ScatterView。MSDN 上也提供了文档供大家参考：Using the Microsoft Surface Drag-and-Drop Framework