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 применяется к методу доступа get для присоединенного свойства, этот атрибут платформа .NET Framework указывает, что присоединенное свойство доступно для просмотра, если владелец присоединенного свойства является родительским элементом других элементов.

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

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

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

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

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

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

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

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

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

AttachedPropertyBrowsableForChildrenAttribute()

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

Свойства

IncludeDescendants	Возвращает или задает значение, которое объявляет, следует ли использовать глубокий режим для обнаружения родительских элементов в присоединенном свойстве, где применяется этот платформа .NET Framework атрибут.
TypeId	В случае реализации в производном классе возвращает уникальный идентификатор для этого атрибута Attribute. (Унаследовано от Attribute)

Методы

Equals(Object)	Определяет, равен ли текущий AttachedPropertyBrowsableForChildrenAttribute атрибут платформа .NET Framework указанному объекту.
GetHashCode()	Возвращает хэш-код для этого AttachedPropertyBrowsableForChildrenAttribute атрибута платформа .NET Framework.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
IsDefaultAttribute()	При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute)
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Явные реализации интерфейса

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации. (Унаследовано от Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса. (Унаследовано от Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1). (Унаследовано от Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Предоставляет доступ к открытым свойствам и методам объекта. (Унаследовано от Attribute)

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

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

System.Windows.Markup