附加属性的使用

附加属性 【附加属性的使用】一、为什么需要定义附加属性:

  • 附加属性是一种依赖属性,与依赖属性不同的是,附加属性被应用的类不是定义附加属性的类。
  • 某个依赖属性本来不属于某个对象,但由于某种需求,该对象需要这个依赖属性,这时就需要将该依赖属性定义为附加属性。
二、创建附加属性的快捷方式:输入propa,再敲两次Tab键
三、不使用属性封装器:因为附加属性是可以被用于任何对象。
  • 通过调用两个静态方法分别包装SetValue()和GetValue(),这两个方法应当命名为SetPropertyName()和GetPropertyName()。
1 public static bool GetIsRotate(DependencyObject obj) 2 { 3return (bool)obj.GetValue(IsRotateProperty); 4 } 5 6 public static void SetIsRotate(DependencyObject obj, bool value) 7 { 8obj.SetValue(IsRotateProperty, value); 9 }

四、附加属性的定义:
(1)利用快捷键生成的附加属性模板如下:需要使用RigisterAttached方法。

1 public static readonly DependencyProperty MyPropertyProperty = 2DependencyProperty.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 = 2DependencyProperty.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属性:


总结:给任何需要的控件(类)提供该属性的使用入口。

    推荐阅读