Como retomar um aplicativo (HTML)

[ 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 atualizar o conteúdo quando o sistema retoma o seu aplicativo do Tempo de Execução do Windows.

O sistema suspende o aplicativo sempre que o usuário alterna para outro aplicativo ou para a área de trabalho. O sistema retoma o seu aplicativo sempre que o usuário alterna de volta para ele. Quando o sistema retoma o aplicativo, o conteúdo das estruturas de dados e variáveis é o mesmo como era antes do sistema suspender o aplicativo. O sistema restaura o aplicativo exatamente no ponto onde parou, para dar a impressão ao usuário de que ele estava em execução em segundo plano. Entretanto, o aplicativo pode ter sido suspenso durante um período de tempo significativo, assim ele deve atualizar qualquer conteúdo exibido que pode ter mudado enquanto o aplicativo estava suspenso, como feeds de notícias ou local do usuário.

As etapas a seguir mostrarão como se registrar para o evento resuming e usá-lo para atualizar conteúdo inválido após uma suspensão.

Instruções

Etapa 1: Registrar-se para o evento retomar

Registre-se para o evento resuming, que indica que o aplicativo retomou após ser suspenso.

Windows.UI.WebUI.WebUIApplication.addEventListener("resuming", resumingHandler, false);

Etapa 2: Atualizar conteúdo exibido após a suspensão

Quando seu aplicativo recebe o evento resuming, ele tem a oportunidade de atualizar qualquer conteúdo que possa ter se tornado inválido quando o aplicativo estava em suspensão.

function resumingHandler() {
    // TODO: Refresh network data
}

Comentários

Se o seu aplicativo não tiver conteúdo que possa ficar inválido e que possa precisar de atualização, não há necessidade de manipular o evento resuming.

Uma observação quanto à depuração usando o Microsoft Visual Studio: Quando seu aplicativo está anexado ao depurador do Visual Studio, você pode enviar a ele um evento de retomada. Verifique se a barra de ferramentas Localização de Depuração está sendo mostrada e clique no menu suspenso ao lado do ícone Suspender. Escolha Retomar.

Observação  

Para os aplicativos da Loja do Windows Phone, o evento resuming é sempre seguido pelo evento activated, mesmo quando seu aplicativo está suspenso e o usuário reinicia o 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.

Exemplo completo

Veja o Exemplo de ativação e suspensão de aplicativo usando WinJS e o Exemplo de ativação, retomada e suspensão de aplicativo usando WinRT para obter exemplos completos de código que mostram como manipular eventos de ciclo de vida de aplicativo.

Tópicos relacionados

Tarefas

Como ativar um aplicativo

Como suspender um aplicativo

Conceitual

Ciclo de vida de aplicativos

Diretrizes

Diretrizes para suspensão e retomada de aplicativos

Referência

Windows.UI.WebUI.WebUIApplication.resuming