信息
您所需的主题如下所示。但此主题未包含在此库中。

LauncherOptions.PreferredApplicationPackageFamilyName | preferredApplicationPackageFamilyName Property

获取或设置表示没有处理文件类型或 URI 的应用程序时,用户应安装的应用程序在存储区中的包系列名称的值。

语法


var preferredApplicationPackageFamilyName = launcherOptions.preferredApplicationPackageFamilyName;
launcherOptions.preferredApplicationPackageFamilyName = preferredApplicationPackageFamilyName;

属性值

类型: String [JavaScript] | System.String [.NET] | Platform::String [C++]

应用程序的包系列名称。

备注

在某些情况下,用户可能没有安装用于处理您正启动的文件的应用程序。默认情况下,Windows 会通过在商店为用户提供搜索相应应用程序的链接处理这些情况。与 LauncherOptions.preferredApplicationPackageFamilyName 一起使用 LauncherOptions.PreferredApplicationDisplayName 提供用户在它们能够获取处理文件的 Windows 存储的应用程序。使用的显示名称应对应于 Windows Store 中应用程序的显示名称。

必须设置这两个首选应用程序的属性来建议应用程序。只设置其中一个将会出现错误。

注意  因为仅可使用一个回退,您不能同时设置首选应用程序的属性和回退 URI。如果设置两个回退,启动器 API 将失败。

Windows Phone 8

此 API 不实现,但是调用时会引发异常。请参见 Windows Phone 运行时 API

示例

通过设置为 Windows Store 中的应用程序的显示名称的 preferredApplicationDisplayName 和设置为 Windows Store 中的应用程序的包系列名称的 preferredApplicationPackageFamilyName 调用 Launcher.LaunchFileAsync(IStorageFile, LauncherOptions) | launchFileAsync(IStorageFile, LauncherOptions) 方法。


// Path to the file in the app package to launch
var imageFile = "images\\test.png";

// Get the image file from the package's image directory
Windows.ApplicationModel.Package.current.installedLocation.getFileAsync(imageFile).then(
  function (file) {
    // Set the recommended app
    var options = new Windows.System.LauncherOptions();
    options.preferredApplicationPackageFamilyName = “Contoso.FileApp_8wknc82po1e”;
    options.preferredApplicationDisplayName = “Contoso File App”;


    // Launch the retrieved file pass in the recommended app 
    // in case the user has no apps installed to handle the file
    Windows.System.Launcher.launchFileAsync(file, options).then(
      function (success) {
        if (success) {
            // File launched
        } else {
            // File launch failed
        }
      });
  });


要求

最低支持客户端

Windows 8

最低支持服务器

Windows Server 2012

最低支持电话

Windows Phone 8 [未实现,请参见备注]

命名空间

Windows.System
Windows::System [C++]

元数据

Windows.winmd

另请参见

LauncherOptions
示例
关联启动示例
任务
如何启动文件的默认应用程序 (JavaScript)
如何启动文件的默认应用程序 (C#/VB/C++)
如何启动 URI 的默认应用程序 (JavaScript)
如何启动 URI 的默认应用程序 (C#/VB/C++)
准则
文件类型和 URI 的指南和检查表
引用
Launcher.LaunchFileAsync(IStorageFile, LauncherOptions)
Launcher.LaunchUriAsync(Uri, LauncherOptions)

 

 

显示: