AttachedPropertyBrowsableForChildrenAttribute Clase

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Especifica que una propiedad adjunta tiene un ámbito puede examinar que se extiende a los elementos secundarios en el árbol lógico.

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

Herencia

Object

Attribute

AttachedPropertyBrowsableAttribute

AttachedPropertyBrowsableForChildrenAttribute

Atributos

AttributeUsageAttribute

Comentarios

El significado del término browsable como se usa en las descripciones de este atributo .NET Framework es análogo a las descripciones dadas para BrowsableAttribute, pero el estado de exploración de una propiedad adjunta es especialmente relevante para la información de propiedad para el lenguaje XAML (Extensible Application Markup Language), ya que una propiedad adjunta es principalmente un concepto XAML.

Cuando este atributo .NET Framework se aplica al descriptor de acceso get para una propiedad adjunta, este atributo .NET Framework especifica que se puede examinar una propiedad adjunta cuando el propietario de la propiedad adjunta es un elemento primario de otros elementos.

Cuando lo interpreta un diseñador que usa información de descriptor de tipo, el diseñador debe agregar esta propiedad como una propiedad explorable a todos los elementos secundarios del árbol lógico, en función del elemento primario con este atributo de .NET Framework aplicado.

Por lo general, la funcionalidad de paralelismo de estado de exploración. Por ejemplo, Canvas.Left se designa la exploración en elementos que son elementos secundarios de , Canvasporque Canvas incluye código para comprobar los valores establecidos de Canvas.Left en los elementos secundarios.

Este atributo .NET Framework admite dos tipos de modos de detección de árbol para las posiciones de elementos primarios: un modo superficial y un modo profundo. El modo superficial, que es el modo predeterminado para un atributo de .NET Framework aplicado AttachedPropertyBrowsableForChildrenAttribute , requiere que el elemento primario inmediato sea el tipo de propietario de la propiedad para que se pueda examinar la propiedad adjunta. El modo profundo se declara aplicando el atributo con IncludeDescendants como true. El modo profundo es menos restrictivo porque solo requiere que el tipo de propietario esté en algún lugar en la dirección antecesora del árbol lógico y, por lo tanto, la propiedad adjunta se puede examinar en todos los elementos secundarios, no solo en elementos secundarios inmediatos. El modo profundo se aplica a los usos de propiedades adjuntas en los que los elementos intermedios del árbol lógico no deben notificarse como el elemento primario verdadero. Las colecciones implícitas (por ejemplo, la UIElementCollection que está implícita en de Children un Panel) no se consideran elementos primarios con fines de cómo este atributo .NET Framework declara el modo de detección de árbol.

Este atributo .NET Framework solo se debe aplicar en el descriptor de acceso get de las definiciones de propiedad adjuntas. No aplique este atributo .NET Framework al descriptor de acceso set. Aunque intuitivamente es la operación set que se está haciendo que se pueda examinar para XAML en elementos secundarios, es la presencia y las características del descriptor de acceso get en el elemento primario que controla el comportamiento verdadero.

Si una propiedad adjunta se puede examinar en un elemento secundario no es una garantía absoluta de que el elemento primario procese realmente el valor de la propiedad adjunta de alguna manera. Además, el IncludeDescendants valor no es una garantía absoluta de que el ámbito de procesamiento no se extiende más allá del elemento primario inmediato. Todo esto es específico de la implementación. Sin embargo, este atributo .NET Framework para notificar el estado de exploración es el mejor mecanismo disponible para notificar la información de uso y la información funcional de una propiedad adjunta. Por lo tanto, por lo general, puede suponer que el estado de exploración de una propiedad adjunta es análogo al comportamiento de cómo un valor de propiedad adjunta en un elemento secundario se procesa o interpreta mediante el elemento primario correspondiente en el código de la aplicación.

Para obtener información general sobre cómo declarar propiedades adjuntas, vea Información general sobre las propiedades adjuntas.

Uso de texto XAML

Los miembros de este tipo no se suelen usar en XAML.

Constructores

AttachedPropertyBrowsableForChildrenAttribute()

Inicializa una nueva instancia de la clase AttachedPropertyBrowsableForChildrenAttribute.

Propiedades

IncludeDescendants	Obtiene o establece un valor que declara si se va a usar el modo profundo para la detección de elementos primarios en la propiedad adjunta donde se aplica este atributo .NET Framework.
TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)

Métodos

Equals(Object)	Determina si el atributo .NET Framework actual AttachedPropertyBrowsableForChildrenAttribute es igual a un objeto especificado.
GetHashCode()	Devuelve el código hash de este AttachedPropertyBrowsableForChildrenAttribute atributo .NET Framework.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada. (Heredado de Attribute)
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. (Heredado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. (Heredado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1). (Heredado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Proporciona acceso a las propiedades y los métodos expuestos por un objeto. (Heredado de Attribute)

Consulte también

• System.Windows.Markup