Element Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 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). |
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. |
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de