AttachedPropertyBrowsableForChildrenAttribute Klass

Definition

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

Arv

Object

Attribute

AttachedPropertyBrowsableAttribute

AttachedPropertyBrowsableForChildrenAttribute

Attribut

AttributeUsageAttribute

Kommentarer

Innebörden av termen browsable som används i beskrivningar för det här .NET Framework-attributet motsvarar beskrivningarna för BrowsableAttribute, men det ögonbrynsbara tillståndet för en bifogad egenskap är särskilt relevant för egenskapsinformation för XAML (Extensible Application Markup Language), eftersom en bifogad egenskap främst är ett XAML-begrepp.

När det här .NET Framework-attributet tillämpas på get-accessorn för en bifogad egenskap anger attributet .NET Framework att en bifogad egenskap kan dåras när den anslutna egenskapsägaren är ett överordnat element i andra element.

När den tolkas av en designer som använder typbeskrivningsinformation bör designern lägga till den här egenskapen som en dåsbar egenskap till alla underordnade element i det logiska trädet, baserat på det överordnade elementet med det här .NET Framework-attributet tillämpat.

I allmänhet är funktionen för det brynbara tillståndet paralleller. Är till exempel Canvas.Left avsedd att brynas på element som är underordnade element i en Canvas, eftersom Canvas innehåller kod för att kontrollera eventuella angivna värden Canvas.Left för på underordnade element.

Det här attributet .NET Framework stöder två typer av trädidentifieringslägen för överordnade elementpositioner: ett grunt läge och ett djupt läge. Det grunda läget, som är standardläget för ett tillämpat AttachedPropertyBrowsableForChildrenAttribute .NET Framework-attribut, kräver att det omedelbara överordnade elementet är egenskapens ägartyp för att den anslutna egenskapen ska vara brynbar. Djupläget deklareras genom att attributet används med IncludeDescendants som true. Det djupa läget är mindre restriktivt eftersom det bara kräver att ägartypen är någonstans i den överordnade riktningen för det logiska trädet, och därför kan den bifogade egenskapen dåsas på alla underordnade element, inte bara omedelbara underordnade element. Det djupa läget används för anslutna egenskapsanvändningar där mellanliggande element i det logiska trädet inte ska rapporteras som det sanna överordnade elementet. Implicita samlingar (till exempel UIElementCollection som är implicita i Children för en Panel) anses inte vara överordnade element för hur det här .NET Framework-attributet deklarerar trädidentifieringsläget.

Det här .NET Framework-attributet bör endast tillämpas på get-åtkomsten för kopplade egenskapsdefinitioner. Använd inte det här .NET Framework-attributet för den angivna åtkomsten. Även om det intuitivt är den uppsättningsåtgärd som görs browsable för XAML på underordnade element, är det närvaron och egenskaperna hos get-accessorn på det överordnade elementet som styr det sanna beteendet.

Om en bifogad egenskap kan dåsas på ett underordnat element är inte en absolut garanti för att det bifogade egenskapsvärdet verkligen bearbetas av det överordnade elementet på något sätt. IncludeDescendants Dessutom är värdet inte en absolut garanti för att bearbetningsomfånget omfattar eller inte sträcker sig utanför det omedelbara överordnade elementet. Allt detta är implementeringsspecifikt. Det här .NET Framework-attributet för rapportering av det brynbara tillståndet är dock den bästa tillgängliga mekanismen för att rapportera användningsinformation och funktionell information för en bifogad egenskap. Därför kan du anta att det brynbara tillståndet för en bifogad egenskap motsvarar beteendet för hur ett kopplat egenskapsvärde på ett underordnat element bearbetas eller tolkas av det relevanta överordnade elementet i programkoden.

Allmän information om hur du deklarerar anslutna egenskaper finns i Översikt över bifogade egenskaper.

XAML-textanvändning

Medlemmar av den här typen används vanligtvis inte i XAML.

Se även

• System.Windows.Markup