依赖属性的当前值(Current Value),基值(Base Value)和本地值(Local Value)是MSDN常出现的三个词,这些属性和依赖属性的优先级设置有关。
如下表:
这里是当前值 1. 1. 属性系统强制转换,这里是通过依赖属性的CoerceValueCallback 2. 2. 活动动画或者具有Hold行为的动画 这里是基值 3. 3. 本地值,通过依赖属性的SetValue方法,资源,绑定 4. 4. 其他方式如样式,触发器等…… |
这里列出一部分以依赖属性值优先级的情况,完整列表请参考MSDN:http://msdn.microsoft.com/zh-cn/library/ms743230.aspx
当前值:
是最外层的属性值,可能经过一些列的处理或影响而得到的最终值。
基值:
当依赖属性没有经过系统强制转换,没有经过动画处理影响的值,就是上表中在第三项之上,但没有被一和二项所影响的值。
本地值:
这个是比较直观设置的值,是通过依赖属性SetValue方法或者资源或绑定设置的值。
那么如何得到这些值呢?
当前值:通过依赖属性的GetValue方法
基值:通过IAnimatable接口的GetAnimationBaseValue方法
本地值:通过依赖属性的ReadLocalValue方法,如果没有本地值则返回DependencyProperty.UnsetValue字段
假设有两个按钮,名称分别是btn1和btn2,程序运行后,按钮的宽度(Width依赖属性)都会被DoubleAnimation动画从50变为100,两个按钮的唯一区别是btn1的Width是直接设置的。btn2的Width是通过样式的Setter设置的。
那么当动画结束后,两个按钮的Width依赖属性的具体值是这样的:
btn1 | btn2 | |
当前值 | 100 | 100 |
基值 | 50 | 50 |
本地值 | 50 | DependencyProperty.UnsetValue |
由于动画设置了依赖属性,所以当前值是100.
而在动画前,Width都是50,所以基值都是50
而btn1直接设置了Width,就是调用了依赖属性的SetValue,所以本地值被设置。
而btn2通过样式的Setter设置Width,属于上表中的第四项,本地值没有被设置。
通过程序可以实际测试一下:
获取属性的代码参考:
object[] GetValues(object obj, DependencyProperty pro)
{
if (obj is DependencyObject == false || obj is IAnimatable == false)
throw new ArgumentException();
object[] re = new object[3];
var dobj = (DependencyObject)obj;
var ianm = (IAnimatable)obj;
re[0] = dobj.GetValue(pro);
re[1] = ianm.GetAnimationBaseValue(pro);
re[2] = dobj.ReadLocalValue(pro);
return re;
}
string GetValuesString(object obj, DependencyProperty pro,string name)
{
var objs = GetValues(obj, pro);
return String.Format("{3}\n当前值:{0}\n基值:{1}\n本地值:{2}\n\n",
objs[0], objs[1], objs[2], name);
}
两个按钮XAML动画定义:
<Button Width="50" Height="30" Name="btn1" Content="1" >
<Button.Triggers>
<EventTrigger RoutedEvent="Button.Loaded">
<EventTrigger.Actions>
<BeginStoryboard>
<Storyboard>
<DoubleAnimation Storyboard.TargetProperty="Width"
To="100" Duration="0:0:0.5"/>
</Storyboard>
</BeginStoryboard>
</EventTrigger.Actions>
</EventTrigger>
</Button.Triggers>
</Button>
<Button Height="30" Name="btn2" Content="2" >
<Button.Style>
<Style TargetType="Button">
<Setter Property="Width" Value="50"/>
</Style>
</Button.Style>
<Button.Triggers>
<EventTrigger RoutedEvent="Button.Loaded">
<EventTrigger.Actions>
<BeginStoryboard>
<Storyboard>
<DoubleAnimation Storyboard.TargetProperty="Width"
To="100" Duration="0:0:0.5"/>
</Storyboard>
</BeginStoryboard>
</EventTrigger.Actions>
</EventTrigger>
</Button.Triggers>
</Button>