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