附加属性的使用

附加属性

一、为什么需要定义附加属性：

• 附加属性是一种依赖属性，与依赖属性不同的是，附加属性被应用的类不是定义附加属性的类。

• 某个依赖属性本来不属于某个对象，但由于某种需求，该对象需要这个依赖属性，这时就需要将该依赖属性定义为附加属性。

二、创建附加属性的快捷方式：输入propa,再敲两次Tab键

三、不使用属性封装器：因为附加属性是可以被用于任何对象。

• 通过调用两个静态方法分别包装SetValue()和GetValue()，这两个方法应当命名为SetPropertyName()和GetPropertyName()。

1 public static bool GetIsRotate(DependencyObject obj)
2 {
3     return (bool)obj.GetValue(IsRotateProperty);
4 }
5  
6 public static void SetIsRotate(DependencyObject obj, bool value)
7 {
8      obj.SetValue(IsRotateProperty, value);
9 }

四、附加属性的定义：

（1）利用快捷键生成的附加属性模板如下：需要使用RigisterAttached方法。

1 public static readonly DependencyProperty MyPropertyProperty =
2             DependencyProperty.RegisterAttached("MyProperty", typeof(int), typeof(ownerclass), new PropertyMetadata(0));

（2）注册附加属性的方式有多种，上述是最常用的一种。注册参数最多有五个：

1 public static DependencyProperty RegisterAttached(string name, Type propertyType, Type ownerType, PropertyMetadata defaultMetadata, ValidateValueCallback validateValueCallback);

（3）在模板基础上编辑自己的附加属性IsRotate：

1 public static readonly DependencyProperty IsRotateProperty =
2             DependencyProperty.RegisterAttached("IsRotate", typeof(bool), typeof(YMDemo), new PropertyMetadata(0));

• 参数一（IsRotate）:要注册的附加属性的名称。

• 参数二（typeof(bool)）:声明属性IsRotate的类型是bool。

• 参数三（typeof(YMDemo)）:依赖属性IsRotate的所有者类型，即定义该附加属性的类是YMDemo。

• 参数四的类型是PropertyMetadata类：该类有5个重载的构造函数，参数最多是三个，示例中使用的是传参为DefaultValue的构造函数。

1 public PropertyMetadata(object defaultValue);
2 
3 public PropertyMetadata(object defaultValue, PropertyChangedCallback propertyChangedCallback, CoerceValueCallback coerceValueCallback);

•  DefaultValue：附加属性未被显式赋值时，使用该默认值。

•  PropertyChangedCallback：附加属性的值被改变之后，此委托会被调用，此委托可关联一个影响函数。

•  CoerceValueCallback：附加属性值被强制改变时此委托会被调用，对赋值进行检查，强制对值进行赋值，返回值为Object类型，这个才是要赋给属性的值，此委托可关联一个影响函数。

五、属性value更改后,发生校正的流程：

六、依赖属性的使用

(1)在YMDemo.xaml.cs中定义附加属性IsRotate;

(2)在MainWindow.xaml中如果想要Grid控件使用IsRotate属性：

<Window x:Class="DependencyPropertyDemo.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        xmlns:local="clr-namespace:DependencyPropertyDemo"
        mc:Ignorable="d"
        Title="MainWindow" Height="450" Width="800">

    <Grid local:YMDemo.IsRotate="True"/>

Window>

总结：给任何需要的控件（类）提供该属性的使用入口。