AttachedPropertyBrowsableForChildrenAttribute 类

定义

指定附加属性具有扩展至逻辑树中子元素的可浏览范围。

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
继承
AttachedPropertyBrowsableForChildrenAttribute
属性

注解

此.NET Framework属性的说明中使用的术语browsable的含义类似于给定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 Panel 隐式集合不被视为父元素,以便此.NET Framework属性声明树检测模式。

此.NET Framework属性应仅应用于附加属性定义的 get 访问器。 请勿将此.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)

适用于

另请参阅