WPF 杂谈——自定义控件

Posted 2020-09-19 落叶随风

如果只是使用现有的WPF控件的话，是很难满足当前社会多复杂的业务。所以用户自己订制一系列控件也是一种不可避免的情势。WPF在控制方面分为俩种：用户控件和自定义控件。相信看过前面章节的就明白他们俩者之间的差别。理解用户控件并不难——把现有的控件组合在一起形成的控件。而在笔者看来自定义控件才是WPF最吸引人的地方。

关于用户控件的话，往往就是一个xaml文件，也可以是一个DLL文件。但是自定义控件往往都是一个DLL文件。引用这个DLL文件时候，应用会去加载dll文件里面的Theme文件夹下的Generic.xaml文件，从而宣染自定义控件。在Generic.xaml文件里面存放了若干个自定义控件的xaml文件。如下。

<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
                    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
                    xmlns:controls="clr-namespace:FirstFloor.ModernUI.Windows.Controls"
                    xmlns:shell="http://schemas.microsoft.com/winfx/2006/xaml/presentation/shell">
    
    <ResourceDictionary.MergedDictionaries>
        <ResourceDictionary Source="/FirstFloor.ModernUI;component/Themes/BBCodeBlock.xaml" />
        <ResourceDictionary Source="/FirstFloor.ModernUI;component/Themes/ModernButton.xaml" />
        <ResourceDictionary Source="/FirstFloor.ModernUI;component/Themes/ModernDialog.xaml" />
    </ResourceDictionary.MergedDictionaries>
 
</ResourceDictionary>

上面是不是有一点类似于App.xaml的内容。当我们引用这个自定义控件DLL文件的时候，就会去加载当前Theme文件夹/Generic.xaml文件。这里有一点要小心——一定要在自定义控件类的构造函数里面指定相关的Style类型。如下。

        public ModernButton()
        {
            this.DefaultStyleKey = typeof(ModernButton);
        }

假设我们编写完若干个自定义控件。那么为了方便引用这些控件。往往我们用到引路径的功能。如下

  xmlns:mui="http://firstfloorsoftware.com/ModernUI"

设置好了引用的路径。页面上就可以如下方式进行使用。

  <mui:ModernButton Content="modern button" IconData="{StaticResource HomeIconData}" Margin="0,0,0,8" />

如果我们不使用引用路径的话，在使用自定义控件的时候，就必须把相关命名空间一并引用进来。类似下面

 xmlns:app="clr-namespace:FirstFloor.ModernUI.App"

那么，如果控件存在不同的命名空间又如何呢？不好意思，请把所有相关的命名空间全部都引进来吧。但是引用路径则不用。为什么呢？看下面就知道了。

[assembly: XmlnsDefinition("http://firstfloorsoftware.com/ModernUI", "FirstFloor.ModernUI.Presentation")]
[assembly: XmlnsDefinition("http://firstfloorsoftware.com/ModernUI", "FirstFloor.ModernUI.Windows")]
[assembly: XmlnsDefinition("http://firstfloorsoftware.com/ModernUI", "FirstFloor.ModernUI.Windows.Controls")]
[assembly: XmlnsDefinition("http://firstfloorsoftware.com/ModernUI", "FirstFloor.ModernUI.Windows.Converters")]
[assembly: XmlnsDefinition("http://firstfloorsoftware.com/ModernUI", "FirstFloor.ModernUI.Windows.Navigation")]
[assembly: XmlnsPrefix("http://firstfloorsoftware.com/ModernUI", "mui")]

这一个部分的代码是在Modern UI for WPF开源项目的FirstFloor.ModernUI项目的AssemblyInfo.cs文件里面。FirstFloor.ModernUI项目就是一个自定义控件的项目。上面的引用路径可以说是一对多的关系。不用笔者讲解了吧。

记得上一章节中讲到每一个用户控件都会实现于FrameworkElement类。在FrameworkElement类中有一个属性叫Template。他是自定义控件的核内点。从字面意义来讲就是模板的意思。笔者是这样子理解的。自定义控件事实上就是控件的显示模板在重新用自己的意思画了一片。如下是笔者在新建自定义控件时候，VS帮忙生成的。笔者略做修改一下。笔者加了一个TextBox。Text为AomiCustomTextBox。

<Style TargetType="{x:Type local:CustomControl}">
        <Setter Property="Template">
            <Setter.Value>
                <ControlTemplate TargetType="{x:Type local:CustomControl}">
                    <Border Background="{TemplateBinding Background}"
                            BorderBrush="{TemplateBinding BorderBrush}"
                            BorderThickness="{TemplateBinding BorderThickness}">
                        <TextBox Text="AomiCustomTextBox"></TextBox>
                    </Border>
                </ControlTemplate>
            </Setter.Value>
        </Setter>
 </Style>

显示结果：

那么，如果Template(ControlTemplate)是用于自定义控件。里面有一个跟他类似的DataTemplate又是用于做什么呢？事实上在开发WPF的时候，我们也会常常用到他们。如果不搞清楚他们之间的作用差别的话，有时候会误事。MSDN上面是这样子定义的。ControlTemplate是用于定置一个控件可视化结构和行为方面。这里要注意的是一个控件。而DataTemplate是定置一个业务对象的可以视化结构。即是面向对象不同。是事实在开发过程有时候也会有这样子的感觉，ControlTemplate一般都是用TemplateBinding来邦定数据，而DataTemplate用的是标准的binding。什么意思呢？也就是说ControlTemplate一般会去找控件自身的依赖属性。而是DataTemplate则是去找DataContext。

那么俩者可不可以同时使用呢？答案是肯定可以的。这个时候就要小心了。往往会出现一些互相影响的事情。但是一定要认清楚一点：ControlTemplate是不管业务数量的展示。他只管控件布局结构。DataTemplate反之。

引用定义控件离不开Theme文件夹下的Generic.xaml文件。那么这里笔者有一个疑问——App.xaml上面的引用和Generic.xaml文件里面的引用又有什么区别呢？WPF所有控件都有一个黙认的样式。这个样式往往是通过控件的DefaultStyleKey依赖属性来确定的。而默认的样式文件名往往会根据当前操作系统的不同而不同。如下

1.Generic.xaml:如果下面的黙认样式都没有情况下会被引用。笔者喜欢叫标准样式。

2.Luna.Xxx.xaml:在XP系统下引用的黙认样式。如：Luna.Homestead.xaml、Luna.Metallic.xaml

3.Aero.Xxx.xaml:在Vista下引用的黙认样式。如：Aero.NormalColor.xaml

所以笔者也很难区分App.xaml和Generic.xaml上面的差别。因为俩者太像了。笔者略微的做了一个实验看一下是App.xaml和Generic.xaml谁先执行。结果是Generic.xaml。所以如果你在App.xaml里面定义一个样式，想在Generic.xaml里面StaticResource引用会报错的。具体的话，笔者觉得各位可以去试一下。值得注意的：往往App.xaml引用的资源文件都是标准控件(颜色，WPF本身的控件)的样式。而Generic.xaml一般用于自定义控件的资源文件。