AttachedPropertyBrowsableForChildrenAttribute Klasa

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Określa, że dołączona właściwość ma zakres przeglądania, który rozszerza się na elementy podrzędne w drzewie logicznym.

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

Dziedziczenie

Object

Attribute

AttachedPropertyBrowsableAttribute

AttachedPropertyBrowsableForChildrenAttribute

Atrybuty

AttributeUsageAttribute

Uwagi

Znaczenie terminu browsable używanego w opisach tego atrybutu .NET Framework jest analogiczne do opisów podanych dla BrowsableAttributeelementu , ale stan przeglądania dołączonej właściwości jest szczególnie istotny dla informacji o właściwości dla języka XAML (Extensible Application Markup Language), ponieważ dołączona właściwość jest przede wszystkim koncepcją XAML.

Gdy ten atrybut .NET Framework jest stosowany do pobierania dostępu do dołączonej właściwości, ten atrybut .NET Framework określa, że dołączona właściwość można przeglądać, gdy dołączony właściciel właściwości jest elementem nadrzędnym innych elementów.

W przypadku interpretacji przez projektanta korzystającego z informacji deskryptora typu projektant powinien dodać tę właściwość jako właściwość do przeglądania do wszystkich elementów podrzędnych w drzewie logicznym na podstawie elementu nadrzędnego z zastosowanym atrybutem .NET Framework.

Ogólnie rzecz biorąc, funkcje równoległe stanu przeglądania. Na przykład Canvas.Left jest wyznaczony do przeglądania elementów, które są elementami Canvaspodrzędnymi elementu , ponieważ Canvas zawiera kod do sprawdzania dowolnych zestawów wartości elementów podrzędnych Canvas.Left .

Ten atrybut .NET Framework obsługuje dwa typy trybów wykrywania drzewa dla pozycji elementów nadrzędnych: tryb płytki i tryb głęboki. Tryb płytki, który jest trybem domyślnym zastosowanego AttachedPropertyBrowsableForChildrenAttribute atrybutu .NET Framework, wymaga, aby bezpośredni element nadrzędny był typem właściciela właściwości w celu przeglądania dołączonej właściwości. Tryb głęboki jest deklarowany przez zastosowanie atrybutu jako IncludeDescendants true. Tryb głęboki jest mniej restrykcyjny, ponieważ wymaga tylko tego, aby typ właściciela był gdzieś w kierunku nadrzędnym drzewa logicznego, a zatem dołączona właściwość można przeglądać na wszystkich elementach podrzędnych, a nie tylko natychmiastowych elementach podrzędnych. Tryb głęboki jest stosowany do dołączonych użycia właściwości, w których interweniowanie elementów w drzewie logicznym nie powinno być zgłaszane jako prawdziwy element nadrzędny. Niejawne kolekcje (na przykład UIElementCollection niejawne w Children obiekcie Panel) nie są uważane za elementy nadrzędne na potrzeby sposobu deklarowania trybu wykrywania drzewa przez ten atrybut .NET Framework.

Ten atrybut .NET Framework należy zastosować tylko w metodzie pobierania dołączonych definicji właściwości. Nie należy stosować tego atrybutu .NET Framework do zestawu dostępu. Chociaż intuicyjnie jest to operacja ustawiana, która jest wykonywana do przeglądania dla języka XAML na elementach podrzędnych, jest to obecność i cechy metody uzyskiwania dostępu do elementu nadrzędnego, który kontroluje prawdziwe zachowanie.

Czy dołączona właściwość można przeglądać w elemecie podrzędnym, nie jest absolutną gwarancją, że dołączona wartość właściwości jest naprawdę przetwarzana przez element nadrzędny w jakiś sposób. IncludeDescendants Ponadto wartość nie jest absolutną gwarancją, że zakres przetwarzania nie wykracza poza bezpośredni element nadrzędny. Wszystko to jest specyficzne dla implementacji. Jednak ten atrybut .NET Framework do raportowania stanu przeglądania jest najlepszym dostępnym mechanizmem raportowania informacji o użyciu i informacji funkcjonalnych dla dołączonej właściwości. W związku z tym zazwyczaj można założyć, że stan przeglądania dołączonej właściwości jest analogiczny do zachowania sposobu przetwarzania lub interpretowania przez odpowiedni element nadrzędny w kodzie aplikacji dołączonej wartości właściwości dla elementu podrzędnego.

Aby uzyskać ogólne informacje na temat deklarowania dołączonych właściwości, zobacz Omówienie dołączonych właściwości.

Użycie tekstu w języku XAML

Elementy członkowskie tego typu nie są zwykle używane w języku XAML.

Konstruktory

AttachedPropertyBrowsableForChildrenAttribute()

Inicjuje nowe wystąpienie klasy AttachedPropertyBrowsableForChildrenAttribute.

Właściwości

IncludeDescendants	Pobiera lub ustawia wartość, która deklaruje, czy używać trybu głębokiego do wykrywania elementów nadrzędnych we dołączonej właściwości, w której jest stosowany ten atrybut .NET Framework.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu . (Odziedziczone po Attribute)

Metody

Equals(Object)	Określa, czy bieżący AttachedPropertyBrowsableForChildrenAttribute atrybut .NET Framework jest równy określonemu obiektowi.
GetHashCode()	Zwraca kod skrótu dla tego AttachedPropertyBrowsableForChildrenAttribute atrybutu .NET Framework.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania. (Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Pobiera informacje o typie dla obiektu, który może służyć do pobierania informacji o typie dla interfejsu. (Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1). (Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt. (Odziedziczone po Attribute)

Zobacz też

• System.Windows.Markup