DependencyObject Classe

Définition

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

Héritage

Object

DispatcherObject

DependencyObject

Dérivé

System.Windows.ContentElement

System.Windows.Controls.DataGridColumn

System.Windows.Controls.GridViewColumn

System.Windows.Controls.Ribbon.Primitives.StarLayoutInfo

System.Windows.Controls.TextSearch

Plus…

Attributs

NameScopePropertyAttribute

Exemples

L’exemple suivant dérive de DependencyObject la création d’une classe abstraite. La classe inscrit ensuite une propriété jointe et inclut des membres de support pour cette propriété jointe.

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

Remarques

La DependencyObject classe active les services de système de propriétés Windows Presentation Foundation (WPF) sur ses nombreuses classes dérivées.

La fonction principale du système de propriétés consiste à calculer les valeurs des propriétés et à fournir une notification système sur les valeurs qui ont changé. Une autre classe clé qui participe au système de propriétés est DependencyProperty. DependencyProperty permet l’inscription des propriétés de dépendance dans le système de propriétés et fournit des informations d’identification et d’informations sur chaque propriété de dépendance, tandis qu’une DependencyObject classe de base permet aux objets d’utiliser les propriétés de dépendance.

DependencyObject les services et les caractéristiques sont les suivants :

• Prise en charge de l’hébergement des propriétés de dépendance. Vous inscrivez une propriété de dépendance en appelant la Register méthode et en stockant la valeur de retour de la méthode en tant que champ statique public dans votre classe.

• Prise en charge de l’hébergement de propriétés jointes. Vous inscrivez une propriété jointe en appelant la méthode et en stockant la RegisterAttached valeur de retour de la méthode en tant que champ statique statique public dans votre classe. (Il existe également des exigences de membre supplémentaires ; notez que cela représente une implémentation spécifique WPF pour les propriétés jointes. Pour plus d’informations, consultez Vue d’ensemble des propriétés jointes.) Votre propriété jointe peut ensuite être définie sur n’importe quelle classe qui dérive de DependencyObject.

• Obtenez, définissez et effacez les méthodes d’utilitaire pour les valeurs de toutes les propriétés de dépendance qui existent sur le DependencyObject.

• Métadonnées, prise en charge des valeurs de coerce, notification modifiée par les propriétés et remplacement des rappels pour les propriétés de dépendance ou les propriétés jointes. En outre, la DependencyObject classe facilite les métadonnées de propriété par propriétaire pour une propriété de dépendance.

• Classe de base commune pour les classes dérivées de ContentElement, Freezableou Visual. (UIElement, une autre classe d’élément de base, a une hiérarchie de classes qui inclut Visual.)

Constructeurs

Propriétés

Méthodes

S’applique à

Voir aussi

• DependencyProperty