WebUIApplication.BackgroundActivated 事件

定義

命名空間:

Windows.UI.WebUI

在背景中啟動應用程式時叫用。

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 

事件類型

BackgroundActivatedEventHandler

Windows 需求

裝置系列	Windows 10, version 1809 (已於 10.0.17763.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v7.0 引進)

備註

BackgroundActivated 是特殊的 UWP 背景工作，可在檢視執行緒 (或 背景腳本上以處理常式的形式執行，請參閱下方) 。 不同于在背景工作執行緒上執行的一般背景工作，這會提供 DOM 的存取權，並參考前景檢視。

此事件是相當於 Windows.UI.Xaml Application.OnBackgroundActivated 事件的 Web 應用程式。 具體來說，在 Web 應用程式案例中，如果沒有執行中的檢視執行緒， (應用程式未執行) ，事件將會啟動應用程式 的背景腳本 ，並在該處引發。

與 XAML 類似，若要將背景腳本表示為背景啟用， null 會將 taskEntryPoint 提供給 BackgroundTaskBuilder。 此背景工作會以程式設計方式註冊 (，而不是在 appxmanifest) 中宣告：

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