Compartilhar via


LaunchActivatedEventArgs Classe

Definição

Fornece informações de evento quando um aplicativo é iniciado.

Javascript Esse tipo aparece como WebUILaunchActivatedEventArgs.

public ref class LaunchActivatedEventArgs sealed : IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
public ref class LaunchActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class LaunchActivatedEventArgs final : IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class LaunchActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class LaunchActivatedEventArgs : IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class LaunchActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
Public NotInheritable Class LaunchActivatedEventArgs
Implements IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
Public NotInheritable Class LaunchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
Herança
Object Platform::Object IInspectable LaunchActivatedEventArgs
Atributos
Implementações

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

Esse objeto é acessado quando você responde a eventos ativados quando ActivationKind é Inicializado.

O aplicativo UWP usando C++, C#ou Visual Basic normalmente implementa pontos de ativação substituindo métodos do objeto Application . Os arquivos code-behind do modelo padrão app.xaml sempre incluem uma substituição para OnLaunched. A implementação padrão inclui suporte de navegação inicial e gerenciamento de estado por meio da classe auxiliar SuspensionManager.

Todas as substituições de aplicativo envolvidas em um cenário de ativação devem chamar Window.Activate em suas implementações.

Evite executar tarefas durante a inicialização se elas puderem aumentar significativamente o tempo necessário para iniciar seu aplicativo. Em vez disso, você pode disparar tarefas de carregamento adicionais escutando o evento SplashScreen.Dismissed .

O objeto de adiamento de ativação não deve ser usado para concluir tarefas complexas durante a ativação. Quaisquer erros sem tratamento ou exceções que ocorram durante a ativação (incluindo ativação adiada) causarão falha no aplicativo. Se você precisar executar chamadas de rede ou processar vários arquivos adicionais durante a ativação, considere iniciar seu aplicativo em uma tela inicial estendida e, em seguida, executar essas operações. Para obter mais informações, consulte Como exibir uma tela inicial por um longo período.

Importante

Os aplicativos que exigem uma quantidade excessiva de tempo para iniciar podem ser encerrados pelo sistema.

Ao testar seu aplicativo, lembre-se de que reativar imediatamente um aplicativo que acabou de ser encerrado resultará em uma ativação com falha se a tela inicial ainda estiver visível.

Conclusão da inicialização do JavaScript

Se a programação com JavaScript for concluída, a inicialização será concluída quando o manipulador de eventos ativado retornar com êxito após a execução das tarefas de inicialização.

Conclusão de inicialização do .NET

Se a programação com C#, VB ou C++, a inicialização for concluída quando você ativar uma janela do aplicativo.

Histórico de versão

Versão do Windows Versão do SDK Valor adicionado
1607 14393 TileActivatedInfo
1607 14393 Usuário

Propriedades

Arguments

Obtém os argumentos que são passados para o aplicativo durante sua ativação de inicialização.

CurrentlyShownApplicationViewId

Obtém o identificador para a exibição de aplicativo mostrada no momento.

Kind

Obtém o motivo pelo qual esse aplicativo está sendo ativado.

PrelaunchActivated

Indica se o aplicativo foi pré-iniciado.

PreviousExecutionState

Obtém o estado de execução do aplicativo antes dessa ativação.

SplashScreen

Obtém o objeto de tela inicial que fornece informações sobre a transição da tela inicial para o aplicativo ativado.

TileActivatedInfo

Obtém informações adicionais fornecidas quando o usuário inicia seu aplicativo de um bloco. Isso será nulo se o aplicativo não for iniciado de seu bloco ou se o aplicativo for iniciado em uma plataforma que não dê suporte a essa propriedade.

TileId

Obtém a ID do bloco que foi invocado para iniciar o aplicativo.

User

Obtém o usuário para o qual o aplicativo foi ativado.

ViewSwitcher

Obtém o objeto do comutador de exibição que permite definir o modo de exibição para o aplicativo.

Aplica-se a

Confira também