Udostępnij za pośrednictwem


FrameworkPropertyMetadata Konstruktory

Definicja

Inicjuje nowe wystąpienie klasy FrameworkPropertyMetadata.

Przeciążenia

FrameworkPropertyMetadata()

Inicjuje nowe wystąpienie klasy FrameworkPropertyMetadata.

FrameworkPropertyMetadata(Object)

Inicjuje FrameworkPropertyMetadata nowe wystąpienie klasy z określoną wartością domyślną.

FrameworkPropertyMetadata(PropertyChangedCallback)

Inicjuje FrameworkPropertyMetadata nowe wystąpienie klasy z określonym PropertyChangedCallback wywołaniem zwrotnym.

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

Inicjuje FrameworkPropertyMetadata nowe wystąpienie klasy z podaną wartością domyślną i opcjami metadanych na poziomie struktury.

FrameworkPropertyMetadata(Object, PropertyChangedCallback)

Inicjuje FrameworkPropertyMetadata nowe wystąpienie klasy z podaną wartością domyślną i określonym PropertyChangedCallback wywołaniem zwrotnym.

FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)

Inicjuje FrameworkPropertyMetadata nowe wystąpienie klasy z określonymi wywołaniami zwrotnymi.

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

Inicjuje nowe wystąpienie FrameworkPropertyMetadata klasy z podaną wartością domyślną i opcjami metadanych struktury oraz określonym PropertyChangedCallback wywołaniem zwrotnym.

FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Inicjuje FrameworkPropertyMetadata nowe wystąpienie klasy z podaną wartością domyślną i określonymi wywołaniami zwrotnymi.

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)

Inicjuje nowe wystąpienie FrameworkPropertyMetadata klasy z podaną wartością domyślną i opcjami metadanych struktury oraz określonymi wywołaniami zwrotnymi.

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

Inicjuje nowe wystąpienie FrameworkPropertyMetadata klasy z podaną wartością domyślną i opcjami metadanych struktury, określonymi wywołaniami zwrotnymi i wartością logiczną, która może służyć do zapobiegania animacji właściwości.

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

Inicjuje nowe wystąpienie FrameworkPropertyMetadata klasy z podaną wartością domyślną i opcjami metadanych struktury, określonymi wywołaniami zwrotnymi, wartością logiczną, która może służyć do zapobiegania animacji właściwości oraz domyślnego wyzwalacza aktualizacji powiązania danych.

FrameworkPropertyMetadata()

Inicjuje nowe wystąpienie klasy FrameworkPropertyMetadata.

public:
 FrameworkPropertyMetadata();
public FrameworkPropertyMetadata ();
Public Sub New ()

Uwagi

Ten podpis inicjuje FrameworkPropertyMetadata wszystkie wartości domyślne właściwości. DefaultValue nullbędzie to , a różne FrameworkPropertyMetadata właściwości logiczne będą mieć falsewartość .

Zobacz też

Dotyczy

FrameworkPropertyMetadata(Object)

Inicjuje FrameworkPropertyMetadata nowe wystąpienie klasy z określoną wartością domyślną.

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

Wartość domyślna właściwości zależności, zwykle podana jako wartość określonego typu.

Wyjątki

defaultValue parametr jest ustawiony na UnsetValuewartość .

Przykłady

Poniższy przykład wywołuje ten podpis konstruktora:

static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(Double.NaN);

Uwagi

Typ podanej defaultValue wartości musi być zgodny lub powiązany z typem określonym w oryginalnej rejestracji właściwości zależności, do którego zostaną zastosowane te metadane. Niezgodność między typem wartości domyślnej metadanych a typem właściwości zależności, która jest stosowana, może być trudna do debugowania, ponieważ niezgodność nie jest wykrywalna podczas kompilacji. System właściwości nie ocenia obowiązującej wartości właściwości do czasu wykonywania, dlatego wynik niezgodności typu wartości domyślnej/właściwości jest błędem czasu wykonywania.

Wartość UnsetValue ma specjalne znaczenie w systemie właściwości i nie może być używana jako wartość domyślna właściwości zależności.

Zobacz też

Dotyczy

FrameworkPropertyMetadata(PropertyChangedCallback)

Inicjuje FrameworkPropertyMetadata nowe wystąpienie klasy z określonym PropertyChangedCallback wywołaniem zwrotnym.

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

Odwołanie do implementacji programu obsługi, którą system właściwości wywoła za każdym razem, gdy zmienia się efektywna wartość właściwości.

Przykłady

Poniższy przykład wywołuje ten podpis konstruktora:

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

Dotyczy

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

Inicjuje FrameworkPropertyMetadata nowe wystąpienie klasy z podaną wartością domyślną i opcjami metadanych na poziomie struktury.

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

Wartość domyślna właściwości zależności, zwykle podana jako wartość określonego typu.

flags
FrameworkPropertyMetadataOptions

Flagi opcji metadanych (kombinacja FrameworkPropertyMetadataOptions wartości). Te opcje określają właściwości zależności, które współdziałają z systemami, takimi jak układ lub powiązanie danych.

Wyjątki

defaultValue parametr jest ustawiony na UnsetValuewartość .

Przykłady

Poniższy przykład wywołuje ten podpis konstruktora:

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

Uwagi

Typ podanej defaultValue wartości musi być zgodny lub powiązany z typem określonym w oryginalnej rejestracji właściwości zależności, do którego zostaną zastosowane te metadane. Niezgodność między typem wartości domyślnej metadanych a typem właściwości zależności, która jest stosowana, może być trudna do debugowania, ponieważ niezgodność nie jest wykrywalna podczas kompilacji. System właściwości nie ocenia obowiązującej wartości właściwości do czasu wykonywania, dlatego wynik niezgodności typu wartości domyślnej/właściwości jest błędem czasu wykonywania.

Wartość UnsetValue ma specjalne znaczenie w systemie właściwości i nie może być używana jako wartość domyślna właściwości zależności.

Wartości oznaczone jako flagi zestawu w parametrze flags ustawią wartość FrameworkPropertyMetadata logiczną właściwości pasujących FrameworkPropertyMetadataOptions do nazwy tej flagi na truewartość . Następnie można zmienić wartości właściwości w metadanych, o ile metadane nie zostały jeszcze zastosowane do określonej operacji systemu właściwości.

Zobacz też

Dotyczy

FrameworkPropertyMetadata(Object, PropertyChangedCallback)

Inicjuje FrameworkPropertyMetadata nowe wystąpienie klasy z podaną wartością domyślną i określonym PropertyChangedCallback wywołaniem zwrotnym.

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

Wartość domyślna właściwości zależności, zwykle podana jako wartość określonego typu.

propertyChangedCallback
PropertyChangedCallback

Odwołanie do implementacji programu obsługi, którą system właściwości wywoła za każdym razem, gdy zmienia się efektywna wartość właściwości.

Wyjątki

defaultValue parametr jest ustawiony na UnsetValuewartość .

Przykłady

Poniższy przykład wywołuje ten podpis konstruktora:

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

Uwagi

Typ podanej defaultValue wartości musi być zgodny lub powiązany z typem określonym w oryginalnej rejestracji właściwości zależności, do którego zostaną zastosowane te metadane. Niezgodność między typem wartości domyślnej metadanych a typem właściwości zależności, która jest stosowana, może być trudna do debugowania, ponieważ niezgodność nie jest wykrywalna podczas kompilacji. System właściwości nie ocenia obowiązującej wartości właściwości do czasu wykonywania, dlatego wynik niezgodności typu wartości domyślnej/właściwości jest błędem czasu wykonywania.

Wartość UnsetValue ma specjalne znaczenie w systemie właściwości i nie może być używana jako wartość domyślna właściwości zależności.

Zobacz też

Dotyczy

FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)

Inicjuje FrameworkPropertyMetadata nowe wystąpienie klasy z określonymi wywołaniami zwrotnymi.

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

Odwołanie do implementacji programu obsługi, którą system właściwości wywoła za każdym razem, gdy zmienia się efektywna wartość właściwości.

coerceValueCallback
CoerceValueCallback

Odwołanie do implementacji programu obsługi będzie wywoływane za każdym razem, gdy system właściwości wywołuje CoerceValue(DependencyProperty) tę właściwość zależności.

Przykłady

Poniższy przykład wywołuje ten podpis konstruktora:

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

Uwagi

Ta implementacja wywołuje inicjator podstawowy, a następnie dodaje coerceValueCallback właściwość przez ustawienie właściwości w wystąpieniu podstawowym.

Zobacz też

Dotyczy

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

Inicjuje nowe wystąpienie FrameworkPropertyMetadata klasy z podaną wartością domyślną i opcjami metadanych struktury oraz określonym PropertyChangedCallback wywołaniem zwrotnym.

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

Wartość domyślna właściwości zależności, zwykle podana jako wartość określonego typu.

flags
FrameworkPropertyMetadataOptions

Flagi opcji metadanych (kombinacja FrameworkPropertyMetadataOptions wartości). Te opcje określają właściwości zależności, które współdziałają z systemami, takimi jak układ lub powiązanie danych.

propertyChangedCallback
PropertyChangedCallback

Odwołanie do implementacji programu obsługi, którą system właściwości wywoła za każdym razem, gdy zmienia się efektywna wartość właściwości.

Wyjątki

defaultValue parametr jest ustawiony na UnsetValuewartość .

Przykłady

Poniższy przykład wywołuje ten podpis konstruktora:

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

Uwagi

Typ podanej defaultValue wartości musi być zgodny lub powiązany z typem określonym w oryginalnej rejestracji właściwości zależności, do którego zostaną zastosowane te metadane. Niezgodność między typem wartości domyślnej metadanych a typem właściwości zależności, która jest stosowana, może być trudna do debugowania, ponieważ niezgodność nie jest wykrywalna podczas kompilacji. System właściwości nie ocenia obowiązującej wartości właściwości do czasu wykonywania, dlatego wynik niezgodności typu wartości domyślnej/właściwości jest błędem czasu wykonywania.

Wartość UnsetValue ma specjalne znaczenie w systemie właściwości i nie może być używana jako wartość domyślna właściwości zależności.

Wartości oznaczone jako flagi zestawu w parametrze flags ustawią wartość FrameworkPropertyMetadata logiczną właściwości pasujących FrameworkPropertyMetadataOptions do nazwy tej flagi na truewartość . Nadal można zmienić wartości właściwości w metadanych, o ile metadane nie zostały jeszcze zastosowane do określonej operacji systemu właściwości.

Zobacz też

Dotyczy

FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Inicjuje FrameworkPropertyMetadata nowe wystąpienie klasy z podaną wartością domyślną i określonymi wywołaniami zwrotnymi.

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

Wartość domyślna właściwości zależności, zwykle podana jako określony typ.

propertyChangedCallback
PropertyChangedCallback

Odwołanie do implementacji programu obsługi, którą system właściwości wywoła za każdym razem, gdy zmienia się efektywna wartość właściwości.

coerceValueCallback
CoerceValueCallback

Odwołanie do implementacji programu obsługi, która będzie wywoływana za każdym razem, gdy system właściwości wywołuje CoerceValue(DependencyProperty) tę właściwość zależności.

Wyjątki

defaultValue parametr jest ustawiony na UnsetValuewartość .

Przykłady

Poniższy przykład wywołuje ten podpis konstruktora:

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

Uwagi

Typ podanej defaultValue wartości musi być zgodny lub powiązany z typem określonym w oryginalnej rejestracji właściwości zależności, do którego zostaną zastosowane te metadane. Niezgodność między typem wartości domyślnej metadanych a typem właściwości zależności, która jest stosowana, może być trudna do debugowania, ponieważ niezgodność nie jest wykrywalna podczas kompilacji. System właściwości nie ocenia obowiązującej wartości właściwości do czasu wykonywania, dlatego wynik niezgodności typu wartości domyślnej/właściwości jest błędem czasu wykonywania.

Wartość UnsetValue ma specjalne znaczenie w systemie właściwości i nie może być używana jako wartość domyślna właściwości zależności.

Zobacz też

Dotyczy

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)

Inicjuje nowe wystąpienie FrameworkPropertyMetadata klasy z podaną wartością domyślną i opcjami metadanych struktury oraz określonymi wywołaniami zwrotnymi.

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

Wartość domyślna właściwości zależności, zwykle podana jako określony typ.

flags
FrameworkPropertyMetadataOptions

Flagi opcji metadanych (kombinacja FrameworkPropertyMetadataOptions wartości). Te opcje określają właściwości zależności, które współdziałają z systemami, takimi jak układ lub powiązanie danych.

propertyChangedCallback
PropertyChangedCallback

Odwołanie do implementacji programu obsługi, którą system właściwości wywoła za każdym razem, gdy zmienia się efektywna wartość właściwości.

coerceValueCallback
CoerceValueCallback

Odwołanie do implementacji programu obsługi, która będzie wywoływana za każdym razem, gdy system właściwości wywołuje CoerceValue(DependencyProperty) tę właściwość.

Wyjątki

defaultValue parametr jest ustawiony na UnsetValuewartość .

Przykłady

Poniższy przykład wywołuje ten podpis konstruktora:

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

Uwagi

Typ podanej defaultValue wartości musi być zgodny lub powiązany z typem określonym w oryginalnej rejestracji właściwości zależności, do którego zostaną zastosowane te metadane. Niezgodność między typem wartości domyślnej metadanych a typem właściwości zależności, która jest stosowana, może być trudna do debugowania, ponieważ niezgodność nie jest wykrywalna podczas kompilacji. System właściwości nie ocenia obowiązującej wartości właściwości do czasu wykonywania, dlatego wynik niezgodności typu wartości domyślnej/właściwości jest błędem czasu wykonywania.

Wartość UnsetValue ma specjalne znaczenie w systemie właściwości i nie może być używana jako wartość domyślna właściwości zależności.

Wartości oznaczone jako flagi zestawu w parametrze flags ustawią wartość FrameworkPropertyMetadata logiczną właściwości pasujących FrameworkPropertyMetadataOptions do nazwy tej flagi na truewartość . Nadal można zmienić wartości właściwości w metadanych, o ile metadane nie zostały jeszcze zastosowane do określonej operacji systemu właściwości.

Zobacz też

Dotyczy

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

Inicjuje nowe wystąpienie FrameworkPropertyMetadata klasy z podaną wartością domyślną i opcjami metadanych struktury, określonymi wywołaniami zwrotnymi i wartością logiczną, która może służyć do zapobiegania animacji właściwości.

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

Wartość domyślna właściwości zależności, zwykle podana jako określony typ.

flags
FrameworkPropertyMetadataOptions

Flagi opcji metadanych (kombinacja FrameworkPropertyMetadataOptions wartości). Te opcje określają właściwości zależności, które współdziałają z systemami, takimi jak układ lub powiązanie danych.

propertyChangedCallback
PropertyChangedCallback

Odwołanie do implementacji programu obsługi, którą system właściwości wywoła za każdym razem, gdy zmienia się efektywna wartość właściwości.

coerceValueCallback
CoerceValueCallback

Odwołanie do implementacji programu obsługi, która będzie wywoływana za każdym razem, gdy system właściwości wywołuje CoerceValue(DependencyProperty) tę właściwość zależności.

isAnimationProhibited
Boolean

true aby uniemożliwić systemowi właściwości animowanie właściwości, do których są stosowane te metadane. Takie właściwości spowodują wyjątek czasu wykonywania pochodzący z systemu właściwości, jeśli zostaną podjęta próba animacji. false aby zezwolić na animowanie właściwości. Wartość domyślna to false.

Wyjątki

defaultValue parametr jest ustawiony na UnsetValuewartość .

Przykłady

Poniższy przykład wywołuje ten podpis konstruktora:

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

Uwagi

Typ podanej defaultValue wartości musi być zgodny lub powiązany z typem określonym w oryginalnej rejestracji właściwości zależności, do którego zostaną zastosowane te metadane. Niezgodność między typem wartości domyślnej metadanych a typem właściwości zależności, która jest stosowana, może być trudna do debugowania, ponieważ niezgodność nie jest wykrywalna podczas kompilacji. System właściwości nie ocenia obowiązującej wartości właściwości do czasu wykonywania, dlatego wynik niezgodności typu wartości domyślnej/właściwości jest błędem czasu wykonywania.

Wartość UnsetValue ma specjalne znaczenie w systemie właściwości i nie może być używana jako wartość domyślna właściwości zależności.

Parametr isAnimationProhibited ustawia początkową wartość IsAnimationProhibited właściwości zadeklarowanej przez natychmiastową klasę bazową UIPropertyMetadata .

Wartości oznaczone jako flagi zestawu w parametrze flags ustawią wartość FrameworkPropertyMetadata logiczną właściwości pasujących FrameworkPropertyMetadataOptions do nazwy tej flagi na truewartość . Nadal można zmienić wartości właściwości w metadanych, o ile metadane nie zostały jeszcze zastosowane do określonej operacji systemu właściwości.

Zobacz też

Dotyczy

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

Inicjuje nowe wystąpienie FrameworkPropertyMetadata klasy z podaną wartością domyślną i opcjami metadanych struktury, określonymi wywołaniami zwrotnymi, wartością logiczną, która może służyć do zapobiegania animacji właściwości oraz domyślnego wyzwalacza aktualizacji powiązania danych.

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

Wartość domyślna właściwości zależności, zwykle podana jako określony typ.

flags
FrameworkPropertyMetadataOptions

Flagi opcji metadanych (kombinacja FrameworkPropertyMetadataOptions wartości). Te opcje określają właściwości zależności, które współdziałają z systemami, takimi jak układ lub powiązanie danych.

propertyChangedCallback
PropertyChangedCallback

Odwołanie do implementacji programu obsługi, którą system właściwości wywoła za każdym razem, gdy zmienia się efektywna wartość właściwości.

coerceValueCallback
CoerceValueCallback

Odwołanie do implementacji programu obsługi, która będzie wywoływana za każdym razem, gdy system właściwości wywołuje CoerceValue(DependencyProperty) tę właściwość.

isAnimationProhibited
Boolean

true aby uniemożliwić systemowi właściwości animowanie właściwości, do których są stosowane te metadane. Takie właściwości spowodują wyjątek czasu wykonywania pochodzący z systemu właściwości, jeśli zostaną podjęta próba animacji. Wartość domyślna to false.

defaultUpdateSourceTrigger
UpdateSourceTrigger

Właściwość UpdateSourceTrigger do użycia podczas stosowania powiązań dla tej właściwości, które mają ustawioną UpdateSourceTrigger wartość Default.

Wyjątki

defaultValue parametr jest ustawiony na UnsetValuewartość .

Przykłady

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

Uwagi

Typ podanej defaultValue wartości musi być zgodny lub powiązany z typem określonym w oryginalnej rejestracji właściwości zależności, do którego zostaną zastosowane te metadane. Niezgodność między typem wartości domyślnej metadanych a typem właściwości zależności, która jest stosowana, może być trudna do debugowania, ponieważ niezgodność nie jest wykrywalna podczas kompilacji. System właściwości nie ocenia obowiązującej wartości właściwości do czasu wykonywania, dlatego wynik niezgodności typu wartości domyślnej/właściwości jest błędem czasu wykonywania.

Wartość UnsetValue ma specjalne znaczenie w systemie właściwości i nie może być używana jako wartość domyślna właściwości zależności.

Parametr isAnimationProhibited ustawia początkową wartość IsAnimationProhibited właściwości zadeklarowanej przez natychmiastową klasę bazową UIPropertyMetadata .

Aby uzyskać więcej informacji na temat zachowania źródła aktualizacji dla powiązań, zobacz Omówienie powiązań danych.

Wartości oznaczone jako flagi zestawu w parametrze flags ustawią wartość FrameworkPropertyMetadata logiczną właściwości pasujących FrameworkPropertyMetadataOptions do nazwy tej flagi na truewartość . Nadal można zmienić wartości właściwości w metadanych, o ile metadane nie zostały jeszcze zastosowane do określonej operacji systemu właściwości.

Zobacz też

Dotyczy