(4) C# 依赖项属性
把对象赋值给属性
一、依赖属性
1.定义依赖属性
一般情况下只是使用，但如果要自定义WPF控件或者给现有的WPF控件增加新功能时就需要自定义。
定义时需要用到特殊的语法：
- 静态的
- 使用readonly只能在构造时初始化
- 必须是DependencyProperty类实例
- 属性名称后面要带上Property
定义一个Margin依赖项属性的例子
public static readonly DependencyProperty MarginProperty;
2.注册依赖属性
（1）创建FrameworkPropertyMetadata对象，指明通过依赖项属性使用什么服务（支持数据绑定，动画，日志等）
FrameworkPropertyMetadata metadata = new FrameworkPropertyMetadata(new Thickness(), FrameworkPropertyMetadataOptions.AffectsMeasure);
（2）调用DependencyProperty.Register()静态方法注册属性
五个参数
- 属性名
- 属性使用的数据类型
- 拥有该属性的类型
- 具有附加属性设置的FrameworkPropertyMetadata对象（此参数可选）
- 用于验证属性的回调函数（此参数可选）
在构造函数中
MarginProperty = DependencyProperty.Register("Margin", typeof(Thickness), typeof(FrameworkElement), metadata, new ValidateValueCallback(FrameworkElement.IsMarginValid));
3.封装WPF依赖属性
使用DependencyObject类的SetValue()和GetValue()方法
public Thickness Margin { set { SetValue(MarginProperty, value); } get { return (Thickness)GetValue(MarginProperty); } }
设置属性
element.Margin = new Thickness(5);
4.例子
一个按钮继承关系 Button--》ButtonBase--》ContentControl--》Control--》FrameworkElement--》UIElement--》Visual--》DependencyObject--》DispatcherObject--》Object
其中
- ButtonBase 表示所有 Button 控件的基类,在System.Windows.Controls.Primitives命名空间下（和winfrom下的ButtonBase虽然名字相同，但完全是两条不同的路线）
- ContentControl 表示包含一段任意类型内容的控件
- Control 表示用户界面 (UI) 元素的基类，这些元素使用 ControlTemplate 来定义其外观
- FrameworkElement 提供 WPF元素的属性、事件和方法的 WPF 框架级别集
- UIElement 是 WPF 核心级实现的基类，这些实现是在 WPF元素和基本表示特性上生成的
- Visual 为 WPF 中的呈现提供支持，其中包括命中测试、坐标转换和边界框计算
- DependencyObject 表示参与依赖属性系统的对象，如果设置依赖属性直接继承此类即可
完整代码：自定义FrameworkElement类
class FrameworkElement:UIElement { public static readonly DependencyProperty MarginProperty; static FrameworkElement() { FrameworkPropertyMetadata metadata = new FrameworkPropertyMetadata(new Thickness(), FrameworkPropertyMetadataOptions.AffectsMeasure); MarginProperty = DependencyProperty.Register("Margin", typeof(Thickness), typeof(FrameworkElement), metadata, new ValidateValueCallback(FrameworkElement.IsMarginValid)); } private static bool IsMarginValid(object value) { throw new NotImplementedException(); } public Thickness Margin { set { SetValue(MarginProperty, value); } get { return (Thickness)GetValue(MarginProperty); } } }
去掉ValidateValueCallback参数
使用
FrameworkElement element = new FrameworkElement(); element.Margin = new Thickness(5);
4.依赖属性变更通知
有两种方式通知依赖属性变化 --后补
（1）属性值创建绑定
（2）编写能够自动改变其他属性或开始动画的触发器
5.共享依赖属性
查看TextBlock源码，没有用DependencyProperty.Register注册，而是使用了TextElement的FontFamilyProperty的依赖属性
FontFamilyProperty = TextElement.FontFamilyProperty.AddOwner(typeof(TextBlock));
6.附加依赖属性
附加属性被应用的类不是定义附加属性的那个类，
比如 DockPanel 的DockProperty属性
[CommonDependencyProperty] public static readonly DependencyProperty DockProperty; static DockPanel() { DockProperty = DependencyProperty.RegisterAttached("Dock", typeof(Dock), typeof(DockPanel), new FrameworkPropertyMetadata(Dock.Left, OnDockChanged), IsValidDock); }
DockPanel.Dock 属性作用到了Border上
<DockPanel LastChildFill="True"> <Border Height="25" Background="SkyBlue" BorderBrush="Black" BorderThickness="1" DockPanel.Dock="Top"> <TextBlock Foreground="Black">Dock = "Top"</TextBlock> </Border> <Border Height="25" Background="SkyBlue" BorderBrush="Black" BorderThickness="1" DockPanel.Dock="Top"> <TextBlock Foreground="Black">Dock = "Top"</TextBlock> </Border> <Border Height="25" Background="LemonChiffon" BorderBrush="Black" BorderThickness="1" DockPanel.Dock="Bottom"> <TextBlock Foreground="Black">Dock = "Bottom"</TextBlock> </Border> <Border Width="200" Background="PaleGreen" BorderBrush="Black" BorderThickness="1" DockPanel.Dock="Left"> <TextBlock Foreground="Black">Dock = "Left"</TextBlock> </Border> <Border Background="White" BorderBrush="Black" BorderThickness="1"> <TextBlock Foreground="Black">This content will "Fill" the remaining space</TextBlock> </Border> </DockPanel>
附加属性不需要进行属性封装，可以用于任何依赖对象
二、属性验证
1.验证回调
2.强制回调
