FrameworkPropertyMetadata Konstruktoren

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse.

Überlädt

FrameworkPropertyMetadata()	Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse.
FrameworkPropertyMetadata(Object)	Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem angegebenen Standardwert.
FrameworkPropertyMetadata(PropertyChangedCallback)	Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem angegebenen PropertyChangedCallback-Rückruf.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)	Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem bereitgestellten Standardwert und Metadatenoptionen auf Frameworkebene.
FrameworkPropertyMetadata(Object, PropertyChangedCallback)	Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem angegebenen Standardwert und dem angegebenen PropertyChangedCallback-Rückruf.
FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)	Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit den angegebenen Rückrufen.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)	Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem bereitgestellten Standardwert und Metadatenoptionen auf Frameworkebene sowie dem angegebenen PropertyChangedCallback-Rückruf.
FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)	Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem angegebenen Standardwert und den angegebenen Rückrufen.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)	Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem bereitgestellten Standardwert und Metadatenoptionen auf Frameworkebene sowie den angegebenen Rückrufen.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean)	Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem bereitgestellten Standardwert und Metadatenoptionen auf Frameworkebene, den angegebenen Rückrufen und einem booleschen Wert, mit dem die Animation der Eigenschaft verhindert werden kann.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger)	Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem bereitgestellten Standardwert und Metadatenoptionen auf Frameworkebene, den angegebenen Rückrufen, einem booleschen Wert, mit dem die Animation der Eigenschaft verhindert werden kann, und einem Standardwert für den Aktualisierungstrigger der Datenbindung.

FrameworkPropertyMetadata()

Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse.

public:
 FrameworkPropertyMetadata();

public FrameworkPropertyMetadata ();

Public Sub New ()

Hinweise

Diese Signatur initialisiert alle Werte von FrameworkPropertyMetadata auf die Eigenschaftenstandardwerte. DefaultValue wird sein null, und die verschiedenen FrameworkPropertyMetadata booleschen Eigenschaften sind false.

Weitere Informationen

• PropertyMetadata

FrameworkPropertyMetadata(Object)

Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem angegebenen Standardwert.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue);

public FrameworkPropertyMetadata (object defaultValue);

new System.Windows.FrameworkPropertyMetadata : obj -> System.Windows.FrameworkPropertyMetadata

Public Sub New (defaultValue As Object)

Parameter

defaultValue

Object

Der Standardwert für die Abhängigkeitseigenschaft, der normalerweise als Wert eines bestimmten Typs angegeben wird.

Ausnahmen

ArgumentException

Für defaultValue ist UnsetValue festgelegt.

Beispiele

Im folgenden Beispiel wird diese Konstruktorsignatur aufgerufen:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(Double.NaN);

Hinweise

Der Typ des für defaultValue bereitgestellten Werts muss mit dem Typ übereinstimmen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben wurde, auf die diese Metadaten angewendet werden. Konflikte zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet werden, können schwierig zu debuggen sein, da der Konflikt während der Kompilierung nicht erkennbar ist. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyp-/Eigenschaftstypkonflikts ein Laufzeitfehler ist.

Der Wert UnsetValue hat im Eigenschaftensystem eine besondere Bedeutung und kann nicht als Standardwert der Abhängigkeitseigenschaft verwendet werden.

Weitere Informationen

• PropertyMetadata

FrameworkPropertyMetadata(PropertyChangedCallback)

Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem angegebenen PropertyChangedCallback-Rückruf.

public:
 FrameworkPropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback);

public FrameworkPropertyMetadata (System.Windows.PropertyChangedCallback propertyChangedCallback);

new System.Windows.FrameworkPropertyMetadata : System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadata

Public Sub New (propertyChangedCallback As PropertyChangedCallback)

Parameter

propertyChangedCallback

PropertyChangedCallback

Ein Verweis auf eine Handlerimplementierung, die das Eigenschaftensystem aufruft, wenn der effektive Wert der Eigenschaft geändert wird.

Beispiele

Im folgenden Beispiel wird diese Konstruktorsignatur aufgerufen:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(new PropertyChangedCallback(OnCurrentReadingChanged));

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem bereitgestellten Standardwert und Metadatenoptionen auf Frameworkebene.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags);

public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags);

new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions -> System.Windows.FrameworkPropertyMetadata

Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions)

Parameter

defaultValue

Object

Der Standardwert für die Abhängigkeitseigenschaft, der normalerweise als Wert eines bestimmten Typs angegeben wird.

flags

FrameworkPropertyMetadataOptions

Die Flags für die Metadatenoptionen (eine Kombination von FrameworkPropertyMetadataOptions Werten). Diese Optionen geben Merkmale der Abhängigkeitseigenschaft an, die mit Systemen wie Layout oder Datenbindung zusammen arbeiten.

Ausnahmen

ArgumentException

Für defaultValue ist UnsetValue festgelegt.

Beispiele

Im folgenden Beispiel wird diese Konstruktorsignatur aufgerufen:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault)
);

Hinweise

Der Typ des für defaultValue bereitgestellten Werts muss mit dem Typ übereinstimmen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben wurde, auf die diese Metadaten angewendet werden. Konflikte zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet werden, können schwierig zu debuggen sein, da der Konflikt während der Kompilierung nicht erkennbar ist. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyp-/Eigenschaftstypkonflikts ein Laufzeitfehler ist.

Der Wert UnsetValue hat im Eigenschaftensystem eine besondere Bedeutung und kann nicht als Standardwert der Abhängigkeitseigenschaft verwendet werden.

Werte, die flags im Parameter als festgelegte Flags markiert sind, legen den booleschen Wert von FrameworkPropertyMetadata Eigenschaften, die dem Namen dieses FrameworkPropertyMetadataOptions Flags entsprechen, auf fest true. Anschließend können Sie die Werte der Eigenschaften in den Metadaten ändern, solange die Metadaten noch nicht auf einen bestimmten Eigenschaftensystemvorgang angewendet wurden.

Weitere Informationen

• PropertyMetadata

FrameworkPropertyMetadata(Object, PropertyChangedCallback)

Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem angegebenen Standardwert und dem angegebenen PropertyChangedCallback-Rückruf.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback);

public FrameworkPropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback);

new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadata

Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback)

Parameter

defaultValue

Object

Der Standardwert für die Abhängigkeitseigenschaft, der normalerweise als Wert eines bestimmten Typs angegeben wird.

propertyChangedCallback

PropertyChangedCallback

Ein Verweis auf eine Handlerimplementierung, die das Eigenschaftensystem aufruft, wenn der effektive Wert der Eigenschaft geändert wird.

Ausnahmen

ArgumentException

Für defaultValue ist UnsetValue festgelegt.

Beispiele

Im folgenden Beispiel wird diese Konstruktorsignatur aufgerufen:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged)
);

Hinweise

Der Typ des für defaultValue bereitgestellten Werts muss mit dem Typ übereinstimmen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben wurde, auf die diese Metadaten angewendet werden. Konflikte zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet werden, können schwierig zu debuggen sein, da der Konflikt während der Kompilierung nicht erkennbar ist. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyp-/Eigenschaftstypkonflikts ein Laufzeitfehler ist.

Der Wert UnsetValue hat im Eigenschaftensystem eine besondere Bedeutung und kann nicht als Standardwert der Abhängigkeitseigenschaft verwendet werden.

Weitere Informationen

• PropertyMetadata

FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)

Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit den angegebenen Rückrufen.

public:
 FrameworkPropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);

public FrameworkPropertyMetadata (System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);

new System.Windows.FrameworkPropertyMetadata : System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.FrameworkPropertyMetadata

Public Sub New (propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)

Parameter

propertyChangedCallback

PropertyChangedCallback

Ein Verweis auf eine Handlerimplementierung, die das Eigenschaftensystem aufruft, wenn der effektive Wert der Eigenschaft geändert wird.

coerceValueCallback

CoerceValueCallback

Ein Verweis auf eine Handlerimplementierung wird aufgerufen, wenn das Eigenschaftensystem CoerceValue(DependencyProperty) für diese Abhängigkeitseigenschaft aufruft.

Beispiele

Im folgenden Beispiel wird diese Konstruktorsignatur aufgerufen:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

Hinweise

Diese Implementierung ruft einen Basisinitialisierer auf und fügt dann die coerceValueCallback hinzu, indem die -Eigenschaft für die basisbasierte instance festgelegt wird.

Weitere Informationen

• PropertyMetadata

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem bereitgestellten Standardwert und Metadatenoptionen auf Frameworkebene sowie dem angegebenen PropertyChangedCallback-Rückruf.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback);

public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback);

new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadata

Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback)

Parameter

defaultValue

Object

Der Standardwert für die Abhängigkeitseigenschaft, der normalerweise als Wert eines bestimmten Typs angegeben wird.

flags

FrameworkPropertyMetadataOptions

Die Flags für die Metadatenoptionen (eine Kombination von FrameworkPropertyMetadataOptions Werten). Diese Optionen geben Merkmale der Abhängigkeitseigenschaft an, die mit Systemen wie Layout oder Datenbindung zusammen arbeiten.

propertyChangedCallback

PropertyChangedCallback

Ein Verweis auf eine Handlerimplementierung, die das Eigenschaftensystem aufruft, wenn der effektive Wert der Eigenschaft geändert wird.

Ausnahmen

ArgumentException

Für defaultValue ist UnsetValue festgelegt.

Beispiele

Im folgenden Beispiel wird diese Konstruktorsignatur aufgerufen:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged)
);

Hinweise

Der Typ des für defaultValue bereitgestellten Werts muss mit dem Typ übereinstimmen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben wurde, auf die diese Metadaten angewendet werden. Konflikte zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet werden, können schwierig zu debuggen sein, da der Konflikt während der Kompilierung nicht erkennbar ist. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyp-/Eigenschaftstypkonflikts ein Laufzeitfehler ist.

Der Wert UnsetValue hat im Eigenschaftensystem eine besondere Bedeutung und kann nicht als Standardwert der Abhängigkeitseigenschaft verwendet werden.

Werte, die flags im Parameter als festgelegte Flags markiert sind, legen den booleschen Wert von FrameworkPropertyMetadata Eigenschaften, die dem Namen dieses FrameworkPropertyMetadataOptions Flags entsprechen, auf fest true. Sie können die Werte der Eigenschaften in den Metadaten weiterhin ändern, solange die Metadaten noch nicht auf einen bestimmten Eigenschaftensystemvorgang angewendet wurden.

Weitere Informationen

• PropertyMetadata

FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem angegebenen Standardwert und den angegebenen Rückrufen.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);

public FrameworkPropertyMetadata (object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);

new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.FrameworkPropertyMetadata

Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)

Parameter

defaultValue

Object

Der Standardwert für die Abhängigkeitseigenschaft, der normalerweise als Wert eines bestimmten Typs angegeben wird.

propertyChangedCallback

PropertyChangedCallback

Ein Verweis auf eine Handlerimplementierung, die das Eigenschaftensystem aufruft, wenn der effektive Wert der Eigenschaft geändert wird.

coerceValueCallback

CoerceValueCallback

Ein Verweis auf eine Handlerimplementierung, der aufgerufen wird, wenn das Eigenschaftensystem CoerceValue(DependencyProperty) für diese Abhängigkeitseigenschaft aufruft.

Ausnahmen

ArgumentException

Für defaultValue ist UnsetValue festgelegt.

Beispiele

Im folgenden Beispiel wird diese Konstruktorsignatur aufgerufen:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

Hinweise

Der Typ des für defaultValue bereitgestellten Werts muss mit dem Typ übereinstimmen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben wurde, auf die diese Metadaten angewendet werden. Konflikte zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet werden, können schwierig zu debuggen sein, da der Konflikt während der Kompilierung nicht erkennbar ist. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyp-/Eigenschaftstypkonflikts ein Laufzeitfehler ist.

Der Wert UnsetValue hat im Eigenschaftensystem eine besondere Bedeutung und kann nicht als Standardwert der Abhängigkeitseigenschaft verwendet werden.

Weitere Informationen

• PropertyMetadata

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)

Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem bereitgestellten Standardwert und Metadatenoptionen auf Frameworkebene sowie den angegebenen Rückrufen.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);

public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);

new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.FrameworkPropertyMetadata

Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)

Parameter

defaultValue

Object

Der Standardwert für die Abhängigkeitseigenschaft, der normalerweise als Wert eines bestimmten Typs angegeben wird.

flags

FrameworkPropertyMetadataOptions

Die Flags für die Metadatenoptionen (eine Kombination von FrameworkPropertyMetadataOptions Werten). Diese Optionen geben Merkmale der Abhängigkeitseigenschaft an, die mit Systemen wie Layout oder Datenbindung zusammen arbeiten.

propertyChangedCallback

PropertyChangedCallback

Ein Verweis auf eine Handlerimplementierung, die das Eigenschaftensystem aufruft, wenn der effektive Wert der Eigenschaft geändert wird.

coerceValueCallback

CoerceValueCallback

Ein Verweis auf eine Handlerimplementierung, der aufgerufen wird, wenn das Eigenschaftensystem CoerceValue(DependencyProperty) für diese Abhängigkeitseigenschaft aufruft.

Ausnahmen

ArgumentException

Für defaultValue ist UnsetValue festgelegt.

Beispiele

Im folgenden Beispiel wird diese Konstruktorsignatur aufgerufen:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

Hinweise

Der Typ des für defaultValue bereitgestellten Werts muss mit dem Typ übereinstimmen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben wurde, auf die diese Metadaten angewendet werden. Konflikte zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet werden, können schwierig zu debuggen sein, da der Konflikt während der Kompilierung nicht erkennbar ist. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyp-/Eigenschaftstypkonflikts ein Laufzeitfehler ist.

Der Wert UnsetValue hat im Eigenschaftensystem eine besondere Bedeutung und kann nicht als Standardwert der Abhängigkeitseigenschaft verwendet werden.

Werte, die flags im Parameter als festgelegte Flags markiert sind, legen den booleschen Wert von FrameworkPropertyMetadata Eigenschaften, die dem Namen dieses FrameworkPropertyMetadataOptions Flags entsprechen, auf fest true. Sie können die Werte der Eigenschaften in den Metadaten weiterhin ändern, solange die Metadaten noch nicht auf einen bestimmten Eigenschaftensystemvorgang angewendet wurden.

Weitere Informationen

• PropertyMetadata

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean)

Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem bereitgestellten Standardwert und Metadatenoptionen auf Frameworkebene, den angegebenen Rückrufen und einem booleschen Wert, mit dem die Animation der Eigenschaft verhindert werden kann.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback, bool isAnimationProhibited);

public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback, bool isAnimationProhibited);

new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback * bool -> System.Windows.FrameworkPropertyMetadata

Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback, isAnimationProhibited As Boolean)

Parameter

defaultValue

Object

Der Standardwert für die Abhängigkeitseigenschaft, der normalerweise als Wert eines bestimmten Typs angegeben wird.

flags

FrameworkPropertyMetadataOptions

Die Flags für die Metadatenoptionen (eine Kombination von FrameworkPropertyMetadataOptions Werten). Diese Optionen geben Merkmale der Abhängigkeitseigenschaft an, die mit Systemen wie Layout oder Datenbindung zusammen arbeiten.

propertyChangedCallback

PropertyChangedCallback

Ein Verweis auf eine Handlerimplementierung, die das Eigenschaftensystem aufruft, wenn der effektive Wert der Eigenschaft geändert wird.

coerceValueCallback

CoerceValueCallback

Ein Verweis auf eine Handlerimplementierung, der aufgerufen wird, wenn das Eigenschaftensystem CoerceValue(DependencyProperty) für diese Abhängigkeitseigenschaft aufruft.

isAnimationProhibited

Boolean

true, um zu verhindern, dass das Eigenschaftensystem die Eigenschaft animiert, auf die diese Metadaten angewendet werden. Diese Eigenschaften lösen eine Laufzeitausnahme aus, die aus dem Eigenschaftensystem stammt, wenn versucht wird, sie zu animieren. false, um das Animieren der Eigenschaft zuzulassen. Der Standardwert ist false.

Ausnahmen

ArgumentException

Für defaultValue ist UnsetValue festgelegt.

Beispiele

Im folgenden Beispiel wird diese Konstruktorsignatur aufgerufen:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading),
    true //Animation prohibited
);

Hinweise

Der Typ des für defaultValue bereitgestellten Werts muss mit dem Typ übereinstimmen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben wurde, auf die diese Metadaten angewendet werden. Konflikte zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet werden, können schwierig zu debuggen sein, da der Konflikt während der Kompilierung nicht erkennbar ist. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyp-/Eigenschaftstypkonflikts ein Laufzeitfehler ist.

Der Wert UnsetValue hat im Eigenschaftensystem eine besondere Bedeutung und kann nicht als Standardwert der Abhängigkeitseigenschaft verwendet werden.

Der isAnimationProhibited -Parameter legt den Anfangswert der Eigenschaft fest, die IsAnimationProhibited von der unmittelbaren Basisklasse UIPropertyMetadata deklariert wurde.

Werte, die flags im Parameter als festgelegte Flags markiert sind, legen den booleschen Wert von FrameworkPropertyMetadata Eigenschaften, die dem Namen dieses FrameworkPropertyMetadataOptions Flags entsprechen, auf fest true. Sie können die Werte der Eigenschaften in den Metadaten weiterhin ändern, solange die Metadaten noch nicht auf einen bestimmten Eigenschaftensystemvorgang angewendet wurden.

Weitere Informationen

• PropertyMetadata

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger)

Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse mit dem bereitgestellten Standardwert und Metadatenoptionen auf Frameworkebene, den angegebenen Rückrufen, einem booleschen Wert, mit dem die Animation der Eigenschaft verhindert werden kann, und einem Standardwert für den Aktualisierungstrigger der Datenbindung.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback, bool isAnimationProhibited, System::Windows::Data::UpdateSourceTrigger defaultUpdateSourceTrigger);

public FrameworkPropertyMetadata (object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback, bool isAnimationProhibited, System.Windows.Data.UpdateSourceTrigger defaultUpdateSourceTrigger);

new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback * bool * System.Windows.Data.UpdateSourceTrigger -> System.Windows.FrameworkPropertyMetadata

Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback, isAnimationProhibited As Boolean, defaultUpdateSourceTrigger As UpdateSourceTrigger)

Parameter

defaultValue

Object

Der Standardwert für die Abhängigkeitseigenschaft, der normalerweise als Wert eines bestimmten Typs angegeben wird.

flags

FrameworkPropertyMetadataOptions

Die Flags für die Metadatenoptionen (eine Kombination von FrameworkPropertyMetadataOptions Werten). Diese Optionen geben Merkmale der Abhängigkeitseigenschaft an, die mit Systemen wie Layout oder Datenbindung zusammen arbeiten.

propertyChangedCallback

PropertyChangedCallback

Ein Verweis auf eine Handlerimplementierung, die das Eigenschaftensystem aufruft, wenn der effektive Wert der Eigenschaft geändert wird.

coerceValueCallback

CoerceValueCallback

Ein Verweis auf eine Handlerimplementierung, der aufgerufen wird, wenn das Eigenschaftensystem CoerceValue(DependencyProperty) für diese Abhängigkeitseigenschaft aufruft.

isAnimationProhibited

Boolean

true, um zu verhindern, dass das Eigenschaftensystem die Eigenschaft animiert, auf die diese Metadaten angewendet werden. Diese Eigenschaften lösen eine Laufzeitausnahme aus, die aus dem Eigenschaftensystem stammt, wenn versucht wird, sie zu animieren. Der Standardwert ist false.

defaultUpdateSourceTrigger

UpdateSourceTrigger

Der UpdateSourceTrigger, der verwendet werden soll, wenn Bindungen für diese Eigenschaft angewendet werden, deren UpdateSourceTrigger auf Default festgelegt ist.

Ausnahmen

ArgumentException

Für defaultValue ist UnsetValue festgelegt.

Beispiele

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading),
    true //Animation prohibited
    , UpdateSourceTrigger.PropertyChanged
);

Hinweise

Der Typ des für defaultValue bereitgestellten Werts muss mit dem Typ übereinstimmen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben wurde, auf die diese Metadaten angewendet werden. Konflikte zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet werden, können schwierig zu debuggen sein, da der Konflikt während der Kompilierung nicht erkennbar ist. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyp-/Eigenschaftstypkonflikts ein Laufzeitfehler ist.

Der Wert UnsetValue hat im Eigenschaftensystem eine besondere Bedeutung und kann nicht als Standardwert der Abhängigkeitseigenschaft verwendet werden.

Der isAnimationProhibited -Parameter legt den Anfangswert der Eigenschaft fest, die IsAnimationProhibited von der unmittelbaren Basisklasse UIPropertyMetadata deklariert wurde.

Weitere Informationen zum Updatequellverhalten für Bindungen finden Sie unter Übersicht über die Datenbindung.

Werte, die flags im Parameter als festgelegte Flags markiert sind, legen den booleschen Wert von FrameworkPropertyMetadata Eigenschaften, die dem Namen dieses FrameworkPropertyMetadataOptions Flags entsprechen, auf fest true. Sie können die Werte der Eigenschaften in den Metadaten weiterhin ändern, solange die Metadaten noch nicht auf einen bestimmten Eigenschaftensystemvorgang angewendet wurden.

Weitere Informationen

• PropertyMetadata