DependencyObject Clase

Definición

public ref class DependencyObject : System::Windows::Threading::DispatcherObject

public class DependencyObject : System.Windows.Threading.DispatcherObject

[System.Windows.Markup.NameScopeProperty("NameScope", typeof(System.Windows.NameScope))]
public class DependencyObject : System.Windows.Threading.DispatcherObject

type DependencyObject = class
    inherit DispatcherObject

[<System.Windows.Markup.NameScopeProperty("NameScope", typeof(System.Windows.NameScope))>]
type DependencyObject = class
    inherit DispatcherObject

Public Class DependencyObject
Inherits DispatcherObject

Herencia

Object

DispatcherObject

DependencyObject

Derivado

System.Windows.ContentElement

System.Windows.Controls.DataGridColumn

System.Windows.Controls.GridViewColumn

System.Windows.Controls.Ribbon.Primitives.StarLayoutInfo

System.Windows.Controls.TextSearch

Más…

Atributos

NameScopePropertyAttribute

Ejemplos

En el ejemplo siguiente se deriva de DependencyObject para crear una nueva clase abstracta. A continuación, la clase registra una propiedad adjunta e incluye miembros de soporte técnico para esa propiedad adjunta.

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

Comentarios

La clase DependencyObject habilita los servicios del sistema de propiedades Windows Presentation Foundation (WPF) en sus muchas clases derivadas.

La función principal del sistema de propiedades es calcular los valores de las propiedades y proporcionar una notificación del sistema sobre los valores que han cambiado. Otra clase clave que participa en el sistema de propiedades es DependencyProperty. DependencyProperty habilita el registro de propiedades de dependencia en el sistema de propiedades y proporciona identificación e información sobre cada propiedad de dependencia, mientras que DependencyObject como una clase base permite a los objetos usar las propiedades de dependencia.

DependencyObject los servicios y características incluyen lo siguiente:

• Compatibilidad con el hospedaje de propiedades de dependencia. Para registrar una propiedad de dependencia, llame al Register método y almacene el valor devuelto del método como un campo estático público en la clase.

• Compatibilidad con hospedaje de propiedades adjuntas. Para registrar una propiedad adjunta, llame al RegisterAttached método y almacene el valor devuelto del método como un campo de solo lectura estático público en la clase. (También hay requisitos de miembros adicionales; tenga en cuenta que esto representa una implementación WPF específica para las propiedades adjuntas. Para obtener más información, consulte Información general sobre las propiedadesattached). A continuación, la propiedad adjunta se puede establecer en cualquier clase que derive de DependencyObject.

• Obtiene, establece y borra los métodos de utilidad para los valores de las propiedades de dependencia que existen en .DependencyObject

• Metadatos, compatibilidad con valores de coerción, notificación de cambio de propiedad e invalidación de devoluciones de llamada para propiedades de dependencia o propiedades adjuntas. Además, la DependencyObject clase facilita los metadatos de propiedad por propietario para una propiedad de dependencia.

• Una clase base común para las clases derivadas de ContentElement, Freezableo Visual. (UIElement, otra clase de elemento base, tiene una jerarquía de clases que incluye Visual).

Consulte también

• DependencyProperty