AttachedPropertyBrowsableForChildrenAttribute Klasse

Definition

Namespace:
System.Windows
Assembly:
PresentationFramework.dll

Gibt an, dass eine angefügte Eigenschaft über einen durchbrochenen Bereich verfügt, der auf untergeordnete Elemente in der logischen Struktur erweitert wird.

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 Begriffs browsable, wie in Beschreibungen für dieses .NET Framework-Attribut verwendet wird, entspricht den Beschreibungen für BrowsableAttribute, aber der durchbrochene 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 Besitzer der angefügten Eigenschaft ein übergeordnetes Element anderer Elemente ist.

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

Im Allgemeinen parallele Funktionalität des durchbrochenen Zustands. Beispielsweise ist für Elemente vorgesehen, Canvas.Left die untergeordnete Elemente eines Elements Canvassind, da Canvas Code zum Überprüfen von festgelegten Werten für Canvas.Left untergeordnete Elemente enthalten ist.

Dieses .NET Framework-Attribut unterstützt zwei Typen von Strukturerkennungsmodi 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 durchbrochen werden kann. Der Tiefenmodus wird deklariert, indem das Attribut mit IncludeDescendants "as true" angewendet wird. Der tiefen Modus ist weniger restriktiv, da er nur erfordert, dass der Besitzertyp irgendwo in der Vorgängerrichtung der logischen Struktur liegt und daher die angefügte Eigenschaft für alle untergeordneten Elemente, nicht nur direkte untergeordnete Elemente, durchbrochen werden kann. Der tiefen Modus wird für angefügte Eigenschaftsverwendungen angewendet, bei denen ein Eingreifen von Elementen in der logischen Struktur nicht als das wahre übergeordnete Element gemeldet werden sollte. Implizite Auflistungen (z. B. die UIElementCollection, die im Children eines Panel implizit ist) gelten nicht als übergeordnete Elemente, um zu ermitteln, wie dieses .NET Framework-Attribut den Strukturerkennungsmodus deklariert.

Dieses .NET Framework-Attribut sollte nur auf den Get Accessor von angefügten Eigenschaftsdefinitionen angewendet werden. Wenden Sie dieses .NET Framework-Attribut nicht auf den Set-Accessor an. Obwohl es sich intuitiv um den set-Vorgang handelt, der für XAML für untergeordnete Elemente durchbrochen wird, ist es das Vorhandensein und die Merkmale des Get-Accessors für das übergeordnete Element, das das wahre Verhalten steuert.

Ob eine angefügte Eigenschaft für ein untergeordnetes Element durchbrochen werden kann, ist keine absolute Garantie dafür, dass der Wert der angefügten Eigenschaft tatsächlich vom übergeordneten Element auf irgendeine Weise verarbeitet wird. Außerdem ist der IncludeDescendants Wert keine absolute Garantie dafür, dass der Verarbeitungsbereich über das unmittelbare übergeordnete Element hinausgeht oder nicht erweitert. All dies ist implementierungsspezifisch. Dieses .NET Framework-Attribut zum Melden des durchbrochenen Zustands ist jedoch der beste verfügbare Mechanismus zum Melden der Nutzungsinformationen und funktionalen Informationen für eine angefügte Eigenschaft. Daher können Sie im Allgemeinen davon ausgehen, dass der durchbrochene Zustand einer angefügten Eigenschaft dem Verhalten entspricht, wie ein angefügter Eigenschaftswert für ein untergeordnetes Element vom relevanten übergeordneten Element im Anwendungscode verarbeitet oder interpretiert wird.

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

XAML-Textverwendung

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

Konstruktoren

Name Beschreibung
AttachedPropertyBrowsableForChildrenAttribute()

Initialisiert eine neue Instanz der AttachedPropertyBrowsableForChildrenAttribute-Klasse.

Eigenschaften

Name Beschreibung
IncludeDescendants

Dient zum Abrufen oder Festlegen eines Werts, der deklariert, ob der tiefen Modus für die Erkennung übergeordneter Elemente in der angefügten Eigenschaft verwendet werden soll, auf die dieses .NET Framework-Attribut angewendet wird.
TypeId

Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute.

(Geerbt von Attribute)

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das aktuelle attribut AttachedPropertyBrowsableForChildrenAttribute .NET Framework einem angegebenen Objekt entspricht.
GetHashCode()

Gibt den Hashcode für dieses attribut AttachedPropertyBrowsableForChildrenAttribute .NET Framework zurück.
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
IsDefaultAttribute()

Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist.

(Geerbt von Attribute)
Match(Object)

Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht.

(Geerbt von Attribute)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name Beschreibung
_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 denen 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)

Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden.

(Geerbt von Attribute)

Gilt für:

Weitere Informationen