AttachedPropertyBrowsableForChildrenAttribute Clase

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Especifica que una propiedad adjunta tiene un ámbito explorable que se extiende a los elementos secundarios del á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 descripciones para 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 de marcado extensible de aplicaciones (XAML), 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 una propiedad adjunta se puede examinar 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 .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 , Canvasya Canvas que 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 árboles para las posiciones de elementos primarios: un modo superficial y un modo profundo. El modo superficial, que es el modo predeterminado para un atributo aplicado AttachedPropertyBrowsableForChildrenAttribute .NET Framework, 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 que intervienen en el árbol lógico no deben notificarse como el elemento primario true. Las colecciones implícitas (por ejemplo, el UIElementCollection que está implícito en la Children de un Panel) no se consideran elementos primarios con fines de cómo este atributo de .NET Framework declara el modo de detección de árboles.

Este atributo .NET Framework solo debe aplicarse en el descriptor de acceso get de las definiciones de propiedades adjuntas. No aplique este atributo .NET Framework al descriptor de acceso set. Aunque intuitivamente es la operación set que se está realizando la exploración de 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 informar de la información de uso e información funcional de una propiedad adjunta. Por lo tanto, por lo general, puede suponer que el estado explorable de una propiedad adjunta es análogo al comportamiento de cómo se procesa o interpreta un valor de propiedad adjunta en un elemento secundario o lo interpreta 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

Nombre	Description
AttachedPropertyBrowsableForChildrenAttribute()	Inicializa una nueva instancia de la clase AttachedPropertyBrowsableForChildrenAttribute.

Propiedades

Nombre	Description
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

Nombre	Description
Equals(Object)	Determina si el atributo AttachedPropertyBrowsableForChildrenAttribute .NET Framework actual es igual a un objeto especificado.
GetHashCode()	Devuelve el código hash de este atributo AttachedPropertyBrowsableForChildrenAttribute .NET Framework.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Cuando 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 reemplaza 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 Objectactual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

Nombre	Description
_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)	Recupera la información de tipo de un objeto, que se puede usar para obtener la información de tipo 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 propiedades y métodos expuestos por un objeto . (Heredado de Attribute)

Consulte también

• System.Windows.Markup