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

備註

這個.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 來宣告。 深層模式較不嚴格，因為它只需要將擁有者類型放在邏輯樹狀結構的上階方向某處，因此附加屬性在所有子項目上都可以流覽，而不只是立即子項目。 深層模式會套用至附加屬性使用方式，其中邏輯樹狀結構中的交錯專案不應回報為真正的父元素。 例如，隱含集合 (，) 中的 Children Panel 隱含集合不會被視為父元素， UIElementCollection 因此此.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)	將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承來源 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