Поделиться через

FrameworkPropertyMetadata Конструкторы

Определение

Пространство имен:
System.Windows
Сборка:
PresentationFramework.dll

Инициализирует новый экземпляр класса FrameworkPropertyMetadata.

Перегрузки

Имя Описание
FrameworkPropertyMetadata()

Инициализирует новый экземпляр класса FrameworkPropertyMetadata.
FrameworkPropertyMetadata(Object)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанным значением по умолчанию.
FrameworkPropertyMetadata(PropertyChangedCallback)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанным PropertyChangedCallback обратным вызовом.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанным значением по умолчанию и параметрами метаданных уровня платформы.
FrameworkPropertyMetadata(Object, PropertyChangedCallback)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанным значением по умолчанию и указанным PropertyChangedCallback обратным вызовом.
FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанными обратными вызовами.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанным значением по умолчанию и параметрами метаданных платформы и указанным PropertyChangedCallback обратным вызовом.
FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанным значением по умолчанию и указанными обратными вызовами.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанным значением по умолчанию и параметрами метаданных платформы и указанными обратными вызовами.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с предоставленным значением по умолчанию и параметрами метаданных платформы, указанными обратными вызовами и логическим элементом, который можно использовать для предотвращения анимации свойства.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с предоставленным значением по умолчанию и параметрами метаданных платформы, указанными обратными вызовами, логическим методом, который можно использовать для предотвращения анимации свойства и триггера обновления привязки данных по умолчанию.

FrameworkPropertyMetadata()

Инициализирует новый экземпляр класса FrameworkPropertyMetadata.

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

Комментарии

Эта сигнатура инициализирует все значения FrameworkPropertyMetadata свойств по умолчанию. DefaultValue будет иметь значение null, а различные FrameworkPropertyMetadata логические свойства будут false.

См. также раздел

Применяется к

FrameworkPropertyMetadata(Object)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанным значением по умолчанию.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue);
public FrameworkPropertyMetadata(object defaultValue);
new System.Windows.FrameworkPropertyMetadata : obj -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object)

Параметры

defaultValue
Object

Значение по умолчанию свойства зависимостей обычно предоставляется в качестве значения определенного типа.

Исключения

ArgumentException

defaultValue задан как UnsetValue.

Примеры

В следующем примере вызывается эта подпись конструктора:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(Double.NaN);

Комментарии

Тип указанного значения defaultValue должен соответствовать или быть связан с типом, указанным в исходной регистрации свойства зависимостей, к которому будут применены эти метаданные. Несоответствия между типом значений метаданных по умолчанию и типом применяемого свойства зависимости может быть трудно выполнить отладку, так как несоответствие не обнаруживается во время компиляции. Система свойств не оценивает эффективное значение свойства до времени выполнения, поэтому результат несоответствия типа значения или типа свойства по умолчанию является ошибкой во время выполнения.

Значение имеет особое значение в системе свойств и не может использоваться в качестве значения UnsetValue свойства зависимости по умолчанию.

См. также раздел

Применяется к

FrameworkPropertyMetadata(PropertyChangedCallback)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанным PropertyChangedCallback обратным вызовом.

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)

Параметры

propertyChangedCallback
PropertyChangedCallback

Ссылка на реализацию обработчика, которая будет вызываться системой свойств всякий раз, когда изменяется эффективное значение свойства.

Примеры

В следующем примере вызывается эта подпись конструктора:

static FrameworkPropertyMetadata fpm;

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

Применяется к

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанным значением по умолчанию и параметрами метаданных уровня платформы.

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)

Параметры

defaultValue
Object

Значение по умолчанию свойства зависимостей обычно предоставляется в качестве значения определенного типа.

flags
FrameworkPropertyMetadataOptions

Флаги параметра метаданных (сочетание значений FrameworkPropertyMetadataOptions ). Эти параметры определяют характеристики свойства зависимостей, взаимодействующего с системами, такими как макет или привязка данных.

Исключения

ArgumentException

defaultValue задан как UnsetValue.

Примеры

В следующем примере вызывается эта подпись конструктора:

static FrameworkPropertyMetadata fpm;

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

Комментарии

Тип указанного значения defaultValue должен соответствовать или быть связан с типом, указанным в исходной регистрации свойства зависимостей, к которому будут применены эти метаданные. Несоответствия между типом значений метаданных по умолчанию и типом применяемого свойства зависимости может быть трудно выполнить отладку, так как несоответствие не обнаруживается во время компиляции. Система свойств не оценивает эффективное значение свойства до времени выполнения, поэтому результат несоответствия типа значения или типа свойства по умолчанию является ошибкой во время выполнения.

Значение имеет особое значение в системе свойств и не может использоваться в качестве значения UnsetValue свойства зависимости по умолчанию.

Значения, помеченные как заданные флаги в параметреflags, задали логическое значение FrameworkPropertyMetadata свойств, которые соответствуют имени trueэтого FrameworkPropertyMetadataOptions флага. Впоследствии можно изменить значения свойств в метаданных, если метаданные еще не применены к определенной системе свойств.

См. также раздел

Применяется к

FrameworkPropertyMetadata(Object, PropertyChangedCallback)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанным значением по умолчанию и указанным PropertyChangedCallback обратным вызовом.

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)

Параметры

defaultValue
Object

Значение по умолчанию свойства зависимостей обычно предоставляется в качестве значения определенного типа.

propertyChangedCallback
PropertyChangedCallback

Ссылка на реализацию обработчика, которая будет вызываться системой свойств всякий раз, когда изменяется эффективное значение свойства.

Исключения

ArgumentException

defaultValue задан как UnsetValue.

Примеры

В следующем примере вызывается эта подпись конструктора:

static FrameworkPropertyMetadata fpm;

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

Комментарии

Тип указанного значения defaultValue должен соответствовать или быть связан с типом, указанным в исходной регистрации свойства зависимостей, к которому будут применены эти метаданные. Несоответствия между типом значений метаданных по умолчанию и типом применяемого свойства зависимости может быть трудно выполнить отладку, так как несоответствие не обнаруживается во время компиляции. Система свойств не оценивает эффективное значение свойства до времени выполнения, поэтому результат несоответствия типа значения или типа свойства по умолчанию является ошибкой во время выполнения.

Значение имеет особое значение в системе свойств и не может использоваться в качестве значения UnsetValue свойства зависимости по умолчанию.

См. также раздел

Применяется к

FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанными обратными вызовами.

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)

Параметры

propertyChangedCallback
PropertyChangedCallback

Ссылка на реализацию обработчика, которая будет вызываться системой свойств всякий раз, когда изменяется эффективное значение свойства.

coerceValueCallback
CoerceValueCallback

Ссылка на реализацию обработчика будет вызываться всякий раз, когда система свойств вызывает CoerceValue(DependencyProperty) это свойство зависимостей.

Примеры

В следующем примере вызывается эта подпись конструктора:

static FrameworkPropertyMetadata fpm;

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

Комментарии

Эта реализация вызывает базовый инициализатор, а затем добавляет coerceValueCallback его, задав свойство в базовом экземпляре.

См. также раздел

Применяется к

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанным значением по умолчанию и параметрами метаданных платформы и указанным PropertyChangedCallback обратным вызовом.

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)

Параметры

defaultValue
Object

Значение по умолчанию свойства зависимостей обычно предоставляется в качестве значения определенного типа.

flags
FrameworkPropertyMetadataOptions

Флаги параметра метаданных (сочетание значений FrameworkPropertyMetadataOptions ). Эти параметры определяют характеристики свойства зависимостей, взаимодействующего с системами, такими как макет или привязка данных.

propertyChangedCallback
PropertyChangedCallback

Ссылка на реализацию обработчика, которая будет вызываться системой свойств всякий раз, когда изменяется эффективное значение свойства.

Исключения

ArgumentException

defaultValue задан как UnsetValue.

Примеры

В следующем примере вызывается эта подпись конструктора:

static FrameworkPropertyMetadata fpm;

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

Комментарии

Тип указанного значения defaultValue должен соответствовать или быть связан с типом, указанным в исходной регистрации свойства зависимостей, к которому будут применены эти метаданные. Несоответствия между типом значений метаданных по умолчанию и типом применяемого свойства зависимости может быть трудно выполнить отладку, так как несоответствие не обнаруживается во время компиляции. Система свойств не оценивает эффективное значение свойства до времени выполнения, поэтому результат несоответствия типа значения или типа свойства по умолчанию является ошибкой во время выполнения.

Значение имеет особое значение в системе свойств и не может использоваться в качестве значения UnsetValue свойства зависимости по умолчанию.

Значения, помеченные как заданные флаги в параметреflags, задали логическое значение FrameworkPropertyMetadata свойств, которые соответствуют имени trueэтого FrameworkPropertyMetadataOptions флага. Вы по-прежнему можете изменить значения свойств в метаданных, если метаданные еще не применены к определенной системе свойств.

См. также раздел

Применяется к

FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанным значением по умолчанию и указанными обратными вызовами.

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)

Параметры

defaultValue
Object

Значение по умолчанию свойства зависимостей, которое обычно предоставляется в качестве определенного типа.

propertyChangedCallback
PropertyChangedCallback

Ссылка на реализацию обработчика, которая будет вызываться системой свойств всякий раз, когда изменяется эффективное значение свойства.

coerceValueCallback
CoerceValueCallback

Ссылка на реализацию обработчика, которая будет вызываться всякий раз, когда система свойств вызывает CoerceValue(DependencyProperty) это свойство зависимостей.

Исключения

ArgumentException

defaultValue задан как UnsetValue.

Примеры

В следующем примере вызывается эта подпись конструктора:

static FrameworkPropertyMetadata fpm;

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

Комментарии

Тип указанного значения defaultValue должен соответствовать или быть связан с типом, указанным в исходной регистрации свойства зависимостей, к которому будут применены эти метаданные. Несоответствия между типом значений метаданных по умолчанию и типом применяемого свойства зависимости может быть трудно выполнить отладку, так как несоответствие не обнаруживается во время компиляции. Система свойств не оценивает эффективное значение свойства до времени выполнения, поэтому результат несоответствия типа значения или типа свойства по умолчанию является ошибкой во время выполнения.

Значение имеет особое значение в системе свойств и не может использоваться в качестве значения UnsetValue свойства зависимости по умолчанию.

См. также раздел

Применяется к

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с указанным значением по умолчанию и параметрами метаданных платформы и указанными обратными вызовами.

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)

Параметры

defaultValue
Object

Значение по умолчанию свойства зависимостей, которое обычно предоставляется в качестве определенного типа.

flags
FrameworkPropertyMetadataOptions

Флаги параметра метаданных (сочетание значений FrameworkPropertyMetadataOptions ). Эти параметры определяют характеристики свойства зависимостей, взаимодействующего с системами, такими как макет или привязка данных.

propertyChangedCallback
PropertyChangedCallback

Ссылка на реализацию обработчика, которая будет вызываться системой свойств всякий раз, когда изменяется эффективное значение свойства.

coerceValueCallback
CoerceValueCallback

Ссылка на реализацию обработчика, которая будет вызываться всякий раз, когда система свойств вызывает CoerceValue(DependencyProperty) это свойство.

Исключения

ArgumentException

defaultValue задан как UnsetValue.

Примеры

В следующем примере вызывается эта подпись конструктора:

static FrameworkPropertyMetadata fpm;

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

Комментарии

Тип указанного значения defaultValue должен соответствовать или быть связан с типом, указанным в исходной регистрации свойства зависимостей, к которому будут применены эти метаданные. Несоответствия между типом значений метаданных по умолчанию и типом применяемого свойства зависимости может быть трудно выполнить отладку, так как несоответствие не обнаруживается во время компиляции. Система свойств не оценивает эффективное значение свойства до времени выполнения, поэтому результат несоответствия типа значения или типа свойства по умолчанию является ошибкой во время выполнения.

Значение имеет особое значение в системе свойств и не может использоваться в качестве значения UnsetValue свойства зависимости по умолчанию.

Значения, помеченные как заданные флаги в параметреflags, задали логическое значение FrameworkPropertyMetadata свойств, которые соответствуют имени trueэтого FrameworkPropertyMetadataOptions флага. Вы по-прежнему можете изменить значения свойств в метаданных, если метаданные еще не применены к определенной системе свойств.

См. также раздел

Применяется к

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

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с предоставленным значением по умолчанию и параметрами метаданных платформы, указанными обратными вызовами и логическим элементом, который можно использовать для предотвращения анимации свойства.

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)

Параметры

defaultValue
Object

Значение по умолчанию свойства зависимостей, которое обычно предоставляется в качестве определенного типа.

flags
FrameworkPropertyMetadataOptions

Флаги параметра метаданных (сочетание значений FrameworkPropertyMetadataOptions ). Эти параметры определяют характеристики свойства зависимостей, взаимодействующего с системами, такими как макет или привязка данных.

propertyChangedCallback
PropertyChangedCallback

Ссылка на реализацию обработчика, которая будет вызываться системой свойств всякий раз, когда изменяется эффективное значение свойства.

coerceValueCallback
CoerceValueCallback

Ссылка на реализацию обработчика, которая будет вызываться всякий раз, когда система свойств вызывает CoerceValue(DependencyProperty) это свойство зависимостей.

isAnimationProhibited
Boolean

true чтобы предотвратить анимацию свойства, к которому применяются эти метаданные, не позволяет системе свойств. Такие свойства вызывают исключение во время выполнения, исходя из системы свойств, если при попытке анимации этих свойств возникает исключение. false разрешение анимации свойства. Значение по умолчанию — false.

Исключения

ArgumentException

defaultValue задан как UnsetValue.

Примеры

В следующем примере вызывается эта подпись конструктора:

static FrameworkPropertyMetadata fpm;

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

Комментарии

Тип указанного значения defaultValue должен соответствовать или быть связан с типом, указанным в исходной регистрации свойства зависимостей, к которому будут применены эти метаданные. Несоответствия между типом значений метаданных по умолчанию и типом применяемого свойства зависимости может быть трудно выполнить отладку, так как несоответствие не обнаруживается во время компиляции. Система свойств не оценивает эффективное значение свойства до времени выполнения, поэтому результат несоответствия типа значения или типа свойства по умолчанию является ошибкой во время выполнения.

Значение имеет особое значение в системе свойств и не может использоваться в качестве значения UnsetValue свойства зависимости по умолчанию.

Параметр isAnimationProhibited задает начальное значение свойства IsAnimationProhibited , объявленного непосредственным базовым UIPropertyMetadata классом.

Значения, помеченные как заданные флаги в параметреflags, задали логическое значение FrameworkPropertyMetadata свойств, которые соответствуют имени trueэтого FrameworkPropertyMetadataOptions флага. Вы по-прежнему можете изменить значения свойств в метаданных, если метаданные еще не применены к определенной системе свойств.

См. также раздел

Применяется к

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

Инициализирует новый экземпляр FrameworkPropertyMetadata класса с предоставленным значением по умолчанию и параметрами метаданных платформы, указанными обратными вызовами, логическим методом, который можно использовать для предотвращения анимации свойства и триггера обновления привязки данных по умолчанию.

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)

Параметры

defaultValue
Object

Значение по умолчанию свойства зависимостей, которое обычно предоставляется в качестве определенного типа.

flags
FrameworkPropertyMetadataOptions

Флаги параметра метаданных (сочетание значений FrameworkPropertyMetadataOptions ). Эти параметры определяют характеристики свойства зависимостей, взаимодействующего с системами, такими как макет или привязка данных.

propertyChangedCallback
PropertyChangedCallback

Ссылка на реализацию обработчика, которая будет вызываться системой свойств всякий раз, когда изменяется эффективное значение свойства.

coerceValueCallback
CoerceValueCallback

Ссылка на реализацию обработчика, которая будет вызываться всякий раз, когда система свойств вызывает CoerceValue(DependencyProperty) это свойство.

isAnimationProhibited
Boolean

true чтобы предотвратить анимацию свойства, к которому применяются эти метаданные, не позволяет системе свойств. Такие свойства вызывают исключение во время выполнения, исходя из системы свойств, если при попытке анимации этих свойств возникает исключение. Значение по умолчанию — false.

defaultUpdateSourceTrigger
UpdateSourceTrigger

Используется UpdateSourceTrigger при применении привязок для этого свойства, для которых задано их UpdateSourceTrigger значение Default.

Исключения

ArgumentException

defaultValue задан как UnsetValue.

Примеры

static FrameworkPropertyMetadata fpm;

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

Комментарии

Тип указанного значения defaultValue должен соответствовать или быть связан с типом, указанным в исходной регистрации свойства зависимостей, к которому будут применены эти метаданные. Несоответствия между типом значений метаданных по умолчанию и типом применяемого свойства зависимости может быть трудно выполнить отладку, так как несоответствие не обнаруживается во время компиляции. Система свойств не оценивает эффективное значение свойства до времени выполнения, поэтому результат несоответствия типа значения или типа свойства по умолчанию является ошибкой во время выполнения.

Значение имеет особое значение в системе свойств и не может использоваться в качестве значения UnsetValue свойства зависимости по умолчанию.

Параметр isAnimationProhibited задает начальное значение свойства IsAnimationProhibited , объявленного непосредственным базовым UIPropertyMetadata классом.

Дополнительные сведения о поведении источника обновления для привязок см. в обзоре привязки данных.

Значения, помеченные как заданные флаги в параметреflags, задали логическое значение FrameworkPropertyMetadata свойств, которые соответствуют имени trueэтого FrameworkPropertyMetadataOptions флага. Вы по-прежнему можете изменить значения свойств в метаданных, если метаданные еще не применены к определенной системе свойств.

См. также раздел

Применяется к