今天按照这一年来经常用到的那些静态的工具类再来做一次总结,这些小的工具来可以作为自己学习的很好的例子,通过总结这些东西,能够很大程度上梳理自己的知识体系,当然这个是经常用到的,接下来就一个个去分析这些类的作用和蕴含的知识点。
ControlUtil
这个工具类是非常重要的,它的主要作用就是通过视觉树和逻辑树去寻找父节点或者子节点,这个例子在网上非常多,其核心都是通过迭代的思想去寻找自己最终想要的子控件,当然这里面有很多的内容,下面通过一个个的实例来说明这些代码的具体作用。
/// <summary>
/// 查找制定类别的子控件
/// </summary>
/// <typeparam name="T">控件类别</typeparam>
/// <param name="parent">父控件</param>
/// <returns>子控件集合</returns>
public static List<T> FindChildControls<T>(UIElement parent)
where T : UIElement
{
List<T> list = new List<T>();
if (parent == null) return list;
if (parent is ContentControl)
{
if ((parent as ContentControl).Content is T)
{
list.Add((parent as ContentControl).Content as T);
}
list.AddRange(FindChildControls<T>((parent as ContentControl).Content as UIElement));
}
if (parent is Decorator)
{
if ((parent as Decorator).Child is T)
list.Add((parent as Decorator).Child as T);
list.AddRange(FindChildControls<T>((parent as Decorator).Child));
}
if (parent is ItemsControl)
{
ItemsControl ic = parent as ItemsControl;
foreach (object itm in ic.Items)
{
if (itm is T)
list.Add(itm as T);
if (itm is UIElement)
list.AddRange(FindChildControls<T>(itm as UIElement));
}
}
if (parent is Panel)
{
Panel pan = parent as Panel;
foreach (UIElement ui in pan.Children)
{
if (ui is T)
{
list.Add(ui as T);
}
list.AddRange(FindChildControls<T>(ui));
}
}
return list;
}
由于传入的参数是UIElement,非常顶层的元素,所以在代码中我们进行了不同的分类,具体的分类分为下面几种ContentControl、Decorator、ItemsControl、Panel,通过这个分类基本上可以把父元素的所有子控件全部枚举出来,当然这段代码不太理想的地方就是过于庞大,无法准确去获取某一个元素,如果传入顶层的元素,那么我们将获取非常庞大的内容,这个具体的可以写一些测试代码去测试!
public static T FindVisualParent<T>(DependencyObject reference) where T : class
{
var parent = VisualTreeHelper.GetParent(reference);
if (parent == null)
return null;
else
{
if (parent is T)
{
return parent as T;
}
else
{
return FindVisualParent<T>(parent);
}
}
}
这段代码非常好理解,就是通过VisualTreeHelper来不断去获取Parent直到获取到第一个类型为T的父类型,下面我会针对这几种类型来写一个测试的demo,现在我来说说这些主要用在哪些地方。
a 比如重写了Button的模板,但是在点击的时候首先获取点击事件的可能是Button里面能够接受焦点的元素,这个时候我们可以传入首先获取焦点的对象,通过这个方法来获取Button,比如由于WPF支持事件的路由,所以在这种情况下通过传入e.OriginalSource来获取到Button,然后为Button做各种操作。
b 为当前对象this查找父类容器,比如我们我们经常会用到将Model绑定到前台的控件中(比如ItemsControl)那么我们可以传入当前的Model所应用到的数据模板中的对象(例如Image、TextBox、Label......),然后获取到父容器或者其他的对象,这种也是非常常用的方面(但是这里需要特别注意的地方是传入的参数必须是继承自DependencyObject的对象)。
public static List<T> FindVisualChildren<T>(DependencyObject reference)
where T : UIElement
{
List<T> list = new List<T>();
for (int i = 0; i < VisualTreeHelper.GetChildrenCount(reference); i++)
{
var child = VisualTreeHelper.GetChild(reference, i);
if (child != null && child is T)
{
list.Add(child as T);
}
list.AddRange(FindVisualChildren<T>(child));
}
return list;
}
与寻找父类型不同,这段代码能够获取到所有的类型为T的子元素,并返回一个List<T>的对象,这个方法的好处就是能够沿着当前传入的DependencyObject为起点沿着视觉树一直向下查找,包括模板中找到的元素。
下面通过一个DEMO(一个简单的照片浏览器)来说明一下,首先看一下软件界面。
这是一个简单的照片浏览程序,右边是一个图像列表,是一个ListBox对象,里面绑定了一个ObservableCollection的集合,当点击每一个ListBoxItem对象时,左侧会弹出相应的对象,同时下面的按钮也能够同步控制图片的选择功能,对于这个DEMO我们来一步步去分析视觉树上的父对象和子对象!
首先来看看MainWindow.xaml(这里仅仅贴出核心的代码)
<Grid Background="Gray" x:Name="root">
<Grid Margin="20">
<Grid.RowDefinitions>
<RowDefinition Height="50"/>
<RowDefinition Height="*"/>
<RowDefinition Height="80"/>
</Grid.RowDefinitions>
<Grid.ColumnDefinitions>
<ColumnDefinition Width="*"></ColumnDefinition>
<ColumnDefinition Width="150"></ColumnDefinition>
</Grid.ColumnDefinitions>
<TextBlock Text="照片浏览器" Grid.Row="0" Grid.Column="0" Grid.ColumnSpan="2" Foreground="White" FontSize="28" HorizontalAlignment="Center" VerticalAlignment="Center" FontFamily="楷体"/>
<!--<ContentPresenter Grid.Row="1" Content="{Binding Path=ImgCollection}"/>-->
<ListBox x:Name="pictureItemsControl" Grid.Row="1" Grid.Column="1" ItemsSource="{Binding ImageCollectionView,Mode=TwoWay}" AlternationCount="9999" ClipToBounds="False" FocusVisualStyle="{x:Null}">
<i:Interaction.Triggers>
<i:EventTrigger EventName="SelectionChanged">
<interactive:ExInvokeCommandAction Command="{Binding OnListBoxSelected}">
</interactive:ExInvokeCommandAction>
</i:EventTrigger>
</i:Interaction.Triggers>
<ListBox.Template>
<ControlTemplate TargetType="ItemsControl">
<Grid>
<Grid.RowDefinitions>
<RowDefinition Height="30"></RowDefinition>
<RowDefinition Height="*"></RowDefinition>
</Grid.RowDefinitions>
<Border Grid.Row="0" Background="Teal" CornerRadius="2">
<Label Content="照片列表" HorizontalAlignment="Center" VerticalAlignment="Center"></Label>
</Border>
<Border Padding="2" Background="Teal" CornerRadius="2" Grid.Row="1">
<ScrollViewer VerticalScrollBarVisibility="Auto">
<ItemsPresenter></ItemsPresenter>
</ScrollViewer>
</Border>
</Grid>
</ControlTemplate>
</ListBox.Template>
<ListBox.ItemsPanel>
<ItemsPanelTemplate>
<StackPanel IsItemsHost="True"></StackPanel>
</ItemsPanelTemplate>
</ListBox.ItemsPanel>
<ListBox.ItemTemplate>
<DataTemplate DataType="{x:Type local:PictureModel}">
<Border Padding="2">
<Image Source="{Binding ImgSource, Mode=TwoWay}" Stretch="Fill" Width="120" Height="120" HorizontalAlignment="Center" VerticalAlignment="Center"/>
</Border>
</DataTemplate>
</ListBox.ItemTemplate>
</ListBox>
<Image Grid.Row="1" Grid.Column="0" Source="{Binding CurrentItem.ImgSource, Mode=TwoWay}" Stretch="Uniform" Width="Auto" Height="Auto"/>
<Grid Grid.Row="2" Grid.Column="0" Grid.ColumnSpan="2">
<StackPanel Orientation="Horizontal" HorizontalAlignment="Center" VerticalAlignment="Center">
<Button Command="{Binding FirstPicture, Mode=TwoWay}" Width="60" Height="60" Margin="10,0,0,0" RenderTransformOrigin="0.5,0.5">
<Button.Background>
<ImageBrush ImageSource="/CollectionView;Component/Images/First.png"/>
</Button.Background>
</Button>
<Button Command="{Binding PreviousPicture, Mode=TwoWay}" Width="60" Height="60" Margin="10,0,0,0" RenderTransformOrigin="0.5,0.5">
<Button.Background>
<ImageBrush ImageSource="/CollectionView;Component/Images/Forward.png"/>
</Button.Background>
</Button>
<Button Command="{Binding NextPicture, Mode=TwoWay}" Width="60" Height="60" Margin="10,0,0,0" RenderTransformOrigin="0.5,0.5">
<Button.Background>
<ImageBrush ImageSource="/CollectionView;Component/Images/Next.png"/>
</Button.Background>
</Button>
<Button Command="{Binding LastPicture, Mode=TwoWay}" Width="60" Height="60" Margin="10,0,0,0" RenderTransformOrigin="0.5,0.5">
<Button.Background>
<ImageBrush ImageSource="/CollectionView;Component/Images/Last.png"/>
</Button.Background>
</Button>
</StackPanel>
</Grid>
</Grid>
</Grid>
在ViewModel层绑定到前台ListBox的总共有7个对象(七个图片),定义了一个CollectionView的集合。
private System.Windows.Data.CollectionView _imageCollectionView
= null;
public System.Windows.Data.CollectionView ImageCollectionView
{
get
{
return _imageCollectionView;
}
set
{
if (value != _imageCollectionView)
{
_imageCollectionView = value;
RaisePropertyChanged<System.Windows.Data.CollectionView>(() => this.ImageCollectionView);
}
}
}
在后台的代码中,我们通过 List<Image> myImageList = X.Utils.ControlUtil.FindVisualChildren<Image>(lb) 其中lb是通过程序中获取到的ListBox对象,通过代码调用我们能够获取到所有的ListBox中的Image对象(注:这个对象是在ListBox.ItemTemplate中定义的),总共获取到了7个对象,没有任何问题。
另外我们再进行一个测试,在这段代码中List<Image> myImageList = X.Utils.ControlUtil.FindVisualChildren<Image>(this.root),即向代码中传入根节点Grid,通过代码总共能够获取到8个对象,即ListBox中的7个对象另外再加上左侧的一张大的图片,总共8张。<Image Grid.Row="1" Grid.Column="0" Source="{Binding CurrentItem.ImgSource, Mode=TwoWay}" Stretch="Uniform" Width="Auto" Height="Auto"/>(大图片)
同样的道理我们可以去获取当前对象的VisualParent,同样也是通过这种方式来获取的......
这里我需要重点介绍的是我们都知道FrameworkElement下面有一个Parent属性,返回的是DependencyObject属性,MSDN的解释是:获取此元素的逻辑父元素。那么这个属性和通过VisualTreeHelper有什么不同呢?我们也列出了一些常用的代码,并通过DEMO来说明这些用法。
public static Window FindParentWindow(FrameworkElement element)
{
if (element.Parent == null)
{
return null;
}
Window window = element.Parent as Window;
if (window != null)
{
return window;
}
FrameworkElement parentElement = element.Parent as FrameworkElement;
if (parentElement != null)
{
return FindParentWindow(parentElement);
}
return null;
}
通过代码我们可以发现,这个方法只能够获取到当前节点的逻辑父节点,而且只能够一级一级的去迭代获取,如果其中一个元素的Parent为null的话那么就不能够得到最终的父元素。还是前面的那个例子,我们通过VS 的WPF Tree Visualizer这个工具可以很清楚的看到整个视觉树的所有元素,我们发现视觉树中的很多元素其Parent都是null,特别是定义在模板中的元素,Parent属性都是null,这些该怎么解释呢?FrameWorkElement.Parent
是获取此元素的逻辑父级元素,也就是通过LogicalTreeHelper查找。在MSDN中备注了:
对于模板,模板的 Parent 最终将为 null。 若要忽略这一点并扩展到实际应用模板的逻辑树,请使用 TemplatedParent,也就是通过这种方式查找父元素时只能在逻辑树上查找,否则只能返回为Null。
按照这个思路我们再一步步分析,请看下面的代码:
public static FrameworkElement FindParentWithDataContextAndName<DataContextT>(FrameworkElement childElement, string name)
where DataContextT : class
{
FrameworkElement parent = (FrameworkElement)childElement.Parent;
if (parent != null)
{
DataContextT data = parent.DataContext as DataContextT;
if (data != null)
{
if (parent.Name == name)
{
return parent;
}
}
parent = FindParentWithDataContextAndName<DataContextT>(parent, name);
if (parent != null)
{
return parent;
}
}
parent = (FrameworkElement)childElement.TemplatedParent;
if (parent != null)
{
DataContextT data = parent.DataContext as DataContextT;
if (data != null)
{
if (parent.Name == name)
{
return parent;
}
}
parent = FindParentWithDataContextAndName<DataContextT>(parent, name);
if (parent != null)
{
return parent;
}
}
return null;
}
这段代码是寻找特定的DataContext和name的Parent对象,在代码中如果通过FrameWorkElement.Parent来获取到的对象为null的话,就会通过parent = (FrameworkElement)childElement.TemplatedParent;通过当前元素的TemplateParent来获取父元素,通过这种方式是可以找到特定的DataContext和name的Parent对象,这点我们也可以通过实际的代码去验证的。
下面的这段代码和上面的类似,这里不再赘述!
public static FrameworkElement FindParentWithDataContext<DataContextT>(FrameworkElement childElement)
where DataContextT : class
{
if (childElement.Parent != null)
{
DataContextT data = ((FrameworkElement)childElement.Parent).DataContext as DataContextT;
if (data != null)
{
return (FrameworkElement)childElement.Parent;
}
FrameworkElement parent = FindParentWithDataContext<DataContextT>((FrameworkElement)childElement.Parent);
if (parent != null)
{
return parent;
}
}
if (childElement.TemplatedParent != null)
{
DataContextT data = ((FrameworkElement)childElement.TemplatedParent).DataContext as DataContextT;
if (data != null)
{
return (FrameworkElement)childElement.TemplatedParent;
}
FrameworkElement parent = FindParentWithDataContext<DataContextT>((FrameworkElement)childElement.TemplatedParent);
if (parent != null)
{
return parent;
}
}
return null;
}
下面来看看将两种方式组合来查找特定类型的父对象以及子对象
public static ParentT FindParentWithType<ParentT>(FrameworkElement childElement)
where ParentT : class
{
if (childElement.Parent != null)
{
ParentT parent = childElement.Parent as ParentT;
if (parent != null)
{
return parent;
}
parent = FindParentWithType<ParentT>((FrameworkElement)childElement.Parent);
if (parent != null)
{
return parent;
}
}
if (childElement.TemplatedParent != null)
{
ParentT parent = childElement.TemplatedParent as ParentT;
if (parent != null)
{
return parent;
}
parent = FindParentWithType<ParentT>((FrameworkElement)childElement.TemplatedParent);
if (parent != null)
{
return parent;
}
}
FrameworkElement parentElement = (FrameworkElement)VisualTreeHelper.GetParent(childElement);
if (parentElement != null)
{
ParentT parent = parentElement as ParentT;
if (parent != null)
{
return parent;
}
return FindParentWithType<ParentT>(parentElement);
}
return null;
}
查找子对象
/// <summary>
/// Find the framework element for the specified connector.
/// </summary>
public static ElementT FindElementWithType<ElementT>(Visual rootElement)
where ElementT : FrameworkElement
{
if (rootElement == null)
{
throw new ArgumentNullException("rootElement");
}
FrameworkElement rootFrameworkElement = rootElement as FrameworkElement;
if (rootFrameworkElement != null)
{
rootFrameworkElement.UpdateLayout();
}
//
// Check each child.
//
int numChildren = VisualTreeHelper.GetChildrenCount(rootElement);
for (int i = 0; i < numChildren; ++i)
{
Visual childElement = (Visual)VisualTreeHelper.GetChild(rootElement, i);
ElementT typedChildElement = childElement as ElementT;
if (typedChildElement != null)
{
return typedChildElement;
}
}
//
// Check sub-trees.
//
for (int i = 0; i < numChildren; ++i)
{
Visual childElement = (Visual)VisualTreeHelper.GetChild(rootElement, i);
ElementT foundElement = FindElementWithType<ElementT>(childElement);
if (foundElement != null)
{
return foundElement;
}
}
return null;
}
再介绍一个重载的方法用于查找特定类型,特定DataContext的父元素以及子元素,这个方法在WPF这种MVVM模式下是非常重要的。
public static ParentT FindParentWithTypeAndDataContext<ParentT>(FrameworkElement childElement, object dataContext)
where ParentT : FrameworkElement
{
if (childElement.Parent != null)
{
ParentT parent = childElement.Parent as ParentT;
if (parent != null)
{
if (parent.DataContext == dataContext)
{
return parent;
}
}
parent = FindParentWithTypeAndDataContext<ParentT>((FrameworkElement)childElement.Parent, dataContext);
if (parent != null)
{
return parent;
}
}
if (childElement.TemplatedParent != null)
{
ParentT parent = childElement.TemplatedParent as ParentT;
if (parent != null)
{
if (parent.DataContext == dataContext)
{
return parent;
}
}
parent = FindParentWithTypeAndDataContext<ParentT>((FrameworkElement)childElement.TemplatedParent, dataContext);
if (parent != null)
{
return parent;
}
}
FrameworkElement parentElement = (FrameworkElement)VisualTreeHelper.GetParent(childElement);
if (parentElement != null)
{
ParentT parent = parentElement as ParentT;
if (parent != null)
{
return parent;
}
return FindParentWithType<ParentT>(parentElement);
}
return null;
}
查找子元素
public static ElementT FindElementWithDataContext<DataContextT, ElementT>(Visual rootElement, DataContextT data)
where DataContextT : class
where ElementT : FrameworkElement
{
if (rootElement == null)
{
throw new ArgumentNullException("rootElement");
}
FrameworkElement rootFrameworkElement = rootElement as FrameworkElement;
if (rootFrameworkElement != null)
{
rootFrameworkElement.UpdateLayout();
}
int numChildren = VisualTreeHelper.GetChildrenCount(rootElement);
for (int i = 0; i < numChildren; ++i)
{
Visual childElement = (Visual)VisualTreeHelper.GetChild(rootElement, i);
ElementT typedChildElement = childElement as ElementT;
if (typedChildElement != null &&
typedChildElement.DataContext == data)
{
return typedChildElement;
}
ElementT foundElement = FindElementWithDataContext<DataContextT, ElementT>(childElement, data);
if (foundElement != null)
{
return foundElement;
}
}
return null;
}
最后再以一个非常常见的查找DataTemplate的代码来结束这一节的内容。
在实际的项目开发中查找某一个元素使用了何种DataTemplate也是有需要的,通过为某一个对象定义DataTemplate,同时定义DataTemplate的Key我们就能够获取到相应的元素,通过下面的代码我们也能够获取到相应的内容,仅供参考。
public static DataTemplateT FindTemplateForType<DataTemplateT>(Type type, FrameworkElement element)
where DataTemplateT : class
{
object resource = element.TryFindResource(new DataTemplateKey(type));
DataTemplateT dataTemplate = resource as DataTemplateT;
if (dataTemplate != null)
{
return dataTemplate;
}
if (type.BaseType != null &&
type.BaseType != typeof(object))
{
dataTemplate = FindTemplateForType<DataTemplateT>(type.BaseType, element);
if (dataTemplate != null)
{
return dataTemplate;
}
}
foreach (Type interfaceType in type.GetInterfaces())
{
dataTemplate = FindTemplateForType<DataTemplateT>(interfaceType, element);
if (dataTemplate != null)
{
return dataTemplate;
}
}
return null;
}