Udostępnij za pośrednictwem

FrameworkPropertyMetadata Konstruktory

Definicja

Przestrzeń nazw:
System.Windows
Zestaw:
PresentationFramework.dll

Inicjuje nowe wystąpienie klasy FrameworkPropertyMetadata.

Przeciążenia

Nazwa Opis
FrameworkPropertyMetadata()

Inicjuje nowe wystąpienie klasy FrameworkPropertyMetadata.
FrameworkPropertyMetadata(Object)

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

Inicjuje nowe wystąpienie FrameworkPropertyMetadata klasy z określonym PropertyChangedCallback wywołaniem zwrotnym.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

Inicjuje nowe wystąpienie FrameworkPropertyMetadata klasy z podaną wartością domyślną i opcjami metadanych na poziomie platformy.
FrameworkPropertyMetadata(Object, PropertyChangedCallback)

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

Inicjuje nowe wystąpienie FrameworkPropertyMetadata 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 nowe wystąpienie FrameworkPropertyMetadata 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 będzie to null, a różne FrameworkPropertyMetadata właściwości logiczne będą mieć falsewartość .

Zobacz też

Dotyczy

FrameworkPropertyMetadata(Object)

Inicjuje nowe wystąpienie FrameworkPropertyMetadata 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

ArgumentException

defaultValue jest ustawiony na UnsetValue.

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, więc wynikiem niezgodności typu wartości domyślnej/typu właściwości jest błąd 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 nowe wystąpienie FrameworkPropertyMetadata 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 obowiązująca wartość właściwości ulegnie zmianie.

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 nowe wystąpienie FrameworkPropertyMetadata klasy z podaną wartością domyślną i opcjami metadanych na poziomie platformy.

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ą cechy właściwości zależności, które wchodzą w interakcje z systemami, takimi jak układ lub powiązanie danych.

Wyjątki

ArgumentException

defaultValue jest ustawiony na UnsetValue.

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, więc wynikiem niezgodności typu wartości domyślnej/typu właściwości jest błąd 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 nowe wystąpienie FrameworkPropertyMetadata 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 obowiązująca wartość właściwości ulegnie zmianie.

Wyjątki

ArgumentException

defaultValue jest ustawiony na UnsetValue.

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, więc wynikiem niezgodności typu wartości domyślnej/typu właściwości jest błąd 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 nowe wystąpienie FrameworkPropertyMetadata 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 obowiązująca wartość właściwości ulegnie zmianie.

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 element 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ą cechy właściwości zależności, które wchodzą w interakcje 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 obowiązująca wartość właściwości ulegnie zmianie.

Wyjątki

ArgumentException

defaultValue jest ustawiony na UnsetValue.

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, więc wynikiem niezgodności typu wartości domyślnej/typu właściwości jest błąd 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 nowe wystąpienie FrameworkPropertyMetadata 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 obowiązująca wartość właściwości ulegnie zmianie.

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

ArgumentException

defaultValue jest ustawiony na UnsetValue.

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, więc wynikiem niezgodności typu wartości domyślnej/typu właściwości jest błąd 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ą cechy właściwości zależności, które wchodzą w interakcje 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 obowiązująca wartość właściwości ulegnie zmianie.

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

ArgumentException

defaultValue jest ustawiony na UnsetValue.

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, więc wynikiem niezgodności typu wartości domyślnej/typu właściwości jest błąd 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ą cechy właściwości zależności, które wchodzą w interakcje 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 obowiązująca wartość właściwości ulegnie zmianie.

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ą wywołanie wyjątku czasu wykonywania pochodzącego 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

ArgumentException

defaultValue jest ustawiony na UnsetValue.

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, więc wynikiem niezgodności typu wartości domyślnej/typu właściwości jest błąd 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ą cechy właściwości zależności, które wchodzą w interakcje 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 obowiązująca wartość właściwości ulegnie zmianie.

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ą wywołanie wyjątku czasu wykonywania pochodzącego 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

ArgumentException

defaultValue jest ustawiony na UnsetValue.

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, więc wynikiem niezgodności typu wartości domyślnej/typu właściwości jest błąd 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ązania 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