WebUIApplication.BackgroundActivated Événement

Définition

Espace de noms:

Windows.UI.WebUI

Appelé lorsque l’application est activée en arrière-plan.

public:
 static event BackgroundActivatedEventHandler ^ BackgroundActivated;

// Register
static event_token BackgroundActivated(BackgroundActivatedEventHandler const& handler) const;

// Revoke with event_token
static void BackgroundActivated(event_token const* cookie) const;

// Revoke with event_revoker
static WebUIApplication::BackgroundActivated_revoker BackgroundActivated(auto_revoke_t, BackgroundActivatedEventHandler const& handler) const;

public static event BackgroundActivatedEventHandler BackgroundActivated;

function onBackgroundActivated(eventArgs) { /* Your code */ }
Windows.UI.WebUI.WebUIApplication.addEventListener("backgroundactivated", onBackgroundActivated);
Windows.UI.WebUI.WebUIApplication.removeEventListener("backgroundactivated", onBackgroundActivated);
- or -
Windows.UI.WebUI.WebUIApplication.onbackgroundactivated = onBackgroundActivated;

Public Shared Custom Event BackgroundActivated As BackgroundActivatedEventHandler 

Type d'événement

BackgroundActivatedEventHandler

Configuration requise pour Windows

Famille d’appareils	Windows 10, version 1809 (introduit dans 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v7.0)

Remarques

BackgroundActivated est une tâche en arrière-plan UWP spéciale qui s’exécute en tant que gestionnaire sur le thread d’affichage (ou le script d’arrière-plan, voir ci-dessous). Contrairement à une tâche en arrière-plan normale s’exécutant sur un thread de travail, cela permet d’accéder au DOM et de faire référence aux vues de premier plan.

Cet événement est l’équivalent de l’application web de l’événement Windows.UI.Xaml Application.OnBackgroundActivated . Dans le cas spécifique de l’application web, s’il n’y a pas de thread d’affichage en cours d’exécution (l’application n’est pas en cours d’exécution), l’événement active le script d’arrière-plan de l’application et s’y déclenche.

Comme pour XAML, pour désigner un script d’arrière-plan comme activation en arrière-plan, un null taskEntryPoint est fourni à BackgroundTaskBuilder. Cette tâche en arrière-plan est inscrite par programmation (plutôt que déclarée dans l’appxmanifest) :

let builder = new Windows.ApplicationModel.Background.BackgroundTaskBuilder();
builder.name = 'WwaHostBGActivated';
builder.setTrigger(new background.SystemTrigger(background.SystemTriggerType.timeZoneChange, false));
let backgroundTaskRegistration = builder.register();