LaunchActivatedEventArgs Classe

Definição

Namespace:

Windows.ApplicationModel.Activation

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

Javascript Esse tipo aparece como WebUILaunchActivatedEventArgs.

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 : 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 : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider

Public NotInheritable Class LaunchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider

Herança

Object Platform::Object IInspectable LaunchActivatedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

IActivatedEventArgs IApplicationViewActivatedEventArgs ILaunchActivatedEventArgs IPrelaunchActivatedEventArgs IViewSwitcherProvider IActivatedEventArgsWithUser ILaunchActivatedEventArgs2

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.

Confira também

• Activated
• Application
• OnLaunched(LaunchActivatedEventArgs)
• Tratar a ativação do aplicativo