FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Property

Определение

Возвращает или задает значение, указывающее, влияют ли подсвойства свойства зависимостей на отрисовку вмещающего объекта.Gets or sets a value that indicates whether sub-properties of the dependency property do not affect the rendering of the containing object.

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.true if changes to sub-property values do not affect rendering if changed; otherwise, false. Значение по умолчанию — false.The default is false.

Исключения

Метаданные уже применены к операции свойства зависимостей. Поэтому метаданные запечатаны, а их свойства нельзя задать.The metadata has already been applied to a dependency property operation, so that metadata is sealed and properties of the metadata cannot be set.

Комментарии

Этот параметр метаданные относятся к свойствам зависимостей, которые являются ссылочными типами, где тип имеет собственные значения свойства.This metadata option is pertinent for dependency properties that are reference types, where that type has property values of its own. Как правило логика системы макета — предполагается, что любое свойство зависимостей с подсвойства, влияет на макет, так как проверка всех подсвойств для изменения занимает больше времени чем другой прохода отрисовки.Typically, the layout system logic is to assume that any dependency property with sub-properties potentially will affect layout, because checking all sub-properties for changes is more time consuming than actually running another render pass. Установка данного параметра равным true позволяет оптимизировать производительность реализация системы уровня макета WPF.Setting this option to true is useful for optimizing performance of the WPF framework level layout system implementation.

Свойства классов, производных от PropertyMetadata обычно определяются в модели объектов чтения и записи.Properties on derived classes of PropertyMetadata are typically defined in the object model as read-write. Это, поэтому их можно изменить после инициализации экземпляра.This is so they can be adjusted after initialization of the instance. Однако после исчерпания метаданные как часть вызова Register, AddOwner, или OverrideMetadata, система свойств будет запечатать этот экземпляр метаданных и свойств, которые передают особенности метаданные теперь считаются неизменяемыми.However, once the metadata is consumed as part of a call to Register, AddOwner, or OverrideMetadata, the property system will seal that metadata instance and properties that convey the specifics of the metadata are now considered immutable. Попытка задать это свойство после IsSealed является true на эти метаданные экземпляра будет выдано исключение.Attempting to set this property after IsSealed is true on this metadata instance will raise an exception.

Использование текста XAMLXAML Text Usage

Члены этого класса обычно не используются в XAMLXAML.Members of this class are not typically used in XAMLXAML.

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

Дополнительно