FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Свойство

  • Ссылка

Определение

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

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

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

Значение свойства

Boolean

Значение true, если изменения значений подсвойств не влияют на отрисовку; в противном случае — значение false. Значение по умолчанию — false.

Исключения

InvalidOperationException

Метаданные уже применены к операции свойства зависимостей. Поэтому метаданные запечатаны, а их свойства нельзя задать.

Комментарии

Этот параметр метаданных подходит для свойств зависимостей, которые являются ссылочными типами, где этот тип имеет собственные значения свойств. Как правило, логика системы макета предполагает, что любое свойство зависимостей с вложенными свойствами потенциально влияет на макет, так как проверка всех вложенных свойств на наличие изменений занимает больше времени, чем выполнение другого прохода отрисовки. Задание этому параметру значения true полезно для оптимизации производительности реализации системы макета на уровне платформы WPF.

Свойства производных PropertyMetadata классов обычно определяются в объектной модели как чтение и запись. Это позволяет настроить их после инициализации экземпляра. Однако после использования метаданных в рамках вызова Register, AddOwnerили OverrideMetadataсистема свойств запечатывает этот экземпляр метаданных, а свойства, которые передают особенности метаданных, теперь считаются неизменяемыми. Попытка задать это свойство после IsSealed того, как находится true в этом экземпляре метаданных, вызовет исключение.

Использование текста XAML

Члены этого класса обычно не используются в XAML.

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

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