LaunchActivatedEventArgs 類別

定義

命名空間:

Windows.ApplicationModel.Activation

提供應用程式啟動時的事件資訊。

JAVAscript 此類型會顯示為 WebUILaunchActivatedEventArgs。

public 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 : 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 : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider

Public NotInheritable Class LaunchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider

繼承

Object Platform::Object IInspectable LaunchActivatedEventArgs

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

實作

IActivatedEventArgs IApplicationViewActivatedEventArgs ILaunchActivatedEventArgs IPrelaunchActivatedEventArgs IViewSwitcherProvider IActivatedEventArgsWithUser ILaunchActivatedEventArgs2

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

備註

當您在ActivationKind為Launch時回應Activated事件時，就會存取此物件。

使用 C++、C# 或 Visual Basic 的 UWP 應用程式通常會藉由覆寫 Application 物件的方法來實作啟用點。 預設範本 app.xaml 程式碼後置檔案一律包含 OnLaunched的覆寫。 預設實作包括透過 SuspensionManager 協助程式類別的初始導覽支援和狀態管理。

啟用案例所涉及的所有 應用程式 覆寫都應該在其實作中呼叫 Window.Activate 。

如果啟動期間的工作可能會大幅增加啟動應用程式所需的時間，請避免在啟動期間執行工作。 相反地，您可以藉由接聽 SplashScreen.Dismissed 事件來觸發其他載入工作。

啟用延遲物件不應該用來在啟用期間完成複雜的工作。 啟用期間發生的任何未處理錯誤或例外狀況， (包括延後啟用) 會導致應用程式當機。 如果您需要在啟用期間執行網路呼叫或處理一些額外的檔案，請考慮將您的應用程式啟動至延長式啟動顯示畫面，然後執行這些作業。 如需詳細資訊，請參閱 如何顯示延長時間的啟動顯示畫面。

重要

系統可能會終止需要過多時間啟動的應用程式。

測試您的應用程式時，請注意，如果仍然顯示啟動顯示畫面，立即重新開機剛終止的應用程式將會導致啟用失敗。

JavaScript 啟動完成

如果使用 JavaScript 進行程式設計，當您啟動的事件處理常式在執行啟動工作之後成功傳回時，就會完成啟動。

.NET 啟動完成

如果使用 C#、VB 或 C++ 進行程式設計，當您啟動應用程式視窗時，就會完成啟動。

版本歷程記錄

Windows 版本	SDK 版本	新增值
1607	14393	TileActivatedInfo
1607	14393	User

屬性

Arguments	取得在其啟動啟用期間傳遞至應用程式的引數。
CurrentlyShownApplicationViewId	取得目前顯示之應用程式檢視的識別碼。
Kind	取得啟動此應用程式的原因。
PrelaunchActivated	指出應用程式是否已預先啟動。
PreviousExecutionState	取得此啟用之前的應用程式執行狀態。
SplashScreen	取得啟動顯示畫面物件，該物件提供從啟動顯示畫面轉換到啟動之應用程式的相關資訊。
TileActivatedInfo	取得使用者從磚啟動應用程式時所提供的其他資訊。 如果應用程式未從其磚啟動，或應用程式是在不支援此屬性的平臺上啟動，則這會是 Null 。
TileId	取得叫用以啟動應用程式的圖格識別碼。
User	取得應用程式已啟用的使用者。
ViewSwitcher	取得檢視切換器物件，可讓您設定應用程式的檢視。

另請參閱

• Activated
• Application
• OnLaunched(LaunchActivatedEventArgs)
• 處理應用程式啟用