AttachedPropertyBrowsableForChildrenAttribute Класс

Определение

Пространство имен:

System.Windows

Сборка:

PresentationFramework.dll

Указывает, что присоединенное свойство имеет область просмотра, которая распространяется на дочерние элементы в логическом дереве.

public ref class AttachedPropertyBrowsableForChildrenAttribute sealed : System::Windows::AttachedPropertyBrowsableAttribute

[System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false)]
public sealed class AttachedPropertyBrowsableForChildrenAttribute : System.Windows.AttachedPropertyBrowsableAttribute

[<System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false)>]
type AttachedPropertyBrowsableForChildrenAttribute = class
    inherit AttachedPropertyBrowsableAttribute

Public NotInheritable Class AttachedPropertyBrowsableForChildrenAttribute
Inherits AttachedPropertyBrowsableAttribute

Наследование

Object

Attribute

AttachedPropertyBrowsableAttribute

AttachedPropertyBrowsableForChildrenAttribute

Атрибуты

AttributeUsageAttribute

Комментарии

Значение термина browsable, как используется в описаниях этого атрибута .NET Framework, аналогично описаниям, указанным для BrowsableAttribute, но просматриваемое состояние для присоединенного свойства особенно важно для сведений о свойствах для языка XAML, так как присоединенное свойство является главным образом понятием XAML.

Если этот атрибут .NET Framework применяется к методу доступа для присоединенного свойства, этот атрибут .NET Framework указывает, что присоединенное свойство можно просматривать, если владелец присоединенного свойства является родительским элементом других элементов.

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

Как правило, функции параллельного просмотра состояния. Например, Canvas.Left можно просматривать элементы, которые являются дочерними элементами объекта Canvas, так как Canvas включает код для проверки любых наборов значений дочерних Canvas.Left элементов.

Этот атрибут .NET Framework поддерживает два типа режимов обнаружения деревьев для родительских позиций элементов: мелкого режима и глубокого режима. Неглубокий режим, который является режимом по умолчанию для примененного атрибута AttachedPropertyBrowsableForChildrenAttribute .NET Framework, требует, чтобы непосредственный родительский элемент был типом владельца свойства, чтобы присоединенное свойство было доступно для просмотра. Глубокий режим объявляется путем применения атрибута как IncludeDescendantstrue. Глубокий режим менее строгий, так как он требует только того, чтобы тип владельца был где-то в направлении предка логического дерева, и поэтому присоединенное свойство можно просматривать во всех дочерних элементах, а не только непосредственных дочерних элементов. Глубокий режим применяется для использования присоединенных свойств, где промежуточные элементы в логическом дереве не должны сообщаться как истинный родительский элемент. Неявные коллекции (например, UIElementCollection, неявные в Children объекта Panel) не считаются родительскими элементами в целях объявления этого атрибута .NET Framework режима обнаружения дерева.

Этот атрибут .NET Framework должен применяться только к методу доступа к определениям присоединенных свойств. Не применяйте этот атрибут .NET Framework к набору доступа. Хотя интуитивно это операция набора, которая выполняется в режиме просмотра для XAML на дочерних элементах, это присутствие и характеристики метода доступа к родительскому элементу, который управляет истинным поведением.

Может ли присоединенное свойство просматривать дочерний элемент не является абсолютной гарантией того, что значение присоединенного свойства действительно обрабатывается родительским элементом каким-то образом. Кроме того, значение не является абсолютной гарантией того, IncludeDescendants что область обработки не выходит за пределы непосредственного родительского элемента. Все это является конкретной реализацией. Однако этот атрибут .NET Framework для создания отчетов о состоянии просмотра является лучшим механизмом для создания отчетов об использовании сведений об использовании и функциональных данных для присоединенного свойства. Поэтому обычно можно предположить, что просмотренное состояние присоединенного свойства аналогично поведению того, как присоединенное значение свойства в дочернем элементе обрабатывается или интерпретируется соответствующим родительским элементом в коде приложения.

Общие сведения об объявлении присоединенных свойств см. в разделе "Общие сведения о присоединенных свойствах".

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

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

Конструкторы

Имя.	Описание
AttachedPropertyBrowsableForChildrenAttribute()	Инициализирует новый экземпляр класса AttachedPropertyBrowsableForChildrenAttribute.

Свойства

Имя.	Описание
IncludeDescendants	Возвращает или задает значение, указывающее, следует ли использовать глубокий режим для обнаружения родительских элементов в присоединенном свойстве, где применяется этот атрибут .NET Framework.

Методы

Имя.	Описание
Equals(Object)	Определяет, равен ли текущий атрибут AttachedPropertyBrowsableForChildrenAttribute .NET Framework указанному объекту.
GetHashCode()	Возвращает хэш-код для этого атрибута AttachedPropertyBrowsableForChildrenAttribute .NET Framework.

См. также

• System.Windows.Markup