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í
| Name | Description |
|---|---|
| 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í. |
| FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions) |
Inicializuje novou instanci FrameworkPropertyMetadata třídy s poskytnutými výchozími hodnotami a možnostmi metadat na úrovni architektury. |
| FrameworkPropertyMetadata(Object, PropertyChangedCallback) |
Inicializuje novou instanci FrameworkPropertyMetadata třídy s zadanou výchozí hodnotou a zadaným PropertyChangedCallback zpětném volání. |
| 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 zadanými výchozími hodnotami a možnostmi metadat architektury a zadaným PropertyChangedCallback zpětným voláním. |
| FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback) |
Inicializuje novou instanci FrameworkPropertyMetadata třídy s 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 poskytnutou 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 poskytnutou výchozí hodnotou a možnostmi metadat architektury, zadanými zpětnými voláními a logickou hodnotou, kterou lze použít k zabránění animaci vlastnosti. |
| FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger) |
Inicializuje novou instanci FrameworkPropertyMetadata třídy s poskytnutou výchozí hodnotou a možnostmi metadat architektury, určenými zpětnými voláními, logickou hodnotou, kterou lze použít k zabránění animace vlastnosti, a výchozí aktivační událost aktualizace vazby dat. |
FrameworkPropertyMetadata()
Inicializuje novou instanci FrameworkPropertyMetadata třídy.
public:
FrameworkPropertyMetadata();
public FrameworkPropertyMetadata();
Public Sub New ()
Poznámky
Tento podpis inicializuje všechny hodnoty jejich výchozích vlastností FrameworkPropertyMetadata .
DefaultValue bude nulla 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.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object)
Parametry
- defaultValue
- Object
Výchozí hodnota vlastnosti závislosti, obvykle zadaná jako hodnota určitého typu.
Výjimky
defaultValue je nastaveno na UnsetValue.
Příklady
Následující příklad volá tento podpis konstruktoru:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(Double.NaN);
Poznámky
Typ zadané hodnoty defaultValue se musí shodovat nebo musí souviset 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 neshoda není při kompilaci rozpoznatelná. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti do doby běhu, takže výsledkem neshody výchozího typu 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í.
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)
Parametry
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou systém vlastností bude volat vždy, když se změní platná hodnota 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 poskytnutými výchozími hodnotami 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.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions)
Parametry
- defaultValue
- Object
Výchozí hodnota vlastnosti závislosti, obvykle zadaná jako hodnota určitého typu.
Možnost metadat označuje příznaky (kombinace FrameworkPropertyMetadataOptions hodnot). Tyto možnosti určují vlastnosti závislosti, které komunikují se systémy, jako je rozložení nebo datová vazba.
Výjimky
defaultValue je nastaveno na UnsetValue.
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 defaultValue se musí shodovat nebo musí souviset 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 neshoda není při kompilaci rozpoznatelná. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti do doby běhu, takže výsledkem neshody výchozího typu 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 příznaky set v parametru flags nastaví logickou hodnotu FrameworkPropertyMetadata vlastností, které odpovídají FrameworkPropertyMetadataOptions názvu truepříznaku . Hodnoty vlastností v metadatech můžete následně změnit, 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 s zadanou výchozí hodnotou a zadaným PropertyChangedCallback zpětném volání.
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)
Parametry
- defaultValue
- Object
Výchozí hodnota vlastnosti závislosti, obvykle zadaná jako hodnota určitého typu.
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou systém vlastností bude volat vždy, když se změní platná hodnota vlastnosti.
Výjimky
defaultValue je nastaveno na UnsetValue.
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 defaultValue se musí shodovat nebo musí souviset 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 neshoda není při kompilaci rozpoznatelná. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti do doby běhu, takže výsledkem neshody výchozího typu 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.FrameworkPropertyMetadata
Public Sub New (propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)
Parametry
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou systém vlastností bude volat vždy, když se změní platná hodnota 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 pak přidá coerceValueCallback vlastnost nastavením vlastnosti na základní instanci.
Viz také
Platí pro
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)
Inicializuje novou instanci FrameworkPropertyMetadata třídy s zadanými výchozími hodnotami a možnostmi metadat architektury a zadaným PropertyChangedCallback zpětným voláním.
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)
Parametry
- defaultValue
- Object
Výchozí hodnota vlastnosti závislosti, obvykle zadaná jako hodnota určitého typu.
Možnost metadat označuje příznaky (kombinace FrameworkPropertyMetadataOptions hodnot). Tyto možnosti určují vlastnosti závislosti, které komunikují se systémy, jako je rozložení nebo datová vazba.
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou systém vlastností bude volat vždy, když se změní platná hodnota vlastnosti.
Výjimky
defaultValue je nastaveno na UnsetValue.
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 defaultValue se musí shodovat nebo musí souviset 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 neshoda není při kompilaci rozpoznatelná. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti do doby běhu, takže výsledkem neshody výchozího typu 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 příznaky set v parametru flags nastaví logickou hodnotu FrameworkPropertyMetadata vlastností, které odpovídají FrameworkPropertyMetadataOptions názvu truepříznaku . 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 s 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.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)
Parametry
- defaultValue
- Object
Výchozí hodnota vlastnosti závislosti, obvykle zadaná jako konkrétní typ.
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou systém vlastností bude volat vždy, když se změní platná hodnota 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 nastaveno na UnsetValue.
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 defaultValue se musí shodovat nebo musí souviset 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 neshoda není při kompilaci rozpoznatelná. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti do doby běhu, takže výsledkem neshody výchozího typu 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 poskytnutou 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.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)
Parametry
- defaultValue
- Object
Výchozí hodnota vlastnosti závislosti, obvykle zadaná jako konkrétní typ.
Možnost metadat označuje příznaky (kombinace FrameworkPropertyMetadataOptions hodnot). Tyto možnosti určují vlastnosti závislosti, které komunikují se systémy, jako je rozložení nebo datová vazba.
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou systém vlastností bude volat vždy, když se změní platná hodnota 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 nastaveno na UnsetValue.
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 defaultValue se musí shodovat nebo musí souviset 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 neshoda není při kompilaci rozpoznatelná. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti do doby běhu, takže výsledkem neshody výchozího typu 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 příznaky set v parametru flags nastaví logickou hodnotu FrameworkPropertyMetadata vlastností, které odpovídají FrameworkPropertyMetadataOptions názvu truepříznaku . 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 poskytnutou výchozí hodnotou a možnostmi metadat architektury, zadanými zpětnými voláními a logickou hodnotou, kterou 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.FrameworkPropertyMetadata
Public 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, obvykle zadaná jako konkrétní typ.
Možnost metadat označuje příznaky (kombinace FrameworkPropertyMetadataOptions hodnot). Tyto možnosti určují vlastnosti závislosti, které komunikují se systémy, jako je rozložení nebo datová vazba.
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou systém vlastností bude volat vždy, když se změní platná hodnota 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.
- isAnimationProhibited
- Boolean
true aby systém vlastností nemohl animovat vlastnost, na kterou se tato metadata použijí. Tyto vlastnosti při pokusu o animace vyvolá výjimku za běhu pocházející ze systému vlastností.
false povolit animaci vlastnosti. Výchozí hodnota je false.
Výjimky
defaultValue je nastaveno na UnsetValue.
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 defaultValue se musí shodovat nebo musí souviset 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 neshoda není při kompilaci rozpoznatelná. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti do doby běhu, takže výsledkem neshody výchozího typu 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 příznaky set v parametru flags nastaví logickou hodnotu FrameworkPropertyMetadata vlastností, které odpovídají FrameworkPropertyMetadataOptions názvu truepříznaku . 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 poskytnutou výchozí hodnotou a možnostmi metadat architektury, určenými zpětnými voláními, logickou hodnotou, kterou lze použít k zabránění animace vlastnosti, a výchozí aktivační událost aktualizace vazby dat.
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)
Parametry
- defaultValue
- Object
Výchozí hodnota vlastnosti závislosti, obvykle zadaná jako konkrétní typ.
Možnost metadat označuje příznaky (kombinace FrameworkPropertyMetadataOptions hodnot). Tyto možnosti určují vlastnosti závislosti, které komunikují se systémy, jako je rozložení nebo datová vazba.
- propertyChangedCallback
- PropertyChangedCallback
Odkaz na implementaci obslužné rutiny, kterou systém vlastností bude volat vždy, když se změní platná hodnota 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 se tato metadata použijí. Tyto vlastnosti při pokusu o animace vyvolá výjimku za běhu pocházející ze systému vlastností. Výchozí hodnota je false.
- defaultUpdateSourceTrigger
- UpdateSourceTrigger
Použije UpdateSourceTrigger se při vazbách pro tuto vlastnost, které mají nastavenou UpdateSourceTrigger hodnotu Default.
Výjimky
defaultValue je nastaveno na UnsetValue.
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 defaultValue se musí shodovat nebo musí souviset 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 neshoda není při kompilaci rozpoznatelná. Systém vlastností nevyhodnocuje efektivní hodnotu vlastnosti do doby běhu, takže výsledkem neshody výchozího typu 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 naleznete v tématu Přehled datových vazeb.
Hodnoty označené jako příznaky set v parametru flags nastaví logickou hodnotu FrameworkPropertyMetadata vlastností, které odpovídají FrameworkPropertyMetadataOptions názvu truepříznaku . Stále můžete změnit hodnoty vlastností v metadatech, pokud metadata ještě nebyla použita pro konkrétní operaci systému vlastností.