Element Classe

Definição

Namespace:

Microsoft.Maui.Controls

Assembly:

Microsoft.Maui.Controls.dll

Fornece a classe base para todos os elementos hierárquicos Microsoft.Maui.Controls. Essa classe contém todos os métodos e propriedades necessários para representar um elemento na hierarquia 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

Herança

Object

BindableObject

Element

Derivado

Microsoft.Maui.Controls.Application

Microsoft.Maui.Controls.AppLinkEntry

Microsoft.Maui.Controls.BaseMenuItem

Microsoft.Maui.Controls.Brush

Microsoft.Maui.Controls.Cell

Microsoft.Maui.Controls.FlyoutBase

Microsoft.Maui.Controls.FormattedString

Microsoft.Maui.Controls.GestureElement

Microsoft.Maui.Controls.GestureRecognizer

Microsoft.Maui.Controls.GradientStop

Microsoft.Maui.Controls.ImageSource

Microsoft.Maui.Controls.Maps.MapElement

Microsoft.Maui.Controls.Maps.Pin

Microsoft.Maui.Controls.MenuBar

Microsoft.Maui.Controls.NavigableElement

Microsoft.Maui.Controls.Shadow

Microsoft.Maui.Controls.SwipeItems

Implementações

IEffectControlProvider IElementController INameScope IContextFlyoutElement IElement IToolTipElement IVisualTreeElement

Comentários

Categorias importantes de elementos visuais são indicadas na tabela a seguir:

Classe	Descrição
VisualElement	Um Element que ocupa uma área na tela, tem uma aparência visual e pode obter entrada por toque.
Cell	As células são elementos destinados a serem adicionados a ListView ou TableView.
Page	Um VisualElement que ocupa a maior parte ou toda a tela e contém um único filho.
Layout	Layoutter um único filho do tipo View , enquanto as subclasses Layout têm uma coleção de várias exibições de filhos, incluindo outros layouts.
Controles e especializados View	A parte inferior do diagrama mostra as classes Microsoft.Maui.Controls para controles universalmente disponíveis, como Button e TableView.

Construtores

Element()

Fornece a classe base para todos os elementos hierárquicos Microsoft.Maui.Controls. Essa classe contém todos os métodos e propriedades necessários para representar um elemento na hierarquia Microsoft.Maui.Controls.

Campos

AutomationIdProperty	Propriedade associável para AutomationId.
ClassIdProperty	Propriedade associável para ClassId.
ControlsElementMapper	Obsoleto. Mapeia informações da interface do usuário para implementações específicas da plataforma para serviços de acessibilidade

Propriedades

AutomationId	Obtém ou define um valor que permite à estrutura de automação encontrar e interagir com esse elemento.
BindingContext	Obtém ou define um objeto que contém as propriedades que serão direcionadas pelas propriedades associadas que pertencem a este BindableObject. Esta é uma propriedade associável. (Herdado de BindableObject)
ClassId	Obtém ou define um valor usado para identificar uma coleção de elementos semanticamente semelhantes.
Dispatcher	Obtém o dispatcher que estava disponível quando esse objeto associável foi criado, caso contrário, tenta encontrar o dispatcher disponível mais próximo (provavelmente o da janela/aplicativo). (Herdado de BindableObject)
EffectControlProvider	Para uso interno pelo .NET MAUI.
Effects	Obtém ou define os estilos e as propriedades que serão aplicados ao elemento durante o runtime.
Handler	Obtém ou define o manipulador associado para esse elemento.
Id	Obtém um valor que pode ser usado para identificar exclusivamente um elemento durante toda a execução do aplicativo.
LogicalChildren	Obsoleto. Para uso interno pela plataforma Microsoft.Maui.Controls.
Parent	Obtém ou define o pai Element desse elemento.
RealParent	Para uso interno pelo .NET MAUI.
StyleId	Obtém ou define um valor definido pelo usuário para identificar exclusivamente o elemento.

Métodos

AddLogicalChild(Element)	Adiciona um Element aos filhos lógicos.
ApplyBindings()	Aplica todas as associações atuais a BindingContext. (Herdado de BindableObject)
ClearLogicalChildren()	Remove todos os filhos Element.
ClearValue(BindableProperty)	Limpa qualquer valor definido anteriormente para uma propriedade associável. (Herdado de BindableObject)
ClearValue(BindablePropertyKey)	Limpa qualquer valor definido anteriormente para uma propriedade associável, identificada por sua chave. (Herdado de BindableObject)
CoerceValue(BindableProperty)	Impõe o valor da propriedade associável especificada. Isso é feito invocando BindableProperty.CoerceValueDelegate a propriedade associável especificada. (Herdado de BindableObject)
CoerceValue(BindablePropertyKey)	Impõe o valor da propriedade associável especificada. Isso é feito invocando BindableProperty.CoerceValueDelegate a propriedade associável especificada. (Herdado de BindableObject)
EffectIsAttached(String)	Para uso interno pelo .NET MAUI.
FindByName(String)	Retorna o elemento que tem o nome especificado.
GetValue(BindableProperty)	Retorna o valor contido na propriedade associável fornecida. (Herdado de BindableObject)
InsertLogicalChild(Int32, Element)	Insere um Element para os filhos lógicos no índice especificado.
IsSet(BindableProperty)	Determina se uma propriedade associável existe ou não e tem um valor definido. (Herdado de BindableObject)
MapAutomationPropertiesExcludedWithChildren(IElementHandler, Element)	Mapeia a propriedade abstrata ExcludedWithChildrenProperty para as implementações específicas da plataforma.
MapAutomationPropertiesIsInAccessibleTree(IElementHandler, Element)	Mapeia a propriedade abstrata IsInAccessibleTreeProperty para as implementações específicas da plataforma.
OnBindingContextChanged()	Invocado sempre que o contexto de associação do elemento muda. Implemente esse método para adicionar tratamento de classe a esse evento.
OnChildAdded(Element)	Aciona o evento ChildAdded. Implemente esse método para adicionar tratamento de classe a esse evento.
OnChildRemoved(Element, Int32)	Aciona o evento ChildRemoved. Implementar esse método para adicionar manipulação de classe para este evento
OnHandlerChanged()	Quando substituído em uma classe derivada, deve gerar o HandlerChanged evento .
OnHandlerChanging(HandlerChangingEventArgs)	Quando substituído em uma classe derivada, deve gerar o HandlerChanging evento .
OnParentChanged()	Quando substituído em uma classe derivada, deve gerar o ParentChanged evento .
OnParentChanging(ParentChangingEventArgs)	Quando substituído em uma classe derivada, deve gerar o ParentChanging evento .
OnParentSet()	Aciona o evento (interno). ParentSet Implemente esse método para adicionar o comportamento quando o elemento é adicionado a um pai.
OnPropertyChanged(String)	Método chamado quando uma propriedade associada é alterada.
OnPropertyChanging(String)	Aciona o evento PropertyChanging. (Herdado de BindableObject)
RemoveBinding(BindableProperty)	Remove uma associação definida anteriormente de uma propriedade associável. (Herdado de BindableObject)
RemoveDynamicResource(BindableProperty)	Remove um recurso dinâmico definido anteriormente.
RemoveLogicalChild(Element)	Remove a primeira ocorrência de um específico Element dos filhos lógicos.
SetBinding(BindableProperty, BindingBase)	Atribui uma associação a uma propriedade associável. (Herdado de BindableObject)
SetDynamicResource(BindableProperty, String)	Define a BindableProperty propriedade desse elemento a ser atualizada por meio do DynamicResource com a chave fornecida.
SetValue(BindableProperty, Object)	Define o valor da propriedade associável especificada. (Herdado de BindableObject)
SetValue(BindablePropertyKey, Object)	Define o valor da propriedade associável especificada. (Herdado de BindableObject)
SetValueCore(BindableProperty, Object, SetValueFlags)	Para uso interno pela plataforma Microsoft.Maui.Controls. (Herdado de BindableObject)
SetValueFromRenderer(BindableProperty, Object)	Para uso interno pelo .NET MAUI.
SetValueFromRenderer(BindablePropertyKey, Object)	Para uso interno pelo .NET MAUI.
UnapplyBindings()	Remove todas as associações atuais do contexto atual. (Herdado de BindableObject)

Eventos

BindingContextChanged	Ocorre quando o valor da propriedade BindingContext muda. (Herdado de BindableObject)
ChildAdded	Gerado sempre que um elemento filho é adicionado ao elemento .
ChildRemoved	Gerado sempre que um elemento filho é removido do elemento .
DescendantAdded	Gerado sempre que um elemento filho é adicionado à subárvore do elemento.
DescendantRemoved	Gerado sempre que um elemento filho é removido da subárvore de elementos.
HandlerChanged	Gerado sempre que o manipulador do elemento é alterado.
HandlerChanging	Gerado sempre que o manipulador do elemento começa a ser alterado.
ParentChanged	Gerado sempre que o pai do elemento é alterado.
ParentChanging	Gerado sempre que o do elemento começa a ser alterado.
PropertyChanged	Ocorre quando um valor de propriedade é alterado. (Herdado de BindableObject)
PropertyChanging	Ocorre quando um valor da propriedade está sendo alterado. (Herdado de BindableObject)

Implantações explícitas de interface

IContextFlyoutElement.ContextFlyout	Obtém o ContextFlyout do modo de exibição. Submenus de menu, subitens de submenu de menu e separadores de submenu de menu podem ser adicionados ao submenu de contexto.
IDynamicResourceHandler.SetDynamicResource(BindableProperty, String)	Fornece a classe base para todos os elementos hierárquicos Microsoft.Maui.Controls. Essa classe contém todos os métodos e propriedades necessários para representar um elemento na hierarquia Microsoft.Maui.Controls. (Herdado de BindableObject)
IEffectControlProvider.RegisterEffect(Effect)	Fornece a classe base para todos os elementos hierárquicos Microsoft.Maui.Controls. Essa classe contém todos os métodos e propriedades necessários para representar um elemento na hierarquia Microsoft.Maui.Controls.
IElement.Parent	Obtém o pai do elemento .
IElementController.Descendants()	Para uso interno pelo .NET MAUI.
IElementController.LogicalChildren	Para uso interno pelo .NET MAUI.
IElementController.SetValueFromRenderer(BindableProperty, Object)	Para uso interno pelo .NET MAUI.
INameScope.RegisterName(String, Object)	Para uso interno pelo .NET MAUI.
INameScope.UnregisterName(String)	Para uso interno pelo .NET MAUI.
IToolTipElement.ToolTip	Representa uma pequena janela pop-up retangular que exibe uma breve descrição da finalidade de uma exibição quando o usuário posiciona o ponteiro no modo de exibição.
IVisualTreeElement.GetVisualChildren()	Obtém uma lista somente leitura dos filhos visuais do elemento.
IVisualTreeElement.GetVisualParent()	Obtém o pai visual do elemento.

Métodos de Extensão

GetPropertyIfSet<T>(BindableObject, BindableProperty, T)	Fornece a classe base para todos os elementos hierárquicos Microsoft.Maui.Controls. Essa classe contém todos os métodos e propriedades necessários para representar um elemento na hierarquia Microsoft.Maui.Controls.
SetAppTheme<T>(BindableObject, BindableProperty, T, T)	Fornece a classe base para todos os elementos hierárquicos Microsoft.Maui.Controls. Essa classe contém todos os métodos e propriedades necessários para representar um elemento na hierarquia Microsoft.Maui.Controls.
SetAppThemeColor(BindableObject, BindableProperty, Color, Color)	Fornece a classe base para todos os elementos hierárquicos Microsoft.Maui.Controls. Essa classe contém todos os métodos e propriedades necessários para representar um elemento na hierarquia Microsoft.Maui.Controls.
SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)	Cria e aplica uma associação a uma propriedade.
FindByName<T>(Element, String)	Fornece a classe base para todos os elementos hierárquicos Microsoft.Maui.Controls. Essa classe contém todos os métodos e propriedades necessários para representar um elemento na hierarquia Microsoft.Maui.Controls.
ToHandler(IElement, IMauiContext)	Fornece a classe base para todos os elementos hierárquicos Microsoft.Maui.Controls. Essa classe contém todos os métodos e propriedades necessários para representar um elemento na hierarquia Microsoft.Maui.Controls.
ToPlatform(IElement, IMauiContext)	Fornece a classe base para todos os elementos hierárquicos Microsoft.Maui.Controls. Essa classe contém todos os métodos e propriedades necessários para representar um elemento na hierarquia Microsoft.Maui.Controls.
GetVisualElementWindow(IVisualTreeElement)	Obtém a Janela que contém o Elemento Árvore Visual, se o elemento estiver contido em um.
GetVisualTreeDescendants(IVisualTreeElement)	Obtém toda a hierarquia de descendentes como uma lista de filhos para um determinado elemento de árvore visual.
GetVisualTreeElements(IVisualTreeElement, Point)	Obtém a lista de filhos de um Elemento de Árvore Visual com base em um determinado Ponto.
GetVisualTreeElements(IVisualTreeElement, Rect)	Obtém a lista de filhos de elementos de árvore visual com base em um retângulo.
GetVisualTreeElements(IVisualTreeElement, Double, Double)	Obtém a lista de filhos de elementos de árvore visual com base em um determinado ponto x, y.
GetVisualTreeElements(IVisualTreeElement, Double, Double, Double, Double)	Obtém a lista de filhos de elementos de árvore visual com base em um retângulo definido por suas coordenadas que são especificadas em unidades de plataforma, não pixels.