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	获取为启动应用而调用的磁贴的 ID。
User	获取为其激活应用的用户。
ViewSwitcher	获取可用于设置应用程序的视图的视图切换器对象。

另请参阅

• Activated
• Application
• OnLaunched(LaunchActivatedEventArgs)
• 处理应用激活