DependencyObject 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示参与依赖属性系统的对象。
public ref class DependencyObject : System::Windows::Threading::DispatcherObjectpublic class DependencyObject : System.Windows.Threading.DispatcherObject[System.Windows.Markup.NameScopeProperty("NameScope", typeof(System.Windows.NameScope))]
public class DependencyObject : System.Windows.Threading.DispatcherObjecttype DependencyObject = class
inherit DispatcherObject[<System.Windows.Markup.NameScopeProperty("NameScope", typeof(System.Windows.NameScope))>]
type DependencyObject = class
inherit DispatcherObjectPublic Class DependencyObject
Inherits DispatcherObject- 继承
- 派生
- 属性
示例
以下示例派生自 DependencyObject 创建新的抽象类。 然后，该类注册附加属性，并包括该附加属性的支持成员。
public abstract class AquariumObject3 : DependencyObject
{
public enum Bouyancy
{
Floats,
Sinks,
Drifts
}
public static readonly DependencyProperty BouyancyProperty = DependencyProperty.RegisterAttached(
"Bouyancy",
typeof(Bouyancy),
typeof(AquariumObject3),
new FrameworkPropertyMetadata(Bouyancy.Floats, FrameworkPropertyMetadataOptions.AffectsArrange),
new ValidateValueCallback(ValidateBouyancy)
);
public static void SetBouyancy(UIElement element, Bouyancy value)
{
element.SetValue(BouyancyProperty, value);
}
public static Bouyancy GetBouyancy(UIElement element)
{
return (Bouyancy)element.GetValue(BouyancyProperty);
}
private static bool ValidateBouyancy(object value)
{
Bouyancy bTest = (Bouyancy) value;
return (bTest == Bouyancy.Floats || bTest == Bouyancy.Drifts || bTest==Bouyancy.Sinks);
}
public static readonly DependencyProperty IsDirtyProperty = DependencyProperty.Register(
"IsDirty",
typeof(Boolean),
typeof(AquariumObject3)
);
}
Public MustInherit Class AquariumObject3
Inherits DependencyObject
Public Enum Bouyancy
Floats
Sinks
Drifts
End Enum
Public Shared ReadOnly BouyancyProperty As DependencyProperty = DependencyProperty.RegisterAttached("Bouyancy", GetType(Bouyancy), GetType(AquariumObject3), New FrameworkPropertyMetadata(Bouyancy.Floats, FrameworkPropertyMetadataOptions.AffectsArrange), New ValidateValueCallback(AddressOf ValidateBouyancy))
Public Shared Sub SetBouyancy(ByVal element As UIElement, ByVal value As Bouyancy)
element.SetValue(BouyancyProperty, value)
End Sub
Public Shared Function GetBouyancy(ByVal element As UIElement) As Bouyancy
Return CType(element.GetValue(BouyancyProperty), Bouyancy)
End Function
Private Shared Function ValidateBouyancy(ByVal value As Object) As Boolean
Dim bTest As Bouyancy = CType(value, Bouyancy)
Return (bTest = Bouyancy.Floats OrElse bTest = Bouyancy.Drifts OrElse bTest = Bouyancy.Sinks)
End Function
Public Shared ReadOnly IsDirtyProperty As DependencyProperty = DependencyProperty.Register("IsDirty", GetType(Boolean), GetType(AquariumObject3))
End Class
注解
DependencyObject 类在其许多派生类上启用Windows Presentation Foundation（WPF）属性系统服务。
属性系统的主要函数是计算属性的值，并提供有关已更改的值的系统通知。 参与属性系统的另一个关键类是 DependencyProperty。 DependencyProperty 允许将依赖属性注册到属性系统中，并提供有关每个依赖属性的标识和信息，而 DependencyObject 基类使对象能够使用依赖属性。
DependencyObject 服务和特征包括：
依赖属性托管支持。 通过调用 Register 该方法并将方法的返回值存储为类中的公共静态字段来注册依赖属性。
附加属性托管支持。 通过调用 RegisterAttached 该方法并将方法的返回值存储为类中的公共静态只读字段来注册附加属性。 （还有其他成员要求;请注意，这表示附加属性的特定实现WPF。有关详细信息，请参阅 Attached 属性概述。）然后，可以在派生自 DependencyObject 的任何类上设置附加属性。
获取、设置和清除存在于任何依赖属性的值的 DependencyObject实用工具方法。
元数据、强制值支持、属性更改通知和重写依赖项属性或附加属性的回调。 此外，该 DependencyObject 类还有助于依赖属性的按所有者属性元数据。
派生自 ContentElement、 Freezable或 Visual的类的公用基类。 （UIElement，另一个基元素类，具有包含 Visual.）
构造函数
| 名称 | 说明 |
|---|---|
| DependencyObject() |
初始化 DependencyObject 类的新实例。 |
属性
| 名称 | 说明 |
|---|---|
| DependencyObjectType |
获取包装 DependencyObjectType 此实例的 CLR 类型。 |
| Dispatcher |
获取与此DispatcherDispatcherObject关联的值。 (继承自 DispatcherObject) |
| IsSealed |
获取一个值，该值指示此实例当前是否密封（只读）。 |