DependencyObject Classe

Definizione

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

Ereditarietà

Object

DispatcherObject

DependencyObject

Derivato

System.Windows.ContentElement

System.Windows.Controls.DataGridColumn

System.Windows.Controls.GridViewColumn

System.Windows.Controls.Ribbon.Primitives.StarLayoutInfo

System.Windows.Controls.TextSearch

Altro…

Attributi

NameScopePropertyAttribute

Esempio

L'esempio seguente deriva da DependencyObject per creare una nuova classe astratta. La classe registra quindi una proprietà associata e include membri di supporto per tale proprietà associata.

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

Commenti

La DependencyObject classe abilita i servizi di sistema delle proprietà Windows Presentation Foundation (WPF) nelle relative numerose classi derivate.

La funzione primaria del sistema delle proprietà consiste nel calcolare i valori delle proprietà e fornire una notifica di sistema sui valori modificati. Un'altra classe chiave che partecipa al sistema delle proprietà è DependencyProperty. DependencyProperty abilita la registrazione delle proprietà di dipendenza nel sistema delle proprietà e fornisce informazioni e identificazione su ogni proprietà di dipendenza, mentre DependencyObject come classe base consente agli oggetti di usare le proprietà di dipendenza.

DependencyObject i servizi e le caratteristiche includono quanto segue:

• Supporto per l'hosting delle proprietà di dipendenza. Si registra una proprietà di dipendenza chiamando il metodo e archiviando il Register valore restituito del metodo come campo statico pubblico nella classe.

• Supporto per l'hosting delle proprietà associate. Si registra una proprietà associata chiamando il metodo e archiviando il RegisterAttached valore restituito del metodo come campo di sola lettura statico pubblico nella classe. Sono disponibili anche requisiti aggiuntivi per i membri. Si noti che rappresenta un'implementazione specifica WPF per le proprietà associate. Per informazioni dettagliate, vedere Panoramica delle proprietà associate. La proprietà associata può quindi essere impostata su qualsiasi classe che deriva da DependencyObject.

• Ottenere, impostare e cancellare i metodi di utilità per i valori di tutte le proprietà di dipendenza esistenti in DependencyObject.

• Metadati, supporto dei valori di coerce, notifica modificata della proprietà e override dei callback per le proprietà di dipendenza o le proprietà associate. Inoltre, la DependencyObject classe facilita i metadati delle proprietà per proprietario per una proprietà di dipendenza.

• Classe di base comune per le classi derivate da ContentElement, Freezableo Visual. Un'altraUIElement classe di elementi di base ha una gerarchia di classi che include Visual.)

Costruttori

Proprietà

Metodi

Si applica a

Vedi anche

• DependencyProperty