Como ativar um aplicativo
Idioma: HTML | XAML

Como ativar um aplicativo (XAML)

[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente]

Saiba como manipular entificar a ativação do seu aplicativo. O exemplo neste tópico substitui o método OnLaunched.

Mapa: Como este tópico está relacionado aos outros? Veja:

Instruções

Etapa 1: Substituir o identificador de início

Quando um aplicativo é ativado, por qualquer motivo, o sistema envia o evento Activated. Para obter uma lista de tipos de ativação, veja a enumeração ActivationKind.

A classe Windows.UI.Xaml.Application define os métodos que você pode substituir para tratar os vários tipos de ativação. Vários dos tipos de ativação têm um método específico que pode ser substituído. Para os outros tipos de ativação, substitua o método OnActivated.

Defina a classe de seu aplicativo.



<Application xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
             x:Class="AppName.App" >

Substitua o método OnLaunched. Esse método é chamado sempre que o usuário inicia o aplicativo. O parâmetro LaunchActivatedEventArgs contém o estado anterior de seu aplicativo e os argumentos de ativação.

Observação  Para aplicativos da Loja do Windows Phone, esse método é chamado cada vez que o usuário inicia o aplicativo do bloco Iniciar ou da lista de aplicativos, mesmo quando o aplicativo está suspenso na memória. No Windows, esse método não é chamado ao iniciar um aplicativo suspenso do bloco Iniciar ou da lista de aplicativos.



using System;
using Windows.ApplicationModel.Activation;
using Windows.UI.Xaml;

namespace AppName
{
   public partial class App
   {
      async protected override void OnLaunched(LaunchActivatedEventArgs args)
      {
         EnsurePageCreatedAndActivate();
      }

      // Creates the MainPage if it isn't already created.  Also activates
      // the window so it takes foreground and input focus.
      private MainPage EnsurePageCreatedAndActivate()
      {
         if (Window.Current.Content == null)
         {
             Window.Current.Content = new MainPage();
         }

         Window.Current.Activate();
         return Window.Current.Content as MainPage;
      }
   }
}

Etapa 2: Restaurar os dados de aplicativo se o aplicativo foi suspenso e depois terminado

Quando o usuário alterna para seu aplicativo terminado, o sistema envia o evento Activated, com Kind definido como Launch e PreviousExecutionState definido como Terminated ou ClosedByUser. O aplicativo deve carregar os dados de aplicativo salvos e atualizar o conteúdo exibido.



async protected override void OnLaunched(LaunchActivatedEventArgs args)
{
   if (args.PreviousExecutionState == ApplicationExecutionState.Terminated ||
       args.PreviousExecutionState == ApplicationExecutionState.ClosedByUser)
   {
      // TODO: Populate the UI with the previously saved application data
   }
   else
   {
      // TODO: Populate the UI with defaults
   }

   EnsurePageCreatedAndActivate();
}

Se o valor de PreviousExecutionState for NotRunning, o aplicativo não pôde salvar os dados de aplicativo com êxito e deve ser reiniciado como se estivesse sendo iniciado pela primeira vez.

Comentários

Observação  

Para aplicativos da Loja do Windows Phone, o evento Resuming sempre é seguido por OnLaunched, mesmo quando seu aplicativo está suspenso e o usuário inicia novamente seu aplicativo de um bloco principal ou da lista de aplicativos. Os aplicativos podem ignorar a inicialização se já houver conteúdo definido na janela atual. Você pode verificar a propriedade do LaunchActivatedEventArgs.TileId para determinar se o aplicativo foi iniciado de um bloco principal ou secundário e, de acordo com essa informação, decidir se deve atualizar ou retomar o aplicativo.

Tópicos relacionados

Tarefas
Como suspender um aplicativo
Como retomar um aplicativo
Conceitual
Ciclo de vida do aplicativo
Diretrizes
Diretrizes para suspensão e reinício de um aplicativo
Referência
Windows.ApplicationModel.Activation
Windows.UI.Xaml.Application

 

 

Mostrar:
© 2017 Microsoft