AttachedPropertyBrowsableForChildrenAttribute Klasse

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Gibt an, dass eine angefügte Eigenschaft einen durchsuchbaren Bereich besitzt, der sich auf untergeordnete Elemente in der logischen Struktur erstreckt.

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

Vererbung

Object

Attribute

AttachedPropertyBrowsableAttribute

AttachedPropertyBrowsableForChildrenAttribute

Attribute

AttributeUsageAttribute

Hinweise

Die Bedeutung des Ausdrucksbrowsable, der in Beschreibungen für dieses .NET Framework-Attribut verwendet wird, ist analog zu den BeschreibungenBrowsableAttribute, die für eine angefügte Eigenschaft angegeben werden, aber der brosierbare Zustand für eine angefügte Eigenschaft ist besonders relevant für Eigenschafteninformationen für Extensible Application Markup Language (XAML), da eine angefügte Eigenschaft in erster Linie ein XAML-Konzept ist.

Wenn dieses .NET Framework-Attribut auf den Get-Accessor für eine angefügte Eigenschaft angewendet wird, gibt dieses .NET Framework-Attribut an, dass eine angefügte Eigenschaft durchbrochen werden kann, wenn der angefügte Eigenschaftenbesitzer ein übergeordnetes Element anderer Elemente ist.

Wenn sie von einem Designer interpretiert wird, der Typdeskriptorinformationen verwendet, sollte der Designer diese Eigenschaft als brosierbare Eigenschaft zu allen untergeordneten Elementen in der logischen Struktur hinzufügen, basierend auf dem übergeordneten Element mit diesem .NET Framework Attribut angewendet.

Im Allgemeinen wird die funktionell bearbeitbare Zustandsfunktion parallels angezeigt. Beispielsweise Canvas.Left ist für Elemente, die untergeordnete Elemente eines CanvasElements sind, festgelegt, da Canvas Code zum Überprüfen beliebiger Satzwerte von Canvas.Left untergeordneten Elementen enthält.

Dieses .NET Framework-Attribut unterstützt zwei Arten von Baumerkennungsmodi für übergeordnete Elementpositionen: einen flachen Modus und einen tiefen Modus. Der flache Modus, der der Standardmodus für ein angewendetes AttachedPropertyBrowsableForChildrenAttribute .NET Framework-Attribut ist, erfordert, dass das direkte übergeordnete Element der Besitzertyp der Eigenschaft ist, damit die angefügte Eigenschaft durchsucht werden kann. Der Tiefenmodus wird deklariert, indem das Attribut mit IncludeDescendants "as true" angewendet wird. Der Tiefenmodus ist weniger restriktiv, da es nur erforderlich ist, dass der Besitzertyp irgendwo in der Richtung der logischen Struktur liegt, und daher ist die angefügte Eigenschaft auf allen untergeordneten Elementen, nicht nur direkt untergeordnete Elemente, verfügbar. Der Tiefenmodus wird für angefügte Eigenschaftsverwendungen angewendet, bei denen ein Eingreifen von Elementen in der logischen Struktur nicht als true übergeordnetes Element gemeldet werden sollte. Implizite Auflistungen (zUIElementCollection. B. die implizite in einem PanelChildren ) werden nicht als übergeordnete Elemente betrachtet, um zu ermitteln, wie dieses .NET Framework-Attribut den Strukturerkennungsmodus deklariert.

Dieses .NET Framework-Attribut sollte nur auf den Get-Accessor der angefügten Eigenschaftsdefinitionen angewendet werden. Wenden Sie dieses .NET Framework-Attribut nicht auf den Set-Accessor an. Obwohl es intuitiv der festgelegte Vorgang ist, der für XAML auf untergeordneten Elementen zugänglich gemacht wird, ist es die Anwesenheit und Merkmale des Get-Accessors auf dem übergeordneten Element, das das wahre Verhalten steuert.

Ob eine angefügte Eigenschaft auf einem untergeordneten Element browsbar ist, ist keine absolute Garantie, dass der angefügte Eigenschaftswert tatsächlich von dem übergeordneten Element in irgendeiner Weise verarbeitet wird. Außerdem ist der Wert keine absolute Garantie, dass der IncludeDescendants Verarbeitungsbereich über das unmittelbare übergeordnete Element hinausgeht oder nicht erweitert wird. All dies ist implementierungsspezifisch. Dieses .NET Framework-Attribut für das Melden des brosierbaren Zustands ist jedoch der beste verfügbare Mechanismus zum Melden der Nutzungsinformationen und funktionsbezogener Informationen für eine angefügte Eigenschaft. Daher können Sie im Allgemeinen davon ausgehen, dass der beschriftbare Zustand einer angefügten Eigenschaft analog zum Verhalten der Vorgehensweise eines angefügten Eigenschaftswerts auf einem untergeordneten Element verarbeitet oder von dem relevanten übergeordneten Element in Ihrem Anwendungscode interpretiert wird.

Allgemeine Informationen zum Deklarieren angefügter Eigenschaften finden Sie unter Übersicht über angefügte Eigenschaften.

XAML-Textverwendung

Elemente dieses Typs werden in XAML in der Regel nicht verwendet.

Konstruktoren

AttachedPropertyBrowsableForChildrenAttribute()

Initialisiert eine neue Instanz der AttachedPropertyBrowsableForChildrenAttribute-Klasse.

Eigenschaften

IncludeDescendants	Ruft einen Wert ab oder legt einen Wert fest, der deklariert, ob der Tiefenmodus für die Erkennung übergeordneter Elemente auf der angefügten Eigenschaft verwendet wird, bei der dieses .NET Framework-Attribut angewendet wird.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Bestimmt, ob das aktuelle AttachedPropertyBrowsableForChildrenAttribute .NET Framework-Attribut gleich einem angegebenen Objekt entspricht.
GetHashCode()	Gibt den Hashcode für dieses AttachedPropertyBrowsableForChildrenAttribute .NET Framework-Attribut zurück.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Geerbt von Attribute)

Siehe auch

• System.Windows.Markup