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.Leftの設定値をチェックするためのコードCanvas含まれているため、ブロウズ可能と指定されます。

この .NET Framework 属性は、親要素の位置に対して、浅いモードとディープ モードの 2 種類のツリー検出モードをサポートします。 適用された AttachedPropertyBrowsableForChildrenAttribute .NET Framework 属性の既定のモードである浅いモードでは、添付プロパティを読み取り可能にするために、直接の親要素がプロパティの所有者型である必要があります。 ディープ モードは、trueとしてIncludeDescendants属性を適用することによって宣言されます。 ディープ モードは、所有者の型が論理ツリーの先祖の方向のどこかに存在する必要があるため、制限が緩くなります。したがって、添付プロパティは、直下の子要素だけでなく、すべての子要素で参照可能です。 ディープ モードは、論理ツリー内の中間要素を真の親要素として報告しない添付プロパティの使用に適用されます。 暗黙的なコレクション (たとえば、Panel の Children で暗黙的な 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)

一連の名前を対応する一連のディスパッチ識別子に割り当てます。

(継承元 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

インターフェイスの型情報を取得するために使用できるオブジェクトの型情報を取得します。

(継承元 Attribute)
_Attribute.GetTypeInfoCount(UInt32)

オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。

(継承元 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

オブジェクトによって公開されるプロパティとメソッドへのアクセスを提供します。

(継承元 Attribute)

適用対象

こちらもご覧ください