Метаданные свойств среды

Статья
11/05/2008

Обновлен: Ноябрь 2007

Параметры метаданных свойств среды выводятся для свойств объектных элементов, которые находятся на уровне среды WPF в архитектуре Windows Presentation Foundation (WPF). В общем, обозначение уровень среды WPF означает, что такие возможности, как отрисовка, привязка данных и уточнения системы свойств, обрабатываются API-интерфейсы представлением WPF и исполняемыми файлами. Метаданные свойств среды запрашиваются этими системами для определения зависимых от свойств характеристик конкретных свойств элементов.

В этом разделе содержатся следующие подразделы.

Необходимые компоненты
Передаваемые сведения в метаданных свойств среды
Чтение FrameworkPropertyMetadata
Задание Метаданных
Поведение слияния метаданных свойств среды
Связанные разделы

Необходимые компоненты

Этот раздел предполагает понимание свойств зависимости с точки зрения пользователя существующих свойств зависимости для классов Windows Presentation Foundation (WPF) и предварительное прочтение раздела Общие сведения о свойствах зависимости. Также необходимо ознакомиться с Метаданные свойства зависимости.

Передаваемые сведения в метаданных свойств среды

Метаданные свойств среды можно разделить на следующие категории:

Передающие свойства макета, влияющие на элемент (AffectsArrange, AffectsMeasure, AffectsRender). Можно задать эти флаги в метаданных, если свойство влияет на соответствующие аспекты, а также при реализации методов MeasureOverride / ArrangeOverride в классе для предоставления определенного поведения и данных отрисовки системе макета. Обычно такая реализация проверяет аннулирование свойств в свойствах зависимости, где любое из этих свойств макета имеет значение true в метаданных свойств, и только такое аннулирование потребует нового прохода разметки.
Передающие свойства макета, влияющие на родительский элемент элемента (AffectsParentArrange, AffectsParentMeasure). Примеры, в которых эти флаги задаются по умолчанию: FixedPage.Left и Paragraph.KeepWithNext.

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

Примечание.
Термин «наследует» в контексте значений свойств имеет особое значение для свойств зависимости; это означает, что дочерние элементы могут наследовать текущее значение свойства зависимости от родительских элементов из-за возможностей системы свойств WPF на уровне среды WPF. Он ничего не делает непосредственно с типом управляемого кода и наследованием членов при помощи производных типов. Дополнительные сведения см. в разделе Наследование значения свойства.

Термин «наследует» в контексте значений свойств имеет особое значение для свойств зависимости; это означает, что дочерние элементы могут наследовать текущее значение свойства зависимости от родительских элементов из-за возможностей системы свойств WPF на уровне среды WPF. Он ничего не делает непосредственно с типом управляемого кода и наследованием членов при помощи производных типов. Дополнительные сведения см. в разделе Наследование значения свойства.

Передающие характеристики привязки данных (IsNotDataBindable, BindsTwoWayByDefault). По умолчанию свойства зависимости в среде поддерживают привязку данных с поведением односторонней привязки. Можно отключить привязку данных, если для нее не существует каких-либо сценариев (поскольку они предназначены для гибкости и расширяемости, существует лишь небольшое количество примеров таких свойств в WPFAPI-интерфейсы по умолчанию). Можно установить привязку для получения двусторонней привязки по умолчанию для свойств, связывающих вместе модели поведения элемента управления среди его компонентных составляющих (например, IsSubmenuOpen), или там, где двусторонняя привязка является общим и ожидаемым сценарием для пользователей (например, Text). Изменение метаданных, связанных с привязкой данных, влияет только на значение по умолчанию; для каждой привязки в отдельности это значение по умолчанию всегда может быть изменено. Дополнительные сведения о режимах привязки и о привязке в целом см. в разделе Общие сведения о связывании данных.
Передающие сведения о том, должны ли свойства заноситься в журнал приложениями или службами, поддерживающими ведение журнала (Journal). Для общих элементов ведение журнала не включено по умолчанию, но оно выборочно включается для некоторых пользовательских элементов управления ввода. Это свойство предназначено для прочтения службами ведения журнала, в том числе WPF реализацией ведения журнала, и обычно устанавливается для пользовательских элементов управления, таких как пользовательский выбор в списке, который должен сохраняться при переходах. Дополнительные сведения о журналах см. в разделе Общие сведения о переходах.

Чтение FrameworkPropertyMetadata

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

Задание Метаданных

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

Для существующих свойств (вызов AddOwner или OverrideMetadata) следует всегда использовать переопределение с помощью типа метаданных, используемого в исходной регистрации.

Если создается экземпляр FrameworkPropertyMetadata, существует два способа заполнения метаданных значениями для определенных свойств, которые взаимодействуют с характеристиками свойств среды:

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

Поведение слияния метаданных свойств среды

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

Объект PropertyChangedCallback объединяется. Если добавить новый обратный вызов PropertyChangedCallback, он сохранится в метаданных. Если в переопределении не указан обратный вызов PropertyChangedCallback, значение PropertyChangedCallback переходит в качестве ссылки из ближайшего родительского объекта, указанного в метаданных.
Фактическое поведение системы свойств PropertyChangedCallback заключается в том, что реализации для всех владельцев метаданных в иерархии сохраняются и добавляются в таблицу в порядке выполнения системой свойств (сначала вызывается большинство обратных вызовов производного класса). Наследуемые обратные вызовы запускаются только один раз и считаются принадлежащими классу, которые поместил их в метаданные.
Объект DefaultValue заменяется. Если в переопределении не указан обратный вызов PropertyChangedCallback, значение DefaultValue переходит из ближайшего родительского объекта, указанного в метаданных.
Реализации CoerceValueCallback заменяются. Если добавить новый обратный вызов CoerceValueCallback, он сохранится в метаданных. Если в переопределении не указан обратный вызов CoerceValueCallback, значение CoerceValueCallback переходит в качестве ссылки из ближайшего родительского объекта, указанного в метаданных.
Поведение системы свойств состоит в том, что только CoerceValueCallback вызывается непосредственно из метаданных. Ссылки на другие реализации CoerceValueCallback в иерархии не сохраняются.
Флаги FrameworkPropertyMetadataOptions объединяются поразрядной операцией дизъюнкции, в отличие от различных эквивалентных логических значений свойств в FrameworkPropertyMetadata наследуемых метаданных. IsAnimationProhibited заменяется любым новым значением или сохраняет значение из наследуемых метаданных.