Application Classe

Definição

Classe que representa um aplicativo móvel multiplataforma.

public ref class Application : Microsoft::Maui::Controls::Element, Microsoft::Maui::Controls::IApplicationController, Microsoft::Maui::Controls::IElementConfiguration<Microsoft::Maui::Controls::Application ^>, Microsoft::Maui::IApplication, Microsoft::Maui::IVisualTreeElement
public class Application : Microsoft.Maui.Controls.Element, Microsoft.Maui.Controls.IApplicationController, Microsoft.Maui.Controls.IElementConfiguration<Microsoft.Maui.Controls.Application>, Microsoft.Maui.IApplication, Microsoft.Maui.IVisualTreeElement
type Application = class
    inherit Element
    interface IApplicationController
    interface IElementConfiguration<Application>
    interface IVisualTreeElement
    interface IApplication
    interface IElement
Public Class Application
Inherits Element
Implements IApplication, IApplicationController, IElementConfiguration(Of Application), IVisualTreeElement
Herança
Implementações

Comentários

A Application classe é o núcleo de um aplicativo Microsoft.Maui.Controls. Ele define a página raiz do aplicativo, persiste dados de tipo primitivo entre invocações do aplicativo no Properties dicionário e fornece eventos para responder a push e estouro de exibições modais. O Visual Studio cria essa classe para o desenvolvedor no projeto apropriado em uma nova solução Microsoft.Maui.Controls.

Tanto o Visual Studio para Mac quanto o Visual Studio criam um arquivo XAML e code-behind para o aplicativo quando o desenvolvedor cria uma nova solução Microsoft.Maui.Controls. O exemplo a seguir mostra uma classe típica Application , com uma entrada em seu dicionário de recursos.

<Application xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="App1.App">
<Application.Resources>
<Color x:Key="ButtonBackgroundColor">Red</Color>
</Application.Resources>
</Application>
public partial class App : Application
{
    public App()
    {
        InitializeComponent();

        MainPage = new MainPage();
    }

    protected override void OnStart()
    {
        // Handle when your app starts
    }

    protected override void OnSleep()
    {
        // Handle when your app sleeps
    }

    protected override void OnResume()
    {
        // Handle when your app resumes
    }
}

Construtores

Application()

Inicializa uma nova instância Application.

Campos

ControlsApplicationMapper
Obsoleto.

Classe que representa um aplicativo móvel multiplataforma.

Propriedades

AccentColor

Classe que representa um aplicativo móvel multiplataforma.

AppLinks

Obtém o objeto que os desenvolvedores usam para registrar ou cancelar o registro de links do aplicativo.

AutomationId

Obtém ou define um valor que permite à estrutura de automação encontrar e interagir com esse elemento.

(Herdado de Element)
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.

(Herdado de Element)
Current

Obtém o aplicativo atual.

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.

(Herdado de Element)
Effects

Obtém ou define os estilos e propriedades que serão aplicados ao elemento durante o runtime.

(Herdado de Element)
Handler

Obtém ou define o manipulador associado para esse elemento.

(Herdado de Element)
Id

Obtém um valor que pode ser usado para identificar exclusivamente um elemento durante toda a execução do aplicativo.

(Herdado de Element)
LogicalChildren
Obsoleto.

Para uso interno pela plataforma Microsoft.Maui.Controls.

(Herdado de Element)
MainPage

Obtém ou define a página raiz do aplicativo.

NavigationProxy

Para uso interno pela plataforma Microsoft.Maui.Controls.

Parent

Obtém ou define o pai Element desse elemento.

(Herdado de Element)
PlatformAppTheme

Classe que representa um aplicativo móvel multiplataforma.

Properties
Obsoleto.

Obtém um dicionário de propriedades persistentes para este objeto Application.

RealParent

Para uso interno pelo .NET MAUI.

(Herdado de Element)
RequestedTheme

Classe que representa um aplicativo móvel multiplataforma.

Resources

Obtém ou define o dicionário de recursos para este objeto Application.

StyleId

Obtém ou define um valor definido pelo usuário para identificar exclusivamente o elemento.

(Herdado de Element)
UserAppTheme

Classe que representa um aplicativo móvel multiplataforma.

Windows

Classe que representa um aplicativo móvel multiplataforma.

Métodos

AddLogicalChild(Element)

Adiciona um Element aos filhos lógicos.

(Herdado de Element)
ApplyBindings()

Aplica todas as associações atuais a BindingContext.

(Herdado de BindableObject)
CleanUp()

Classe que representa um aplicativo móvel multiplataforma.

ClearLogicalChildren()

Remove todos os filhos Element.

(Herdado de 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)
CloseWindow(Window)

Classe que representa um aplicativo móvel multiplataforma.

CoerceValue(BindableProperty)

Coagi o valor da propriedade associável especificada. Isso é feito invocando BindableProperty.CoerceValueDelegate a propriedade associável especificada.

(Herdado de BindableObject)
CoerceValue(BindablePropertyKey)

Coagi o valor da propriedade associável especificada. Isso é feito invocando BindableProperty.CoerceValueDelegate a propriedade associável especificada.

(Herdado de BindableObject)
CreateWindow(IActivationState)

Classe que representa um aplicativo móvel multiplataforma.

EffectIsAttached(String)

Para uso interno pelo .NET MAUI.

(Herdado de Element)
FindByName(String)

Retorna o elemento que tem o nome especificado.

(Herdado de Element)
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.

(Herdado de Element)
IsSet(BindableProperty)

Determina se existe ou não uma propriedade associável e tem um valor definido.

(Herdado de BindableObject)
On<T>()

Retorna a instância específica da plataforma desse TElement, em que um método específico de plataforma pode ser chamado.

OnAppLinkRequestReceived(Uri)

Classe que representa um aplicativo móvel multiplataforma.

OnBindingContextChanged()

Invocado sempre que o contexto de associação do elemento muda. Implemente esse método para adicionar tratamento de classe a esse evento.

(Herdado de Element)
OnChildAdded(Element)

Aciona o evento ChildAdded. Implemente esse método para adicionar tratamento de classe a esse evento.

(Herdado de Element)
OnChildRemoved(Element, Int32)

Aciona o evento ChildRemoved. Implementar esse método para adicionar tratamento de classe para este evento

(Herdado de Element)
OnHandlerChanged()

Quando substituído em uma classe derivada, deve gerar o HandlerChanged evento.

(Herdado de Element)
OnHandlerChanging(HandlerChangingEventArgs)

Quando substituído em uma classe derivada, deve gerar o HandlerChanging evento.

(Herdado de Element)
OnParentChanged()

Quando substituído em uma classe derivada, deve gerar o ParentChanged evento.

(Herdado de Element)
OnParentChanging(ParentChangingEventArgs)

Quando substituído em uma classe derivada, deve gerar o ParentChanging evento.

(Herdado de Element)
OnParentSet()

Classe que representa um aplicativo móvel multiplataforma.

OnPropertyChanged(String)

Método chamado quando uma propriedade associada é alterada.

(Herdado de Element)
OnPropertyChanging(String)

Aciona o evento PropertyChanging.

(Herdado de BindableObject)
OnResume()

Classe que representa um aplicativo móvel multiplataforma.

OnSleep()

Classe que representa um aplicativo móvel multiplataforma.

OnStart()

Classe que representa um aplicativo móvel multiplataforma.

OpenWindow(Window)

Classe que representa um aplicativo móvel multiplataforma.

Quit()

Sai do aplicativo.

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.

(Herdado de Element)
RemoveLogicalChild(Element)

Remove a primeira ocorrência de um específico Element dos filhos lógicos.

(Herdado de Element)
SavePropertiesAsync()
Obsoleto.

Persiste de maneira assíncrona o dicionário Properties para o objeto de aplicativo.

SendOnAppLinkRequestReceived(Uri)

Para uso interno pela plataforma Microsoft.Maui.Controls.

SetAppIndexingProvider(IAppIndexingProvider)

Para uso interno pela plataforma Microsoft.Maui.Controls.

SetBinding(BindableProperty, BindingBase)

Atribui uma associação a uma propriedade associável.

(Herdado de BindableObject)
SetCurrentApplication(Application)

Para uso interno pela plataforma Microsoft.Maui.Controls.

SetDynamicResource(BindableProperty, String)

Define a BindableProperty propriedade desse elemento a ser atualizada por meio do DynamicResource com a chave fornecida.

(Herdado de Element)
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.

(Herdado de Element)
SetValueFromRenderer(BindablePropertyKey, Object)

Para uso interno pelo .NET MAUI.

(Herdado de Element)
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 .

(Herdado de Element)
ChildRemoved

Gerado sempre que um elemento filho é removido do elemento .

(Herdado de Element)
DescendantAdded

Gerado sempre que um elemento filho é adicionado à subárvore do elemento.

(Herdado de Element)
DescendantRemoved

Gerado sempre que um elemento filho é removido da subárvore de elementos.

(Herdado de Element)
HandlerChanged

Gerado sempre que o manipulador do elemento for alterado.

(Herdado de Element)
HandlerChanging

Gerado sempre que o manipulador do elemento começa a ser alterado.

(Herdado de Element)
ModalPopped

Classe que representa um aplicativo móvel multiplataforma.

ModalPopping

Classe que representa um aplicativo móvel multiplataforma.

ModalPushed

Classe que representa um aplicativo móvel multiplataforma.

ModalPushing

Classe que representa um aplicativo móvel multiplataforma.

PageAppearing

Classe que representa um aplicativo móvel multiplataforma.

PageDisappearing

Classe que representa um aplicativo móvel multiplataforma.

ParentChanged

Gerado sempre que o pai do elemento for alterado.

(Herdado de Element)
ParentChanging

Gerado sempre que o do elemento começa a ser alterado.

(Herdado de Element)
PropertyChanged

Ocorre quando um valor de propriedade é alterado.

(Herdado de BindableObject)
PropertyChanging

Ocorre quando um valor da propriedade está sendo alterado.

(Herdado de BindableObject)
RequestedThemeChanged

Classe que representa um aplicativo móvel multiplataforma.

Implantações explícitas de interface

IApplication.CloseWindow(IWindow)

Classe que representa um aplicativo móvel multiplataforma.

IApplication.CreateWindow(IActivationState)

Classe que representa um aplicativo móvel multiplataforma.

IApplication.OpenWindow(IWindow)

Classe que representa um aplicativo móvel multiplataforma.

IApplication.ThemeChanged()

Classe que representa um aplicativo móvel multiplataforma.

IApplication.Windows

Classe que representa um aplicativo móvel multiplataforma.

IContextFlyoutElement.ContextFlyout

Obtém o ContextFlyout para o 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.

(Herdado de Element)
IDynamicResourceHandler.SetDynamicResource(BindableProperty, String)

Classe que representa um aplicativo móvel multiplataforma.

(Herdado de BindableObject)
IEffectControlProvider.RegisterEffect(Effect)

Classe que representa um aplicativo móvel multiplataforma.

(Herdado de Element)
IElement.Parent

Obtém o pai do elemento .

(Herdado de Element)
IElementController.Descendants()

Para uso interno pelo .NET MAUI.

(Herdado de Element)
IElementController.LogicalChildren

Para uso interno pelo .NET MAUI.

(Herdado de Element)
IElementController.SetValueFromRenderer(BindableProperty, Object)

Para uso interno pelo .NET MAUI.

(Herdado de Element)
INameScope.RegisterName(String, Object)

Para uso interno pelo .NET MAUI.

(Herdado de Element)
INameScope.UnregisterName(String)

Para uso interno pelo .NET MAUI.

(Herdado de Element)
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 descansa o ponteiro na exibição.

(Herdado de Element)
IVisualTreeElement.GetVisualChildren()

Classe que representa um aplicativo móvel multiplataforma.

IVisualTreeElement.GetVisualParent()

Obtém o pai visual do elemento.

(Herdado de Element)

Métodos de Extensão

GetPropertyIfSet<T>(BindableObject, BindableProperty, T)

Classe que representa um aplicativo móvel multiplataforma.

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

Classe que representa um aplicativo móvel multiplataforma.

SetAppThemeColor(BindableObject, BindableProperty, Color, Color)

Classe que representa um aplicativo móvel multiplataforma.

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

Cria e aplica uma associação a uma propriedade.

FindByName<T>(Element, String)

Classe que representa um aplicativo móvel multiplataforma.

ToHandler(IElement, IMauiContext)

Classe que representa um aplicativo móvel multiplataforma.

ToPlatform(IElement, IMauiContext)

Classe que representa um aplicativo móvel multiplataforma.

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 e 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 especificadas em unidades de plataforma, não pixels.

Aplica-se a