FrameworkPropertyMetadata Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse.
Überlädt
| Name | Beschreibung |
|---|---|
| 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 den bereitgestellten Metadatenoptionen für Standardwerte und Metadaten auf Frameworkebene. |
| FrameworkPropertyMetadata(Object, PropertyChangedCallback) |
Initialisiert eine neue Instanz der FrameworkPropertyMetadata Klasse mit dem bereitgestellten 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 den bereitgestellten Standardwert- und Framework-Metadatenoptionen und dem angegebenen PropertyChangedCallback Rückruf. |
| FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback) |
Initialisiert eine neue Instanz der FrameworkPropertyMetadata Klasse mit dem bereitgestellten Standardwert und den angegebenen Rückrufen. |
| FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback) |
Initialisiert eine neue Instanz der FrameworkPropertyMetadata Klasse mit den bereitgestellten Standardwert- und Framework-Metadatenoptionen und angegebenen Rückrufen. |
| FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean) |
Initialisiert eine neue Instanz der FrameworkPropertyMetadata Klasse mit den bereitgestellten Standardwert- und Framework-Metadatenoptionen, angegebenen Rückrufen und einem booleschen Wert, der verwendet werden kann, um die Animation der Eigenschaft zu verhindern. |
| FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger) |
Initialisiert eine neue Instanz der FrameworkPropertyMetadata Klasse mit den bereitgestellten Standardwert- und Framework-Metadatenoptionen, angegebenen Rückrufen, einem booleschen Wert, der verwendet werden kann, um animationen der Eigenschaft zu verhindern, und ein Standard für datenbindungsaktualisierungsauslöser. |
FrameworkPropertyMetadata()
Initialisiert eine neue Instanz der FrameworkPropertyMetadata-Klasse.
public:
FrameworkPropertyMetadata();public FrameworkPropertyMetadata();Public Sub New ()Hinweise
Diese Signatur initialisiert alle Werte ihrer FrameworkPropertyMetadata Eigenschaftsstandardwerte.
DefaultValue
nullist , und die verschiedenen booleschen FrameworkPropertyMetadata Eigenschaften werden .false
Weitere Informationen
Gilt für:
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.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object)Parameter
- defaultValue
- Object
Der Standardwert der Abhängigkeitseigenschaft, in der Regel als Wert eines bestimmten Typs angegeben.
Ausnahmen
defaultValue ist auf UnsetValue festgelegt.
Beispiele
Im folgenden Beispiel wird diese Konstruktorsignatur aufgerufen:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(Double.NaN);
Hinweise
Der Typ des bereitgestellten defaultValue Werts muss übereinstimmen oder mit dem Typ in Verbindung stehen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben ist, auf die diese Metadaten angewendet werden. Übereinstimmungen zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet wird, können schwierig zu debuggen sein, da die Übereinstimmung während der Kompilierung nicht erkannt werden kann. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyps/eines Eigenschaftstyps ein Laufzeitfehler ist.
Der Wert UnsetValue hat eine besondere Bedeutung im Eigenschaftensystem und kann nicht als Standardwert für Abhängigkeitseigenschaften verwendet werden.
Weitere Informationen
Gilt für:
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.FrameworkPropertyMetadataPublic Sub New (propertyChangedCallback As PropertyChangedCallback)Parameter
- propertyChangedCallback
- PropertyChangedCallback
Ein Verweis auf eine Handlerimplementierung, die vom Eigenschaftensystem aufgerufen wird, wenn sich der effektive Wert der Eigenschaft ändert.
Beispiele
Im folgenden Beispiel wird diese Konstruktorsignatur aufgerufen:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(new PropertyChangedCallback(OnCurrentReadingChanged));
Gilt für:
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)
Initialisiert eine neue Instanz der FrameworkPropertyMetadata Klasse mit den bereitgestellten Metadatenoptionen für Standardwerte und Metadaten 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.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions)Parameter
- defaultValue
- Object
Der Standardwert der Abhängigkeitseigenschaft, in der Regel als Wert eines bestimmten Typs angegeben.
Die Metadatenoptionskennzeichnungen (eine Kombination von FrameworkPropertyMetadataOptions Werten). Diese Optionen geben Merkmale der Abhängigkeitseigenschaft an, die mit Systemen wie Layout oder Datenbindung interagieren.
Ausnahmen
defaultValue ist auf 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 bereitgestellten defaultValue Werts muss übereinstimmen oder mit dem Typ in Verbindung stehen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben ist, auf die diese Metadaten angewendet werden. Übereinstimmungen zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet wird, können schwierig zu debuggen sein, da die Übereinstimmung während der Kompilierung nicht erkannt werden kann. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyps/eines Eigenschaftstyps ein Laufzeitfehler ist.
Der Wert UnsetValue hat eine besondere Bedeutung im Eigenschaftensystem und kann nicht als Standardwert für Abhängigkeitseigenschaften verwendet werden.
Werte, die flags als festgelegte Kennzeichnungen im Parameter markiert sind, legen den booleschen Wert von FrameworkPropertyMetadata Eigenschaften fest, die dem Namen truedieses FrameworkPropertyMetadataOptions Flags entsprechen. 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
Gilt für:
FrameworkPropertyMetadata(Object, PropertyChangedCallback)
Initialisiert eine neue Instanz der FrameworkPropertyMetadata Klasse mit dem bereitgestellten 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.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback)Parameter
- defaultValue
- Object
Der Standardwert der Abhängigkeitseigenschaft, in der Regel als Wert eines bestimmten Typs angegeben.
- propertyChangedCallback
- PropertyChangedCallback
Ein Verweis auf eine Handlerimplementierung, die vom Eigenschaftensystem aufgerufen wird, wenn sich der effektive Wert der Eigenschaft ändert.
Ausnahmen
defaultValue ist auf 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 bereitgestellten defaultValue Werts muss übereinstimmen oder mit dem Typ in Verbindung stehen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben ist, auf die diese Metadaten angewendet werden. Übereinstimmungen zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet wird, können schwierig zu debuggen sein, da die Übereinstimmung während der Kompilierung nicht erkannt werden kann. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyps/eines Eigenschaftstyps ein Laufzeitfehler ist.
Der Wert UnsetValue hat eine besondere Bedeutung im Eigenschaftensystem und kann nicht als Standardwert für Abhängigkeitseigenschaften verwendet werden.
Weitere Informationen
Gilt für:
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.FrameworkPropertyMetadataPublic Sub New (propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)Parameter
- propertyChangedCallback
- PropertyChangedCallback
Ein Verweis auf eine Handlerimplementierung, die vom Eigenschaftensystem aufgerufen wird, wenn sich der effektive Wert der Eigenschaft ändert.
- coerceValueCallback
- CoerceValueCallback
Ein Verweis auf eine Handlerimplementierung wird immer aufgerufen, wenn das Eigenschaftensystem diese Abhängigkeitseigenschaft aufruft CoerceValue(DependencyProperty) .
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 Eigenschaft für die Basisinstanz hinzu.
Weitere Informationen
Gilt für:
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)
Initialisiert eine neue Instanz der FrameworkPropertyMetadata Klasse mit den bereitgestellten Standardwert- und Framework-Metadatenoptionen und 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.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback)Parameter
- defaultValue
- Object
Der Standardwert der Abhängigkeitseigenschaft, in der Regel als Wert eines bestimmten Typs angegeben.
Die Metadatenoptionskennzeichnungen (eine Kombination von FrameworkPropertyMetadataOptions Werten). Diese Optionen geben Merkmale der Abhängigkeitseigenschaft an, die mit Systemen wie Layout oder Datenbindung interagieren.
- propertyChangedCallback
- PropertyChangedCallback
Ein Verweis auf eine Handlerimplementierung, die vom Eigenschaftensystem aufgerufen wird, wenn sich der effektive Wert der Eigenschaft ändert.
Ausnahmen
defaultValue ist auf 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 bereitgestellten defaultValue Werts muss übereinstimmen oder mit dem Typ in Verbindung stehen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben ist, auf die diese Metadaten angewendet werden. Übereinstimmungen zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet wird, können schwierig zu debuggen sein, da die Übereinstimmung während der Kompilierung nicht erkannt werden kann. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyps/eines Eigenschaftstyps ein Laufzeitfehler ist.
Der Wert UnsetValue hat eine besondere Bedeutung im Eigenschaftensystem und kann nicht als Standardwert für Abhängigkeitseigenschaften verwendet werden.
Werte, die flags als festgelegte Kennzeichnungen im Parameter markiert sind, legen den booleschen Wert von FrameworkPropertyMetadata Eigenschaften fest, die dem Namen truedieses FrameworkPropertyMetadataOptions Flags entsprechen. 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
Gilt für:
FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)
Initialisiert eine neue Instanz der FrameworkPropertyMetadata Klasse mit dem bereitgestellten 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.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)Parameter
- defaultValue
- Object
Der Standardwert der Abhängigkeitseigenschaft, in der Regel als bestimmter Typ angegeben.
- propertyChangedCallback
- PropertyChangedCallback
Ein Verweis auf eine Handlerimplementierung, die vom Eigenschaftensystem aufgerufen wird, wenn sich der effektive Wert der Eigenschaft ändert.
- coerceValueCallback
- CoerceValueCallback
Ein Verweis auf eine Handlerimplementierung, die immer aufgerufen wird, wenn das Eigenschaftensystem diese Abhängigkeitseigenschaft aufruft CoerceValue(DependencyProperty) .
Ausnahmen
defaultValue ist auf 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 bereitgestellten defaultValue Werts muss übereinstimmen oder mit dem Typ in Verbindung stehen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben ist, auf die diese Metadaten angewendet werden. Übereinstimmungen zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet wird, können schwierig zu debuggen sein, da die Übereinstimmung während der Kompilierung nicht erkannt werden kann. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyps/eines Eigenschaftstyps ein Laufzeitfehler ist.
Der Wert UnsetValue hat eine besondere Bedeutung im Eigenschaftensystem und kann nicht als Standardwert für Abhängigkeitseigenschaften verwendet werden.
Weitere Informationen
Gilt für:
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)
Initialisiert eine neue Instanz der FrameworkPropertyMetadata Klasse mit den bereitgestellten Standardwert- und Framework-Metadatenoptionen und 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.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)Parameter
- defaultValue
- Object
Der Standardwert der Abhängigkeitseigenschaft, in der Regel als bestimmter Typ angegeben.
Die Metadatenoptionskennzeichnungen (eine Kombination von FrameworkPropertyMetadataOptions Werten). Diese Optionen geben Merkmale der Abhängigkeitseigenschaft an, die mit Systemen wie Layout oder Datenbindung interagieren.
- propertyChangedCallback
- PropertyChangedCallback
Ein Verweis auf eine Handlerimplementierung, die vom Eigenschaftensystem aufgerufen wird, wenn sich der effektive Wert der Eigenschaft ändert.
- coerceValueCallback
- CoerceValueCallback
Ein Verweis auf eine Handlerimplementierung, die immer aufgerufen wird, wenn das Eigenschaftensystem für diese Eigenschaft aufruft CoerceValue(DependencyProperty) .
Ausnahmen
defaultValue ist auf 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 bereitgestellten defaultValue Werts muss übereinstimmen oder mit dem Typ in Verbindung stehen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben ist, auf die diese Metadaten angewendet werden. Übereinstimmungen zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet wird, können schwierig zu debuggen sein, da die Übereinstimmung während der Kompilierung nicht erkannt werden kann. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyps/eines Eigenschaftstyps ein Laufzeitfehler ist.
Der Wert UnsetValue hat eine besondere Bedeutung im Eigenschaftensystem und kann nicht als Standardwert für Abhängigkeitseigenschaften verwendet werden.
Werte, die flags als festgelegte Kennzeichnungen im Parameter markiert sind, legen den booleschen Wert von FrameworkPropertyMetadata Eigenschaften fest, die dem Namen truedieses FrameworkPropertyMetadataOptions Flags entsprechen. 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
Gilt für:
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean)
Initialisiert eine neue Instanz der FrameworkPropertyMetadata Klasse mit den bereitgestellten Standardwert- und Framework-Metadatenoptionen, angegebenen Rückrufen und einem booleschen Wert, der verwendet werden kann, um die Animation der Eigenschaft zu verhindern.
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.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback, isAnimationProhibited As Boolean)Parameter
- defaultValue
- Object
Der Standardwert der Abhängigkeitseigenschaft, in der Regel als bestimmter Typ angegeben.
Die Metadatenoptionskennzeichnungen (eine Kombination von FrameworkPropertyMetadataOptions Werten). Diese Optionen geben Merkmale der Abhängigkeitseigenschaft an, die mit Systemen wie Layout oder Datenbindung interagieren.
- propertyChangedCallback
- PropertyChangedCallback
Ein Verweis auf eine Handlerimplementierung, die vom Eigenschaftensystem aufgerufen wird, wenn sich der effektive Wert der Eigenschaft ändert.
- coerceValueCallback
- CoerceValueCallback
Ein Verweis auf eine Handlerimplementierung, die immer aufgerufen wird, wenn das Eigenschaftensystem diese Abhängigkeitseigenschaft aufruft CoerceValue(DependencyProperty) .
- isAnimationProhibited
- Boolean
true um zu verhindern, dass das Eigenschaftensystem die Eigenschaft animiert, auf die diese Metadaten angewendet werden. Diese Eigenschaften lösen eine Laufzeit ausnahme aus, die vom Eigenschaftensystem stammt, wenn animationen von ihnen versucht werden.
false zum Animieren der Eigenschaft. Der Standardwert lautet false.
Ausnahmen
defaultValue ist auf 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 bereitgestellten defaultValue Werts muss übereinstimmen oder mit dem Typ in Verbindung stehen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben ist, auf die diese Metadaten angewendet werden. Übereinstimmungen zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet wird, können schwierig zu debuggen sein, da die Übereinstimmung während der Kompilierung nicht erkannt werden kann. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyps/eines Eigenschaftstyps ein Laufzeitfehler ist.
Der Wert UnsetValue hat eine besondere Bedeutung im Eigenschaftensystem und kann nicht als Standardwert für Abhängigkeitseigenschaften verwendet werden.
Der isAnimationProhibited Parameter legt den Anfangswert der IsAnimationProhibited Eigenschaft fest, die von der unmittelbaren Basisklasse UIPropertyMetadata deklariert wird.
Werte, die flags als festgelegte Kennzeichnungen im Parameter markiert sind, legen den booleschen Wert von FrameworkPropertyMetadata Eigenschaften fest, die dem Namen truedieses FrameworkPropertyMetadataOptions Flags entsprechen. 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
Gilt für:
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger)
Initialisiert eine neue Instanz der FrameworkPropertyMetadata Klasse mit den bereitgestellten Standardwert- und Framework-Metadatenoptionen, angegebenen Rückrufen, einem booleschen Wert, der verwendet werden kann, um animationen der Eigenschaft zu verhindern, und ein Standard für datenbindungsaktualisierungsauslöser.
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.FrameworkPropertyMetadataPublic 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 der Abhängigkeitseigenschaft, in der Regel als bestimmter Typ angegeben.
Die Metadatenoptionskennzeichnungen (eine Kombination von FrameworkPropertyMetadataOptions Werten). Diese Optionen geben Merkmale der Abhängigkeitseigenschaft an, die mit Systemen wie Layout oder Datenbindung interagieren.
- propertyChangedCallback
- PropertyChangedCallback
Ein Verweis auf eine Handlerimplementierung, die vom Eigenschaftensystem aufgerufen wird, wenn sich der effektive Wert der Eigenschaft ändert.
- coerceValueCallback
- CoerceValueCallback
Ein Verweis auf eine Handlerimplementierung, die immer aufgerufen wird, wenn das Eigenschaftensystem für diese Eigenschaft aufruft CoerceValue(DependencyProperty) .
- isAnimationProhibited
- Boolean
true um zu verhindern, dass das Eigenschaftensystem die Eigenschaft animiert, auf die diese Metadaten angewendet werden. Diese Eigenschaften lösen eine Laufzeit ausnahme aus, die vom Eigenschaftensystem stammt, wenn animationen von ihnen versucht werden. Der Standardwert lautet false.
- defaultUpdateSourceTrigger
- UpdateSourceTrigger
Die UpdateSourceTrigger Zu verwenden, wenn Bindungen für diese Eigenschaft angewendet werden, auf die sie UpdateSourceTrigger festgelegt Defaultsind.
Ausnahmen
defaultValue ist auf 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 bereitgestellten defaultValue Werts muss übereinstimmen oder mit dem Typ in Verbindung stehen, der in der ursprünglichen Registrierung der Abhängigkeitseigenschaft angegeben ist, auf die diese Metadaten angewendet werden. Übereinstimmungen zwischen dem Metadatenstandardwerttyp und dem Typ der Abhängigkeitseigenschaft, auf die sie angewendet wird, können schwierig zu debuggen sein, da die Übereinstimmung während der Kompilierung nicht erkannt werden kann. Das Eigenschaftensystem wertet den effektiven Wert einer Eigenschaft erst zur Laufzeit aus, sodass das Ergebnis eines Standardwerttyps/eines Eigenschaftstyps ein Laufzeitfehler ist.
Der Wert UnsetValue hat eine besondere Bedeutung im Eigenschaftensystem und kann nicht als Standardwert für Abhängigkeitseigenschaften verwendet werden.
Der isAnimationProhibited Parameter legt den Anfangswert der IsAnimationProhibited Eigenschaft fest, die von der unmittelbaren Basisklasse UIPropertyMetadata deklariert wird.
Weitere Informationen zum Updatequellverhalten für Bindungen finden Sie unter Data Binding Overview.
Werte, die flags als festgelegte Kennzeichnungen im Parameter markiert sind, legen den booleschen Wert von FrameworkPropertyMetadata Eigenschaften fest, die dem Namen truedieses FrameworkPropertyMetadataOptions Flags entsprechen. Sie können die Werte der Eigenschaften in den Metadaten weiterhin ändern, solange die Metadaten noch nicht auf einen bestimmten Eigenschaftensystemvorgang angewendet wurden.
