FrameworkPropertyMetadata Konstruktory
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Inicializuje novou instanci FrameworkPropertyMetadata třídy .
Přetížení
| FrameworkPropertyMetadata() |
Inicializuje novou instanci FrameworkPropertyMetadata třídy . |
| FrameworkPropertyMetadata(Object) |
Inicializuje novou instanci FrameworkPropertyMetadata třídy se zadanou výchozí hodnotou. |
| FrameworkPropertyMetadata(PropertyChangedCallback) |
Inicializuje novou instanci FrameworkPropertyMetadata třídy se zadaným PropertyChangedCallback zpětným voláním. |
| FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions) |
Inicializuje novou instanci FrameworkPropertyMetadata třídy s zadanou výchozí hodnotou a možnostmi metadat na úrovni architektury. |
| FrameworkPropertyMetadata(Object, PropertyChangedCallback) |
Inicializuje novou instanci FrameworkPropertyMetadata třídy se zadanou výchozí hodnotou a zadaným PropertyChangedCallback zpětným voláním. |
| FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback) |
Inicializuje novou instanci FrameworkPropertyMetadata třídy se zadanými zpětnými voláními. |
| FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback) |
Inicializuje novou instanci FrameworkPropertyMetadata třídy s předanou výchozí hodnotu a rozhraní metadat možnosti a zadané PropertyChangedCallback zpětné volání. |
| FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback) |
Inicializuje novou instanci FrameworkPropertyMetadata třídy se zadanou výchozí hodnotou a zadanými zpětnými voláními. |
| FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback) |
Inicializuje novou instanci FrameworkPropertyMetadata třídy s zadanou výchozí hodnotou a možnostmi metadat architektury a zadanými zpětnými voláními. |
| FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean) |
Inicializuje novou instanci FrameworkPropertyMetadata třídy s zadanou výchozí hodnotou a možnostmi metadat architektury, zadanými zpětnými voláními a logickou hodnotou, která lze použít k zabránění animaci vlastnosti. |
| FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger) |
Inicializuje novou instanci FrameworkPropertyMetadata třídy s zadanou výchozí hodnotou a možnostmi metadat architektury, zadanými zpětnými voláními, logickou hodnotou, která lze použít k zabránění animaci vlastnosti, a výchozí aktivační událostí aktualizace datové vazby. |
FrameworkPropertyMetadata()
Inicializuje novou instanci FrameworkPropertyMetadata třídy .
public:
FrameworkPropertyMetadata();public FrameworkPropertyMetadata ();Public Sub New ()Poznámky
Tento podpis inicializuje všechny hodnoty do výchozích FrameworkPropertyMetadata hodnot vlastnosti.
DefaultValue
nullbude a různé FrameworkPropertyMetadata logické vlastnosti budou false.
Viz také
Platí pro
FrameworkPropertyMetadata(Object)
Inicializuje novou instanci FrameworkPropertyMetadata třídy se zadanou výchozí hodnotou.
public:
FrameworkPropertyMetadata(System::Object ^ defaultValue);public FrameworkPropertyMetadata (object defaultValue);new System.Windows.FrameworkPropertyMetadata : obj -> System.Windows.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object)Parametry
- defaultValue
- Object
Výchozí hodnota vlastnosti závislosti, která se obvykle poskytuje jako hodnota určitého typu.
Výjimky
defaultValue je nastavená na UnsetValuehodnotu .
Příklady
Následující příklad volá tento podpis konstruktoru:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(Double.NaN);
Poznámky
Typ zadané hodnoty se defaultValue musí shodovat s typem zadaným v původní registraci vlastnosti závislosti, na kterou se tato metadata použijí. Neshody mezi výchozím typem hodnoty metadat a typem vlastnosti závislosti, na kterou se používá, může být obtížné ladit, protože neshodu nelze zjistit během kompilace. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti až za běhu, takže výsledkem neshody typu výchozí hodnoty nebo typu vlastnosti je chyba za běhu.
Hodnota UnsetValue má v systému vlastností zvláštní význam a nelze ji použít jako výchozí hodnotu vlastnosti závislosti.
Viz také
Platí pro
FrameworkPropertyMetadata(PropertyChangedCallback)
Inicializuje novou instanci FrameworkPropertyMetadata třídy se zadaným PropertyChangedCallback zpětným voláním.
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)Parametry
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou bude systém vlastností volat při každé změně efektivní hodnoty vlastnosti.
Příklady
Následující příklad volá tento podpis konstruktoru:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(new PropertyChangedCallback(OnCurrentReadingChanged));
Platí pro
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)
Inicializuje novou instanci FrameworkPropertyMetadata třídy s zadanou výchozí hodnotou a možnostmi metadat na úrovni architektury.
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)Parametry
- defaultValue
- Object
Výchozí hodnota vlastnosti závislosti, která se obvykle poskytuje jako hodnota určitého typu.
Příznaky možností metadat (kombinace FrameworkPropertyMetadataOptions hodnot). Tyto možnosti určují charakteristiky vlastnosti závislosti, které interagují se systémy, jako je rozložení nebo datová vazba.
Výjimky
defaultValue je nastavená na UnsetValuehodnotu .
Příklady
Následující příklad volá tento podpis konstruktoru:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault)
);
Poznámky
Typ zadané hodnoty se defaultValue musí shodovat s typem zadaným v původní registraci vlastnosti závislosti, na kterou se tato metadata použijí. Neshody mezi výchozím typem hodnoty metadat a typem vlastnosti závislosti, na kterou se používá, může být obtížné ladit, protože neshodu nelze zjistit během kompilace. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti až za běhu, takže výsledkem neshody typu výchozí hodnoty nebo typu vlastnosti je chyba za běhu.
Hodnota UnsetValue má v systému vlastností zvláštní význam a nelze ji použít jako výchozí hodnotu vlastnosti závislosti.
Hodnoty označené jako set flags v parametru flags nastaví logickou hodnotu FrameworkPropertyMetadata vlastností, které odpovídají FrameworkPropertyMetadataOptions názvu tohoto příznaku .true Následně můžete změnit hodnoty vlastností v metadatech, pokud metadata ještě nebyla použita pro konkrétní operaci systému vlastností.
Viz také
Platí pro
FrameworkPropertyMetadata(Object, PropertyChangedCallback)
Inicializuje novou instanci FrameworkPropertyMetadata třídy se zadanou výchozí hodnotou a zadaným PropertyChangedCallback zpětným voláním.
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)Parametry
- defaultValue
- Object
Výchozí hodnota vlastnosti závislosti, která se obvykle poskytuje jako hodnota určitého typu.
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou bude systém vlastností volat při každé změně efektivní hodnoty vlastnosti.
Výjimky
defaultValue je nastavená na UnsetValuehodnotu .
Příklady
Následující příklad volá tento podpis konstruktoru:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
new PropertyChangedCallback(OnCurrentReadingChanged)
);
Poznámky
Typ zadané hodnoty se defaultValue musí shodovat s typem zadaným v původní registraci vlastnosti závislosti, na kterou se tato metadata použijí. Neshody mezi výchozím typem hodnoty metadat a typem vlastnosti závislosti, na kterou se používá, může být obtížné ladit, protože neshodu nelze zjistit během kompilace. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti až za běhu, takže výsledkem neshody typu výchozí hodnoty nebo typu vlastnosti je chyba za běhu.
Hodnota UnsetValue má v systému vlastností zvláštní význam a nelze ji použít jako výchozí hodnotu vlastnosti závislosti.
Viz také
Platí pro
FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)
Inicializuje novou instanci FrameworkPropertyMetadata třídy se zadanými zpětnými voláními.
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)Parametry
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou bude systém vlastností volat při každé změně efektivní hodnoty vlastnosti.
- coerceValueCallback
- CoerceValueCallback
Odkaz na implementaci obslužné rutiny bude volána vždy, když systém vlastností volá CoerceValue(DependencyProperty) tuto vlastnost závislosti.
Příklady
Následující příklad volá tento podpis konstruktoru:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading)
);
Poznámky
Tato implementace volá základní inicializátor a poté přidá coerceValueCallback nastavením vlastnosti na základní instanci.
Viz také
Platí pro
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)
Inicializuje novou instanci FrameworkPropertyMetadata třídy s předanou výchozí hodnotu a rozhraní metadat možnosti a zadané PropertyChangedCallback zpětné volání.
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)Parametry
- defaultValue
- Object
Výchozí hodnota vlastnosti závislosti, která se obvykle poskytuje jako hodnota určitého typu.
Příznaky možností metadat (kombinace FrameworkPropertyMetadataOptions hodnot). Tyto možnosti určují charakteristiky vlastnosti závislosti, které interagují se systémy, jako je rozložení nebo datová vazba.
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou bude systém vlastností volat při každé změně efektivní hodnoty vlastnosti.
Výjimky
defaultValue je nastavená na UnsetValuehodnotu .
Příklady
Následující příklad volá tento podpis konstruktoru:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
new PropertyChangedCallback(OnCurrentReadingChanged)
);
Poznámky
Typ zadané hodnoty se defaultValue musí shodovat s typem zadaným v původní registraci vlastnosti závislosti, na kterou se tato metadata použijí. Neshody mezi výchozím typem hodnoty metadat a typem vlastnosti závislosti, na kterou se používá, může být obtížné ladit, protože neshodu nelze zjistit během kompilace. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti až za běhu, takže výsledkem neshody typu výchozí hodnoty nebo typu vlastnosti je chyba za běhu.
Hodnota UnsetValue má v systému vlastností zvláštní význam a nelze ji použít jako výchozí hodnotu vlastnosti závislosti.
Hodnoty označené jako set flags v parametru flags nastaví logickou hodnotu FrameworkPropertyMetadata vlastností, které odpovídají FrameworkPropertyMetadataOptions názvu tohoto příznaku .true Stále můžete změnit hodnoty vlastností v metadatech, pokud metadata ještě nebyla použita pro konkrétní operaci systému vlastností.
Viz také
Platí pro
FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)
Inicializuje novou instanci FrameworkPropertyMetadata třídy se zadanou výchozí hodnotou a zadanými zpětnými voláními.
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)Parametry
- defaultValue
- Object
Výchozí hodnota vlastnosti závislosti, která se obvykle poskytuje jako konkrétní typ.
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou bude systém vlastností volat při každé změně efektivní hodnoty vlastnosti.
- coerceValueCallback
- CoerceValueCallback
Odkaz na implementaci obslužné rutiny, která bude volána vždy, když systém vlastností volá CoerceValue(DependencyProperty) tuto vlastnost závislosti.
Výjimky
defaultValue je nastavená na UnsetValuehodnotu .
Příklady
Následující příklad volá tento podpis konstruktoru:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading)
);
Poznámky
Typ zadané hodnoty se defaultValue musí shodovat s typem zadaným v původní registraci vlastnosti závislosti, na kterou se tato metadata použijí. Neshody mezi výchozím typem hodnoty metadat a typem vlastnosti závislosti, na kterou se používá, může být obtížné ladit, protože neshodu nelze zjistit během kompilace. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti až za běhu, takže výsledkem neshody typu výchozí hodnoty nebo typu vlastnosti je chyba za běhu.
Hodnota UnsetValue má v systému vlastností zvláštní význam a nelze ji použít jako výchozí hodnotu vlastnosti závislosti.
Viz také
Platí pro
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)
Inicializuje novou instanci FrameworkPropertyMetadata třídy s zadanou výchozí hodnotou a možnostmi metadat architektury a zadanými zpětnými voláními.
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)Parametry
- defaultValue
- Object
Výchozí hodnota vlastnosti závislosti, která se obvykle poskytuje jako konkrétní typ.
Příznaky možností metadat (kombinace FrameworkPropertyMetadataOptions hodnot). Tyto možnosti určují charakteristiky vlastnosti závislosti, které interagují se systémy, jako je rozložení nebo datová vazba.
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou bude systém vlastností volat při každé změně efektivní hodnoty vlastnosti.
- coerceValueCallback
- CoerceValueCallback
Odkaz na implementaci obslužné rutiny, která bude volána vždy, když systém vlastností volá CoerceValue(DependencyProperty) tuto vlastnost.
Výjimky
defaultValue je nastavená na UnsetValuehodnotu .
Příklady
Následující příklad volá tento podpis konstruktoru:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading)
);
Poznámky
Typ zadané hodnoty se defaultValue musí shodovat s typem zadaným v původní registraci vlastnosti závislosti, na kterou se tato metadata použijí. Neshody mezi výchozím typem hodnoty metadat a typem vlastnosti závislosti, na kterou se používá, může být obtížné ladit, protože neshodu nelze zjistit během kompilace. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti až za běhu, takže výsledkem neshody typu výchozí hodnoty nebo typu vlastnosti je chyba za běhu.
Hodnota UnsetValue má v systému vlastností zvláštní význam a nelze ji použít jako výchozí hodnotu vlastnosti závislosti.
Hodnoty označené jako set flags v parametru flags nastaví logickou hodnotu FrameworkPropertyMetadata vlastností, které odpovídají FrameworkPropertyMetadataOptions názvu tohoto příznaku .true Stále můžete změnit hodnoty vlastností v metadatech, pokud metadata ještě nebyla použita pro konkrétní operaci systému vlastností.
Viz také
Platí pro
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean)
Inicializuje novou instanci FrameworkPropertyMetadata třídy s zadanou výchozí hodnotou a možnostmi metadat architektury, zadanými zpětnými voláními a logickou hodnotou, která lze použít k zabránění animaci vlastnosti.
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)Parametry
- defaultValue
- Object
Výchozí hodnota vlastnosti závislosti, která se obvykle poskytuje jako konkrétní typ.
Příznaky možností metadat (kombinace FrameworkPropertyMetadataOptions hodnot). Tyto možnosti určují charakteristiky vlastnosti závislosti, které interagují se systémy, jako je rozložení nebo datová vazba.
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou bude systém vlastností volat při každé změně efektivní hodnoty vlastnosti.
- coerceValueCallback
- CoerceValueCallback
Odkaz na implementaci obslužné rutiny, která bude volána při každém volání CoerceValue(DependencyProperty) systému vlastností této vlastnosti závislosti.
- isAnimationProhibited
- Boolean
true , aby systém vlastností nemohl animovat vlastnost, na kterou jsou tato metadata použita. Tyto vlastnosti vyvolá výjimku za běhu, která pochází ze systému vlastností, pokud se pokusí o jejich animace.
false pro povolení animace vlastnosti. Výchozí formát je false.
Výjimky
defaultValue je nastavená na UnsetValuehodnotu .
Příklady
Následující příklad volá tento podpis konstruktoru:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading),
true //Animation prohibited
);
Poznámky
Typ zadané hodnoty se defaultValue musí shodovat s typem zadaným v původní registraci vlastnosti závislosti, na kterou se tato metadata použijí. Neshody mezi výchozím typem hodnoty metadat a typem vlastnosti závislosti, na kterou se používá, může být obtížné ladit, protože neshodu nelze zjistit během kompilace. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti až za běhu, takže výsledkem neshody typu výchozí hodnoty nebo typu vlastnosti je chyba za běhu.
Hodnota UnsetValue má v systému vlastností zvláštní význam a nelze ji použít jako výchozí hodnotu vlastnosti závislosti.
Parametr isAnimationProhibited nastaví počáteční hodnotu IsAnimationProhibited vlastnosti deklarované okamžitou základní UIPropertyMetadata třídou.
Hodnoty označené jako set flags v parametru flags nastaví logickou hodnotu FrameworkPropertyMetadata vlastností, které odpovídají FrameworkPropertyMetadataOptions názvu tohoto příznaku .true Stále můžete změnit hodnoty vlastností v metadatech, pokud metadata ještě nebyla použita pro konkrétní operaci systému vlastností.
Viz také
Platí pro
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger)
Inicializuje novou instanci FrameworkPropertyMetadata třídy s zadanou výchozí hodnotou a možnostmi metadat architektury, zadanými zpětnými voláními, logickou hodnotou, která lze použít k zabránění animaci vlastnosti, a výchozí aktivační událostí aktualizace datové vazby.
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)Parametry
- defaultValue
- Object
Výchozí hodnota vlastnosti závislosti, která se obvykle poskytuje jako konkrétní typ.
Příznaky možností metadat (kombinace FrameworkPropertyMetadataOptions hodnot). Tyto možnosti určují charakteristiky vlastnosti závislosti, které interagují se systémy, jako je rozložení nebo datová vazba.
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou bude systém vlastností volat při každé změně efektivní hodnoty vlastnosti.
- coerceValueCallback
- CoerceValueCallback
Odkaz na implementaci obslužné rutiny, která bude volána vždy, když systém vlastností volá CoerceValue(DependencyProperty) tuto vlastnost.
- isAnimationProhibited
- Boolean
true , aby systém vlastností nemohl animovat vlastnost, na kterou jsou tato metadata použita. Tyto vlastnosti vyvolá výjimku za běhu, která pochází ze systému vlastností, pokud se pokusí o jejich animace. Výchozí formát je false.
- defaultUpdateSourceTrigger
- UpdateSourceTrigger
Slouží UpdateSourceTrigger k použití při použití vazeb pro tuto vlastnost, které mají nastavenou UpdateSourceTrigger hodnotu Default.
Výjimky
defaultValue je nastavená na UnsetValuehodnotu .
Příklady
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading),
true //Animation prohibited
, UpdateSourceTrigger.PropertyChanged
);
Poznámky
Typ zadané hodnoty se defaultValue musí shodovat s typem zadaným v původní registraci vlastnosti závislosti, na kterou se tato metadata použijí. Neshody mezi výchozím typem hodnoty metadat a typem vlastnosti závislosti, na kterou se používá, může být obtížné ladit, protože neshodu nelze zjistit během kompilace. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti až za běhu, takže výsledkem neshody typu výchozí hodnoty nebo typu vlastnosti je chyba za běhu.
Hodnota UnsetValue má v systému vlastností zvláštní význam a nelze ji použít jako výchozí hodnotu vlastnosti závislosti.
Parametr isAnimationProhibited nastaví počáteční hodnotu IsAnimationProhibited vlastnosti deklarované okamžitou základní UIPropertyMetadata třídou.
Další informace o chování zdroje aktualizací pro vazby najdete v tématu Přehled datových vazeb.
Hodnoty označené jako set flags v parametru flags nastaví logickou hodnotu FrameworkPropertyMetadata vlastností, které odpovídají FrameworkPropertyMetadataOptions názvu tohoto příznaku .true Stále můžete změnit hodnoty vlastností v metadatech, pokud metadata ještě nebyla použita pro konkrétní operaci systému vlastností.
