CoreApplication Classe

  • Referência

Definição

Namespace:
Windows.ApplicationModel.Core
Editar

Permite que os aplicativos manipulem as alterações de estado, gerenciem janelas e se integrem a uma variedade de estruturas de interface do usuário.

public ref class CoreApplication abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreApplication final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class CoreApplication
Public Class CoreApplication
Herança
Object Platform::Object IInspectable CoreApplication
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

O sistema cria esse objeto como um singleton quando executa o aplicativo. Ele é executado como um ASTA (Application Single-Threaded Apartment). Os threads criados a partir do singleton do aplicativo, como o provedor de exibição (visto no exemplo abaixo), devem ser atribuídos como MTAThread (Multi-Threaded Apartment).

Essa API tem suporte apenas em aplicativos Plataforma Universal do Windows, exceto na propriedade Properties, que está sempre disponível.

struct App : implements<App, IFrameworkViewSource, IFrameworkView>
{
public:
    IFrameworkView CreateView()
    {
        return *this;
    }
};

...

int __stdcall wWinMain(HINSTANCE, HINSTANCE, PWSTR, int)
{
    Windows::ApplicationModel::Core::CoreApplication::Run(App());
}

ref class MyFrameworkViewSource : IFrameworkViewSource
{
public:
    virtual IFrameworkView^ CreateView()
    {
        return ref new MyFrameworkView();
    }
};

// ...

[Platform::MTAThread]
int main(Platform::Array<Platform::String^>^)
{
    auto frameworkViewSource = ref new MyFrameworkViewSource();
    Windows::ApplicationModel::Core::CoreApplication::Run(frameworkViewSource);
    return 0;
}

internal class ApplicationSource : IFrameworkViewSource
{
	public virtual IFrameworkView CreateView()
	{
		return new CoreApp();
	}
}

...

[MTAThread]
public static int Main()
{
	var appSource = new ApplicationSource();
	CoreApplication.Run(appSource);
	return 0;
}

Histórico de versão

Versão do Windows Versão do SDK Valor adicionado
1607 14393 BackgroundActivated
1607 14393 EnablePrelaunch
1607 14393 EnteredBackground
1607 14393 LeavingBackground
1.709 16299 RequestRestartAsync
1.709 16299 RequestRestartForUserAsync

Propriedades

Id

Obtém o identificador de aplicativo relativo ao pacote para o processo.
MainView

Obtém a instância main CoreApplicationView para todos os aplicativos em execução que usam essa instância coreApplication.
Properties

Obtém um conjunto de propriedades que as estruturas de aplicativo e interface do usuário podem usar para armazenar informações enquanto o processo está em execução.
Views

Obtém todas as exibições do aplicativo.

Métodos

CreateNewView()

Cria uma nova exibição para o aplicativo.
CreateNewView(IFrameworkViewSource)

Cria uma nova exibição para o aplicativo.
CreateNewView(String, String)

Cria uma nova exibição para o aplicativo.
DecrementApplicationUseCount()

Diminui a contagem total de instâncias de aplicativo em execução que usam essa instância coreApplication .
EnablePrelaunch(Boolean)

Habilite ou desabilite a capacidade do sistema operacional de pré-inicializar seu aplicativo.
Exit()

Desliga o aplicativo.
GetCurrentView()

Obtém a exibição correspondente ao thread atual.
IncrementApplicationUseCount()

Incrementa a contagem total de instâncias de aplicativo em execução que usam essa instância do CoreApplication .
RequestRestartAsync(String)

Reinicie o aplicativo.
RequestRestartForUserAsync(User, String)

Reinicie o aplicativo no contexto de um usuário diferente.
Run(IFrameworkViewSource)

Executa uma fábrica de provedor de exibição externa para obter um provedor de exibição.
RunWithActivationFactories(IGetActivationFactory)

Executa uma fábrica de tipos ativável para obter um tipo ativável externo.

Eventos

BackgroundActivated

Acionado quando seu aplicativo é ativado por um gatilho em segundo plano.
EnteredBackground

Acionado quando o aplicativo entra no estado em execução em segundo plano.
Exiting

Ocorre quando o aplicativo está sendo desligado.
LeavingBackground

Acionado pouco antes da interface do usuário do aplicativo ficar visível.
Resuming

Ocorre quando um aplicativo está retomando.
Suspending

Ocorre quando o aplicativo está sendo suspenso.
UnhandledErrorDetected

Ocorre quando há um erro subjacente que é roteado para a instância CoreApplication , como parte da lógica de tratamento de erros global.

Aplica-se a

Confira também