Share via


Element Clase

Definición

Proporciona la clase base para todos los elementos jerárquicos Microsoft.Maui.Controls. Esta clase contiene todos los métodos y propiedades necesarios para representar un elemento en la jerarquía Microsoft.Maui.Controls.

public ref class Element abstract : Microsoft::Maui::Controls::BindableObject, Microsoft::Maui::Controls::IEffectControlProvider, Microsoft::Maui::Controls::IElementController, Microsoft::Maui::Controls::Internals::INameScope, Microsoft::Maui::IContextFlyoutElement, Microsoft::Maui::IElement, Microsoft::Maui::IToolTipElement, Microsoft::Maui::IVisualTreeElement
public abstract class Element : Microsoft.Maui.Controls.BindableObject, Microsoft.Maui.Controls.IEffectControlProvider, Microsoft.Maui.Controls.IElementController, Microsoft.Maui.Controls.Internals.INameScope, Microsoft.Maui.IContextFlyoutElement, Microsoft.Maui.IElement, Microsoft.Maui.IToolTipElement, Microsoft.Maui.IVisualTreeElement
type Element = class
    inherit BindableObject
    interface INameScope
    interface IElementController
    interface IVisualTreeElement
    interface IElement
    interface IEffectControlProvider
    interface IToolTipElement
    interface IContextFlyoutElement
Public MustInherit Class Element
Inherits BindableObject
Implements IContextFlyoutElement, IEffectControlProvider, IElement, IElementController, INameScope, IToolTipElement, IVisualTreeElement
Herencia
Derivado
Implementaciones

Comentarios

En la tabla siguiente se indican categorías importantes de elementos visuales:

Clase Descripción
VisualElement Que Element ocupa un área en la pantalla, tiene una apariencia visual y puede obtener la entrada táctil.
Cell Las celdas son elementos diseñados para agregarse a ListView o TableView.
Page Que VisualElement ocupa la mayoría o toda la pantalla y contiene un solo elemento secundario.
Layout Layouttener un único elemento secundario de tipo View , mientras que las subclases de Layout tienen una colección de varias vistas de elementos secundarios, incluidos otros diseños.
Controles y especializados ViewLa parte inferior del diagrama muestra las clases Microsoft.Maui.Controls para los controles disponibles universalmente, como Button y TableView.

Constructores

Element()

Proporciona la clase base para todos los elementos jerárquicos Microsoft.Maui.Controls. Esta clase contiene todos los métodos y propiedades necesarios para representar un elemento en la jerarquía Microsoft.Maui.Controls.

Campos

AutomationIdProperty

Propiedad enlazable para AutomationId.

ClassIdProperty

Propiedad enlazable para ClassId.

ControlsElementMapper
Obsoletos.

Asigna información de la interfaz de usuario a implementaciones específicas de la plataforma para los servicios de accesibilidad

Propiedades

AutomationId

Obtiene o establece un valor que permite que el marco de automatización busque este elemento e interactúe con él.

BindingContext

Obtiene o establece un objeto que contiene las propiedades destinadas a las propiedades enlazadas que pertenecen a este BindableObjectobjeto . Es una propiedad enlazable.

(Heredado de BindableObject)
ClassId

Obtiene o establece un valor que se usa para identificar una colección de elementos similares semánticamente.

Dispatcher

Obtiene el distribuidor que estaba disponible cuando se creó este objeto enlazable; de lo contrario, intenta encontrar el distribuidor disponible más cercano (probablemente el de la ventana o la aplicación).

(Heredado de BindableObject)
EffectControlProvider

Para uso interno de .NET MAUI.

Effects

Obtiene o establece los estilos y propiedades que se aplicarán al elemento durante el tiempo de ejecución.

Handler

Obtiene o establece el controlador asociado para este elemento.

Id

Obtiene un valor que se puede usar para identificar de forma única un elemento a lo largo de la ejecución de la aplicación.

LogicalChildren
Obsoletos.

Para uso interno de la plataforma Microsoft.Maui.Controls.

Parent

Obtiene o establece el elemento primario Element de este elemento.

RealParent

Para uso interno de .NET MAUI.

StyleId

Obtiene o establece un valor definido por el usuario que identifica de forma única el elemento.

Métodos

AddLogicalChild(Element)

Agrega un Element objeto a los elementos secundarios lógicos.

ApplyBindings()

Aplica todos los enlaces actuales a BindingContext.

(Heredado de BindableObject)
ClearLogicalChildren()

Quita todos los Elementelementos secundarios.

ClearValue(BindableProperty)

Borra cualquier valor establecido previamente para una propiedad enlazable.

(Heredado de BindableObject)
ClearValue(BindablePropertyKey)

Borra cualquier valor establecido previamente para una propiedad enlazable, identificada por su clave.

(Heredado de BindableObject)
CoerceValue(BindableProperty)

Convierte el valor de la propiedad enlazable especificada. Esto se hace invocando BindableProperty.CoerceValueDelegate la propiedad enlazable especificada.

(Heredado de BindableObject)
CoerceValue(BindablePropertyKey)

Convierte el valor de la propiedad enlazable especificada. Esto se hace invocando BindableProperty.CoerceValueDelegate la propiedad enlazable especificada.

(Heredado de BindableObject)
EffectIsAttached(String)

Para uso interno de .NET MAUI.

FindByName(String)

Recupera el elemento que tiene el nombre especificado.

GetValue(BindableProperty)

Devuelve el valor contenido en la propiedad enlazable especificada.

(Heredado de BindableObject)
InsertLogicalChild(Int32, Element)

Inserta un objeto Element en los elementos secundarios lógicos en el índice especificado.

IsSet(BindableProperty)

Determina si existe o no una propiedad enlazable y tiene un valor establecido.

(Heredado de BindableObject)
MapAutomationPropertiesExcludedWithChildren(IElementHandler, Element)

Asigna la propiedad abstracta ExcludedWithChildrenProperty a las implementaciones específicas de la plataforma.

MapAutomationPropertiesIsInAccessibleTree(IElementHandler, Element)

Asigna la propiedad abstracta IsInAccessibleTreeProperty a las implementaciones específicas de la plataforma.

OnBindingContextChanged()

Se invoca siempre que el contexto de enlace del elemento cambia. Implemente este método a fin de agregar el control de clases para este evento.

OnChildAdded(Element)

Genera el evento ChildAdded. Implemente este método a fin de agregar el control de clases para este evento.

OnChildRemoved(Element, Int32)

Genera el evento ChildRemoved. Implemente este método para agregar el control de clases para este evento.

OnHandlerChanged()

Cuando se invalida en una clase derivada, debe generar el HandlerChanged evento .

OnHandlerChanging(HandlerChangingEventArgs)

Cuando se invalida en una clase derivada, debe generar el HandlerChanging evento .

OnParentChanged()

Cuando se invalida en una clase derivada, debe generar el ParentChanged evento .

OnParentChanging(ParentChangingEventArgs)

Cuando se invalida en una clase derivada, debe generar el ParentChanging evento .

OnParentSet()

Genera el evento (interno). ParentSet Implemente este método para agregar comportamiento cuando el elemento se agrega a un elemento primario.

OnPropertyChanged(String)

Método al que se llama cuando una propiedad enlazada cambia.

OnPropertyChanging(String)

Genera el evento PropertyChanging.

(Heredado de BindableObject)
RemoveBinding(BindableProperty)

Quita un enlace establecido previamente de una propiedad enlazable.

(Heredado de BindableObject)
RemoveDynamicResource(BindableProperty)

Quita un recurso dinámico establecido anteriormente.

RemoveLogicalChild(Element)

Quita la primera aparición de un elemento específico Element de los elementos secundarios lógicos.

SetBinding(BindableProperty, BindingBase)

Asigna un enlace a una propiedad enlazable.

(Heredado de BindableObject)
SetDynamicResource(BindableProperty, String)

Establece la BindableProperty propiedad de este elemento que se va a actualizar a través de DynamicResource con la clave proporcionada.

SetValue(BindableProperty, Object)

Establece el valor de la propiedad enlazable especificada.

(Heredado de BindableObject)
SetValue(BindablePropertyKey, Object)

Establece el valor de la propiedad enlazable especificada.

(Heredado de BindableObject)
SetValueCore(BindableProperty, Object, SetValueFlags)

Para uso interno de la plataforma Microsoft.Maui.Controls.

(Heredado de BindableObject)
SetValueFromRenderer(BindableProperty, Object)

Para uso interno de .NET MAUI.

SetValueFromRenderer(BindablePropertyKey, Object)

Para uso interno de .NET MAUI.

UnapplyBindings()

Quita todos los enlaces actuales del contexto actual.

(Heredado de BindableObject)

Eventos

BindingContextChanged

Se produce cuando cambia el valor de la propiedad BindingContext.

(Heredado de BindableObject)
ChildAdded

Se genera cada vez que se agrega un elemento secundario al elemento .

ChildRemoved

Se genera cada vez que se quita un elemento secundario del elemento .

DescendantAdded

Se genera cada vez que se agrega un elemento secundario al subárbol del elemento.

DescendantRemoved

Se genera cada vez que se quita un elemento secundario del subárbol de elementos.

HandlerChanged

Se genera cada vez que el controlador del elemento ha cambiado.

HandlerChanging

Se genera cada vez que el controlador del elemento comienza a cambiar.

ParentChanged

Se genera cada vez que el elemento primario ha cambiado.

ParentChanging

Se genera cada vez que el elemento comienza a cambiar.

PropertyChanged

Tiene lugar cuando cambia un valor de propiedad.

(Heredado de BindableObject)
PropertyChanging

Se produce cuando un valor de propiedad está cambiando.

(Heredado de BindableObject)

Implementaciones de interfaz explícitas

IContextFlyoutElement.ContextFlyout

Obtiene para ContextFlyout la vista. Los controles flotantes de menú, los subelementos de menú y los separadores de control flotante de menú se pueden agregar al control flotante contextual.

IDynamicResourceHandler.SetDynamicResource(BindableProperty, String)

Proporciona la clase base para todos los elementos jerárquicos Microsoft.Maui.Controls. Esta clase contiene todos los métodos y propiedades necesarios para representar un elemento en la jerarquía Microsoft.Maui.Controls.

(Heredado de BindableObject)
IEffectControlProvider.RegisterEffect(Effect)

Proporciona la clase base para todos los elementos jerárquicos Microsoft.Maui.Controls. Esta clase contiene todos los métodos y propiedades necesarios para representar un elemento en la jerarquía Microsoft.Maui.Controls.

IElement.Parent

Obtiene el elemento primario del elemento.

IElementController.Descendants()

Para uso interno de .NET MAUI.

IElementController.LogicalChildren

Para uso interno de .NET MAUI.

IElementController.SetValueFromRenderer(BindableProperty, Object)

Para uso interno de .NET MAUI.

INameScope.RegisterName(String, Object)

Para uso interno de .NET MAUI.

INameScope.UnregisterName(String)

Para uso interno de .NET MAUI.

IToolTipElement.ToolTip

Representa una ventana emergente rectangular pequeña que muestra una breve descripción del propósito de una vista cuando el usuario descansa el puntero en la vista.

IVisualTreeElement.GetVisualChildren()

Obtiene una lista de solo lectura de los elementos secundarios visuales del elemento.

IVisualTreeElement.GetVisualParent()

Obtiene el elemento visual primario.

Métodos de extensión

GetPropertyIfSet<T>(BindableObject, BindableProperty, T)

Proporciona la clase base para todos los elementos jerárquicos Microsoft.Maui.Controls. Esta clase contiene todos los métodos y propiedades necesarios para representar un elemento en la jerarquía Microsoft.Maui.Controls.

SetAppTheme<T>(BindableObject, BindableProperty, T, T)

Proporciona la clase base para todos los elementos jerárquicos Microsoft.Maui.Controls. Esta clase contiene todos los métodos y propiedades necesarios para representar un elemento en la jerarquía Microsoft.Maui.Controls.

SetAppThemeColor(BindableObject, BindableProperty, Color, Color)

Proporciona la clase base para todos los elementos jerárquicos Microsoft.Maui.Controls. Esta clase contiene todos los métodos y propiedades necesarios para representar un elemento en la jerarquía Microsoft.Maui.Controls.

SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)

Crea y aplica un enlace a una propiedad.

FindByName<T>(Element, String)

Proporciona la clase base para todos los elementos jerárquicos Microsoft.Maui.Controls. Esta clase contiene todos los métodos y propiedades necesarios para representar un elemento en la jerarquía Microsoft.Maui.Controls.

ToHandler(IElement, IMauiContext)

Proporciona la clase base para todos los elementos jerárquicos Microsoft.Maui.Controls. Esta clase contiene todos los métodos y propiedades necesarios para representar un elemento en la jerarquía Microsoft.Maui.Controls.

ToPlatform(IElement, IMauiContext)

Proporciona la clase base para todos los elementos jerárquicos Microsoft.Maui.Controls. Esta clase contiene todos los métodos y propiedades necesarios para representar un elemento en la jerarquía Microsoft.Maui.Controls.

GetVisualElementWindow(IVisualTreeElement)

Obtiene la ventana que contiene el elemento de árbol visual, si el elemento está contenido dentro de uno.

GetVisualTreeDescendants(IVisualTreeElement)

Obtiene toda la jerarquía de descendientes como una lista de elementos secundarios para un elemento de árbol visual determinado.

GetVisualTreeElements(IVisualTreeElement, Point)

Obtiene la lista de elementos secundarios de un elemento de árbol visual basado en un punto determinado.

GetVisualTreeElements(IVisualTreeElement, Rect)

Obtiene una lista de elementos de árbol visual secundarios basados en un rectángulo.

GetVisualTreeElements(IVisualTreeElement, Double, Double)

Obtiene una lista de elementos de árbol visual secundarios basados en un punto x, y determinado.

GetVisualTreeElements(IVisualTreeElement, Double, Double, Double, Double)

Obtiene una lista de elementos de árbol visual secundarios basados en un rectángulo definido por sus coordenadas que se especifican en unidades de plataforma, no píxeles.

Se aplica a