把对象赋值给属性
一、依赖属性
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.强制回调