FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее, влияют ли подсвойства свойства зависимостей на отрисовку вмещающего объекта.
public:
property bool SubPropertiesDoNotAffectRender { bool get(); void set(bool value); };
public bool SubPropertiesDoNotAffectRender { get; set; }
member this.SubPropertiesDoNotAffectRender : bool with get, set
Public Property SubPropertiesDoNotAffectRender As Boolean
Значение свойства
Значение true
, если изменения значений подсвойств не влияют на отрисовку; в противном случае — значение false
. Значение по умолчанию — false
.
Исключения
Метаданные уже применены к операции свойства зависимостей. Поэтому метаданные запечатаны, а их свойства нельзя задать.
Комментарии
Этот параметр метаданных подходит для свойств зависимостей, которые являются ссылочными типами, где этот тип имеет собственные значения свойств. Как правило, логика системы макета предполагает, что любое свойство зависимостей с вложенными свойствами потенциально влияет на макет, так как проверка всех вложенных свойств на наличие изменений занимает больше времени, чем выполнение другого прохода отрисовки. Задание этому параметру значения true
полезно для оптимизации производительности реализации системы макета на уровне платформы WPF.
Свойства производных PropertyMetadata классов обычно определяются в объектной модели как чтение и запись. Это позволяет настроить их после инициализации экземпляра. Однако после использования метаданных в рамках вызова Register, AddOwnerили OverrideMetadataсистема свойств запечатывает этот экземпляр метаданных, а свойства, которые передают особенности метаданных, теперь считаются неизменяемыми. Попытка задать это свойство после IsSealed того, как находится true
в этом экземпляре метаданных, вызовет исключение.
Использование текста XAML
Члены этого класса обычно не используются в XAML.