FileActivatedEventArgs Class

激活应用程序时提供数据,因为它是与文件关联的应用程序。

JavaScript:  此类型显示为 WebUIFileActivatedEventArgs

语法


public sealed class FileActivatedEventArgs : IFileActivatedEventArgs,
    IActivatedEventArgs,
    IFileActivatedEventArgsWithNeighboringFiles,
    IApplicationViewActivatedEventArgs

特性

[MarshalingBehavior(Agile)]
[Version(0x06020000)]

成员

FileActivatedEventArgs类 具有这些类型的成员:

方法

The FileActivatedEventArgs 类 继承这些方法于:Object 类.

属性

FileActivatedEventArgs类 具有这些属性。

属性访问类型说明

CurrentlyShownApplicationViewId

只读Gets the identifier for the currently shown app view.

Files

只读Gets the files for which the app was activated.

Kind

只读Gets the activation type.

NeighboringFilesQuery

只读Gets the neighboring files of the files for which the app was activated.

PreviousExecutionState

只读Gets the execution state of the app before it was activated.

SplashScreen

只读Gets the splash screen object that provides information about the transition from the splash screen to the activated app.

Verb

只读Gets the action associated with the activated file.

 

备注

ActivationKindFile 时,执行事件处理程序以响应 Activated 事件时会访问此对象。

使用 C++、C# 或 Visual Basic 的 Windows 应用商店应用通常通过重写 Application 对象方法实施激活。默认模板的 app.xaml 代码隐藏文件始终包括 OnLaunched 的重写,但是,是否为其他激活点(例如 OnFileActivated)定义重写则由你的应用程序代码决定。

启动方案中涉及的所有 Application 重写应调用其实现的 Window.Activate

请注意,当应用程序因为文件协定而被激活时,必须使用 StorageFile 对象访问数据,该对象通过 Files 属性传递给应用程序。因为您的应用程序可能没有权限到文件的位置,您不应尝试访问文件的路径。

示例

OnFileActivated 事件处理程序(作用于 Application 对象)接收所有文件激活事件。


protected override void OnFileActivated(FileActivatedEventArgs args)
{
       // TODO: Handle file activation

       // The number of files received is args.Files.Size
       // The first file is args.Files[0].Name
}

要求

最低支持客户端

Windows 8 [仅 Windows 应用商店应用程序]

最低支持服务器

Windows Server 2012 [仅 Windows 应用商店应用程序]

命名空间

Windows.ApplicationModel.Activation
Windows::ApplicationModel::Activation [C++]

元数据

Windows.winmd

另请参见

示例
关联启动示例
任务
如何处理文件启动
准则
文件类型和协议的准则和检查表
引用
Windows.Storage
Windows.UI.Core.CoreApplicationView.Activated
Windows.UI.Xaml.Application.OnFileActivated

 

 

显示:
© 2015 Microsoft