附加属性的使用

  • A+
所属分类:.NET技术
摘要

一、为什么需要定义附加属性: 附加属性是一种依赖属性,与依赖属性不同的是,附加属性被应用的类不是定义附加属性的类。


附加属性

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

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

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

二、创建附加属性的快捷方式:输入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>

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