LaunchActivatedEventArgs 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 informações de evento quando um aplicativo é iniciado.
Javascript Esse tipo aparece como WebUILaunchActivatedEventArgs.
public ref class LaunchActivatedEventArgs sealed : IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProviderpublic 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, IViewSwitcherProviderPublic NotInheritable Class LaunchActivatedEventArgs
Implements IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProviderPublic NotInheritable Class LaunchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider- Herança
- 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. |