Compartilhar via


Element Classe

Definição

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
Derivado
Implementações

Comentários

Categorias importantes de elementos visuais são anotadas 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 de toque.
Cell As células são elementos destinados a serem adicionados a ListView ou TableView.
Page A VisualElement que ocupa a maior parte ou toda a tela e contém um único filho.
Layout Layout têm um único filho do tipo View, enquanto as subclasses de Layout têm uma coleção de várias visualizações de filhos, incluindo outros layouts.
Controles e especializados ViewA 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 propriedades que serão aplicados ao elemento durante o tempo de execução.

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 a execução do aplicativo.

LogicalChildren
Obsoleto.

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.

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 Elements.

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)

Força-se o valor da propriedade associável especificada. Isso é feito invocando BindableProperty.CoerceValueDelegate a propriedade associável especificada.

(Herdado de BindableObject)
CoerceValue(BindablePropertyKey)

Força-se 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 existe ou não uma propriedade associável e tem um conjunto de valores.

(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. Implemente esse método para adicionar manipulação de classe para esse 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()

Gera 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)
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 mudar.

ParentChanged

Gerado sempre que o pai do elemento for alterado.

ParentChanging

Levantado sempre que o elemento começa a mudar.

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 para a visualizaçã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)

Registra o especificado effect para este elemento.

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 um modo de exibição quando o usuário posiciona o ponteiro sobre o 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.

SetBinding<TSource,TProperty>(BindableObject, BindableProperty, Func<TSource,TProperty>, BindingMode, IValueConverter, Object, String, Object, Object, Object)

Cria uma associação entre uma propriedade no objeto de origem e uma propriedade no objeto de destino.

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 da árvore visual, se o elemento estiver contido em uma.

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 dos filhos de um elemento de árvore visual com base em um determinado ponto.

GetVisualTreeElements(IVisualTreeElement, Rect)

Obtém uma lista de filhos de elementos de árvore visual com base em um retângulo.

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

Obtém uma 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 em pixels.

GetVisualTreeElements(IVisualTreeElement, Double, Double)

Obtém uma lista de filhos de elementos de árvore visual com base em um determinado ponto x, y.

Aplica-se a