WPF 自定义依赖属性

当前位置:

首页 > c#编程 >

WPF 自定义依赖属性

DependencyObject和DependencyPorperty两个类是WPF属性系统的核心。

在WPF中，依赖对象的概念被DependencyObject类实现；依赖属性的概念则由DependencyPorperty类实现。

必须使用依赖对象作为依赖属性的宿主，二者结合起来，才能实现完整的Binding目标被数据所驱动。DependencyObject具有GetValue和SetValue两个方法，用来获取/设置依赖属性的值。

DependencyObject是WPF系统中相当底层的一个基类，如下：

从这颗继承树可以看出，WPF的所有UI控件都是依赖对象。WPF的类库在设计时充分利用了依赖属性的优势，UI空间的饿绝大多数属性都已经依赖化了。

下面用一个简单的实例来说明依赖属性的使用方法。先准备好一个界面，顺便复习下前面的Style和Template：

<Window x:Class="DependencyObjectProperty.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="MainWindow" Height="350" Width="525">
    <Window.Resources>
        <Style x:Key="textStyle" TargetType="{x:Type TextBox}">
            <Setter Property="Template">
                <Setter.Value>
                    <ControlTemplate TargetType="{x:Type TextBox}">
                        <TextBlock Background="CadetBlue" Foreground="HotPink"  Text="{TemplateBinding Property=Text}"/>
                    </ControlTemplate>
                </Setter.Value>
            </Setter>
            
            <Style.Triggers>
                <Trigger Property="IsMouseOver" Value="true">
                    <Setter Property="Template">
                        <Setter.Value>
                            <ControlTemplate TargetType="{x:Type TextBox}">
                                <Border SnapsToDevicePixels="true" x:Name="Bd" Background="{TemplateBinding Background}" BorderBrush="{TemplateBinding BorderBrush}" BorderThickness="{TemplateBinding BorderThickness}">
                                    <ScrollViewer SnapsToDevicePixels="{TemplateBinding SnapsToDevicePixels}" x:Name="PART_ContentHost" Background="AliceBlue"/>
                                </Border>
                            </ControlTemplate>
                        </Setter.Value>
                    </Setter>
                </Trigger>
            </Style.Triggers>
        </Style>
    </Window.Resources>
    <StackPanel>
        <TextBox Style="{StaticResource textStyle}" Height="37" Name="textBox1" FontSize="26"    Margin="5" Width="439" />
        <TextBox Style="{StaticResource textStyle}" Height="37" Name="textBox2" FontSize="26"  Margin="5" Width="439" />
        <Button Content="Button" Height="39" Name="button1" Width="131" Click="button1_Click" />
    </StackPanel>
</Window>

前面说过，DependencyProperty必须以DependencyObject为宿主、借助它的SetValue和GetValue方法进行写入和读取。因此，想用自定义的DependencyProperty，宿主一定是DependencyObject的派生类。

DependencyProperty实例的声明特点很明显：变量由public static readonly三个修饰符修饰，实例使用DependencyProperty.Register方法生成。而非new操作符得到。

代码如下：

using System.Windows;

namespace DependencyObjectProperty
{
    class Student:DependencyObject
    {
        //定义依赖属性
        public static readonly DependencyProperty NameProperty = DependencyProperty.Register("Name", typeof(string), typeof(Student));
    }
}

这是自定义DependencyProperty的最简单代码。
依赖属性也是属性，下面来使用它：

private void button1_Click(object sender, RoutedEventArgs e)
{
   Student stu = new Student();
   stu.SetValue(Student.NameProperty, textBox1.Text);
   textBox2.Text = (string)stu.GetValue(Student.NameProperty);
}

在textBox1中输入值，点下Button1后效果如下：

上面我们使用的依赖属性是靠GetValue和SetValue进行对外的暴露，而且在GetValue的时候需要进行类型的转换，因此，在大多数的情况下我们会为依赖属性添加一个CLR属性的外包装：

using System.Windows;

namespace DependencyObjectProperty
{
    class Student:DependencyObject
    {
        //CLR属性进行封装
        public string Name
        {
            get { return (string)GetValue(NameProperty); }
            set { SetValue(NameProperty, value); }
        }
        
        //定义依赖属性
        public static readonly DependencyProperty NameProperty = DependencyProperty.Register("Name", typeof(string), typeof(Student));
    }
}

有了这个CLR属性包装，我们就可以和CLR属性一样访问依赖属性了：

private void button1_Click(object sender, RoutedEventArgs e)
{
   Student stu = new Student();
   stu.Name = textBox1.Text;
   textBox2.Text = stu.Name;            
}

如果不关心底层的实现，下游的程序员在使用依赖属性时与使用单纯的CLR属性别无二致。

效果和上面相同：

当然如果不用Binding，依赖属性的设计就没有意义，下面我们使用Binding把Student对象关联到textBox1上，再把textBox2关联到Student对象上。代码如下：

private void button1_Click(object sender, RoutedEventArgs e)
{
   Student stu = new Student();

   Binding binding = new Binding("Text") { Source = textBox1 };
   BindingOperations.SetBinding(stu, Student.NameProperty, binding);

   Binding binding2 = new Binding("Name") { Source = stu };
   BindingOperations.SetBinding(textBox2, TextBox.TextProperty, binding2);
}

当然第二个Binding也可以这样写，下面两者等效：

Binding binding2 = new Binding("Name") { Source = stu };
BindingOperations.SetBinding(textBox2, TextBox.TextProperty, binding2);

textBox2.SetBinding(TextBox.TextProperty, binding2);

也可以在Student类中封装FrameworkElement类的SetBinding方法，如下：

using System.Windows;
using System.Windows.Data;

namespace DependencyObjectProperty
{
    class Student:DependencyObject
    {
        //CLR属性进行封装
        public string Name
        {
            get { return (string)GetValue(NameProperty); }
            set { SetValue(NameProperty, value); }
        }
        
        //定义依赖属性
        public static readonly DependencyProperty NameProperty = DependencyProperty.Register("Name", typeof(string), typeof(Student));


        //SetBinding包装
        public BindingExpressionBase SetBinding(DependencyProperty dp, BindingBase binding)
        {
            return BindingOperations.SetBinding(this, dp, binding);
        }
    }
}

则Binding可进一步写成这样：

private void button1_Click(object sender, RoutedEventArgs e)
{
   Student stu = new Student();
   stu.SetBinding(Student.NameProperty, new Binding("Text") { Source=textBox1 });
   textBox2.SetBinding(TextBox.TextProperty, new Binding("Name") { Source=stu});
}

效果如下：

//---------------------------------------------------------

自定义依赖属性也可以不需要手动进行声明、注册并使用CLR属性进行封装，只需要输入propdp，同时连按两次Tab，一个标准的依赖属性(带CLR属性包装)就声明好了。

prop:CLR属性

propa：附加属性

propdp：依赖属性

附加属性也是一种特别的依赖属性，顾名思义，附加属性是说一个属性本来不属于某个对象，但是由于某种需求而被后来附加上。也就是把对象放入一个特定的环境后对象才具有的属性，比如Canvas.Left DockPanel.Dock Grid.Column等。

声明时一样用public static readonly三个关键词修饰。唯一不同就是注册附加属性使用的是名为RegisterAttached的方法，但参数与Register方法相同。附加属性的包装器也与依赖属性不同，依赖属性使用CLR属性对GetValue和SetValue两个方法进行包装，附加属性则使用两个方法分别进行包装。

其可由propa+tab+tab方便的生成。理解附加属性的意义及使用场合即可。

栏目列表