AttachedPropertyBrowsableForChildrenAttribute AttachedPropertyBrowsableForChildrenAttribute AttachedPropertyBrowsableForChildrenAttribute AttachedPropertyBrowsableForChildrenAttribute Class

定義

添付プロパティが、論理ツリー内の子要素を拡張するブラウズ可能なスコープを持つことを指定します。Specifies that an attached property has a browsable scope that extends to child elements in the logical tree.

public ref class AttachedPropertyBrowsableForChildrenAttribute sealed : System::Windows::AttachedPropertyBrowsableAttribute
[System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false)]
public sealed class AttachedPropertyBrowsableForChildrenAttribute : System.Windows.AttachedPropertyBrowsableAttribute
type AttachedPropertyBrowsableForChildrenAttribute = class
    inherit AttachedPropertyBrowsableAttribute
Public NotInheritable Class AttachedPropertyBrowsableForChildrenAttribute
Inherits AttachedPropertyBrowsableAttribute
継承
AttachedPropertyBrowsableForChildrenAttributeAttachedPropertyBrowsableForChildrenAttributeAttachedPropertyBrowsableForChildrenAttributeAttachedPropertyBrowsableForChildrenAttribute
属性

注釈

このbrowsable BrowsableAttribute説明で使用される用語の意味は、の説明に似ていますが、添付プロパティの参照可能な状態は、のプロパティ情報に特に関連します。 .NET Framework 属性.NET Framework attribute Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML)添付プロパティは、主XAMLXAMLに概念です。The meaning of the term browsable as used in descriptions for this .NET Framework 属性.NET Framework attribute is analogous to the descriptions given for BrowsableAttribute, but the browsable state for an attached property is particularly relevant to property information for Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML), because an attached property is primarily a XAMLXAML concept.

添付プロパティ.NET Framework 属性.NET Framework attributeの get アクセサーにこのが適用されると.NET Framework 属性.NET Framework attribute 、添付プロパティの所有者が他の要素の親要素である場合に、添付プロパティが参照可能であることを指定します。When this .NET Framework 属性.NET Framework attribute is applied to the get accessor for an attached property, this .NET Framework 属性.NET Framework attribute specifies that an attached property is browsable when the attached property owner is a parent element of other elements.

型記述子情報を使用するデザイナーによって解釈される場合、デザイナーは、このプロパティを参照可能なプロパティとして、この.NET Framework 属性.NET Framework attributeが適用された親要素に基づいて、参照可能なプロパティとして追加する必要があります。When interpreted by a designer that uses type descriptor information, the designer should add this property as a browsable property to all child elements in the logical tree, based on the parent element with this .NET Framework 属性.NET Framework attribute applied.

一般に、参照可能状態は機能に似ています。Generally, the browsable state parallels functionality. たとえば、 Canvas.Leftは、子要素ののCanvas.Leftセット値をチェックするためCanvasのコードCanvasが含まれているため、の子要素では参照可能として指定されます。For example, Canvas.Left is designated browsable on elements that are child elements of a Canvas, because Canvas includes code for checking any set values of Canvas.Left on child elements.

これ.NET Framework 属性.NET Framework attributeにより、親要素の位置に対して、浅いモードとディープモードという2種類のツリー検出モードがサポートされます。This .NET Framework 属性.NET Framework attribute supports two types of tree detection modes for parent element positions: a shallow mode, and a deep mode. 簡易モード (適用さAttachedPropertyBrowsableForChildrenAttribute .NET Framework 属性.NET Framework attributeれるの既定のモード) では、添付プロパティを参照できるようにするために、直接の親要素がプロパティの所有者の種類である必要があります。The shallow mode, which is the default mode for an applied AttachedPropertyBrowsableForChildrenAttribute .NET Framework 属性.NET Framework attribute, requires that the immediate parent element be the owner type of the property in order for the attached property to be browsable. ディープモードは、としIncludeDescendantstrue属性を適用することによって宣言されます。The deep mode is declared by applying the attribute with IncludeDescendants as true. ディープモードでは、所有者の型が論理ツリーの先祖の方向にある必要があるだけなので、アタッチされるプロパティは直接の子要素ではなくすべての子要素で参照可能であるため、あまり制限がありません。The deep mode is less restrictive because it only requires that the owner type be somewhere in the ancestor direction of the logical tree, and therefore the attached property is browsable on all child elements, not just immediate child elements. ディープモードは、添付プロパティの使用に適用されます。論理ツリー内の中間要素は、真の親要素として報告されません。The deep mode is applied for attached property usages where intervening elements in the logical tree should not be reported as the true parent element. 暗黙のコレクション ( UIElementCollectionたとえば、 ChildrenPanelで暗黙的な) は、ツリー検出モードを.NET Framework 属性.NET Framework attribute宣言するための親要素とは見なされません。Implicit collections (for example, the UIElementCollection that is implicit in the Children of a Panel) are not considered to be parent elements for purposes of how this .NET Framework 属性.NET Framework attribute declares the tree detection mode.

これ.NET Framework 属性.NET Framework attributeは、添付プロパティ定義の get アクセサーにのみ適用されます。This .NET Framework 属性.NET Framework attribute should only be applied on the get accessor of attached property definitions. Set アクセサー .NET Framework 属性.NET Framework attributeには適用しないでください。Do not apply this .NET Framework 属性.NET Framework attribute to the set accessor. 直観的に子要素XAMLXAMLで参照できるように設定されている設定操作ですが、実際の動作を制御する親要素の get アクセサーの存在と特性です。Although intuitively it is the set operation that is being made browsable for XAMLXAML on child elements, it is the presence and characteristics of the get accessor on the parent element that controls the true behavior.

添付プロパティが子要素で参照可能であるかどうかは、添付プロパティの値が何らかの形で親要素によって実際に処理されることを保証するものではありません。Whether an attached property is browsable on a child element is not an absolute guarantee that the attached property value is really processed by the parent element in some manner. また、 IncludeDescendants値は、処理スコープが直接の親要素を超えて拡張されないことを保証するものではありません。Also, the IncludeDescendants value is not an absolute guarantee that the processing scope does or does not extend beyond the immediate parent element. これは、実装固有のものです。All this is implementation specific. ただし、これ.NET Framework 属性.NET Framework attributeは、参照可能な状態を報告するための最適なメカニズムであり、添付プロパティの使用状況情報と機能情報を報告するのに最適です。However, this .NET Framework 属性.NET Framework attribute for reporting the browsable state is the best available mechanism for reporting the usage information and functional information for an attached property. したがって、通常、添付プロパティの参照可能な状態は、子要素の添付プロパティ値がアプリケーションコード内の関連する親要素によって処理または解釈される方法の動作に似ていると想定できます。Therefore, you can generally assume that the browsable state of an attached property is analogous to the behavior of how an attached property value on a child element is processed or interpreted by the relevant parent element in your application code.

添付プロパティの宣言に関する一般的な情報については、「添付プロパティの概要」を参照してください。For general information on declaring attached properties, see Attached Properties Overview.

XAML テキストの使用XAML Text Usage

この型のメンバーは、通常、でXAMLXAMLは使用されません。Members of this type are not typically used in XAMLXAML.

コンストラクター

AttachedPropertyBrowsableForChildrenAttribute() AttachedPropertyBrowsableForChildrenAttribute() AttachedPropertyBrowsableForChildrenAttribute() AttachedPropertyBrowsableForChildrenAttribute()

AttachedPropertyBrowsableForChildrenAttribute クラスの新しいインスタンスを初期化します。Initializes a new instance of the AttachedPropertyBrowsableForChildrenAttribute class.

プロパティ

IncludeDescendants IncludeDescendants IncludeDescendants IncludeDescendants

この .NET Framework 属性.NET Framework attribute が適用される添付プロパティで親要素の検出に詳細モードを使用するかどうかを示す値を取得または設定します。Gets or sets a value that declares whether to use the deep mode for detection of parent elements on the attached property where this .NET Framework 属性.NET Framework attribute is applied.

TypeId TypeId TypeId TypeId

派生クラスで実装されると、この Attribute の一意の識別子を取得します。When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

現在の AttachedPropertyBrowsableForChildrenAttribute .NET Framework 属性.NET Framework attribute が、指定したオブジェクトと等しいかどうかを判断します。Determines whether the current AttachedPropertyBrowsableForChildrenAttribute .NET Framework 属性.NET Framework attribute is equal to a specified object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

この AttachedPropertyBrowsableForChildrenAttribute .NET Framework 属性.NET Framework attribute のハッシュ コードを返します。Returns the hash code for this AttachedPropertyBrowsableForChildrenAttribute .NET Framework 属性.NET Framework attribute.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

派生クラスでオーバーライドされるとき、このインスタンスの値が派生クラスの既定値であるかどうかを示します。When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

明示的なインターフェイスの実装

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

一連の名前を対応する一連のディスパッチ識別子に割り当てます。Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

オブジェクトの型情報を取得します。この情報はインターフェイスの型情報の取得に使用できます。Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

適用対象

こちらもご覧ください