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
| 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
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 für die Abhängigkeitseigenschaft, der normalerweise als Wert eines bestimmten Typs angegeben wird.
Ausnahmen
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
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 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));
Gilt für:
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.FrameworkPropertyMetadataPublic 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.
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
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
Gilt für:
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.FrameworkPropertyMetadataPublic 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
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
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 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
Gilt für:
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.FrameworkPropertyMetadataPublic 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.
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
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
Gilt für:
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.FrameworkPropertyMetadataPublic 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
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
Gilt für:
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.FrameworkPropertyMetadataPublic 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.
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
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
Gilt für:
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.FrameworkPropertyMetadataPublic 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.
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
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
Gilt für:
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.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 für die Abhängigkeitseigenschaft, der normalerweise als Wert eines bestimmten Typs angegeben wird.
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
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.
