LauncherOptions 类

定义

命名空间:

Windows.System

指定用于启动文件或 URI 的默认应用的选项。

在桌面应用中，在以显示 UI 的方式使用此类实例之前，需要将该对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow的 WinRT UI 对象。

public ref class LauncherOptions sealed : ILauncherViewOptions

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class LauncherOptions final : ILauncherViewOptions

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class LauncherOptions : ILauncherViewOptions

function LauncherOptions()

Public NotInheritable Class LauncherOptions
Implements ILauncherViewOptions

继承

Object Platform::Object IInspectable LauncherOptions

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

ILauncherViewOptions

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

请参阅 LaunchUriAsync（Uri， LauncherOptions） 主题中的代码示例。

注解

在某些情况下，调用 Launcher 静态方法来启动与文件类型或 URI 协议关联的应用时，必须通过传递 TargetApplicationPackageFamilyName 属性设置为包含该应用的应用包的包系列名称来准确指定要启动的应用。

有两种情况如下所示：

1. 你想要使用 URI 启动应用，并使用 Launcher.LaunchUriAsync（Uri、LauncherOptions、ValueSet）将额外的输入数据传递给启动的应用。
2. 你想要使用 URI 启动应用，并等待应用使用 launcher.LaunchUriForResultsAsync 的任何重载将输出数据发送回应用。

在这些情况下，调用应用和启动的应用都需要就如何解释从一个应用传递到另一个应用的额外数据达成一致。 调用应用无法启动任何恰好是该 URI 协议的默认值的应用。 在其他情况下，TargetApplicationPackageFamilyName 属性是可选的。

版本历史记录

Windows 版本	SDK 版本	已添加值
1607	14393	IgnoreAppUriHandlers
1703	15063	LimitPickerToCurrentAppAndAppUriHandlers

构造函数

LauncherOptions()

创建和初始化启动器选项对象的新实例。 在桌面应用中，在以显示 UI 的方式使用此类实例之前，需要将该对象与其所有者的窗口句柄相关联。 有关详细信息和代码示例，请参阅 显示依赖于 CoreWindow的 WinRT UI 对象。

属性

ContentType	获取或设置与表示网络上文件的 URI 关联的内容类型。
DesiredRemainingView	启动目标应用并让当前正在运行的源应用保持在屏幕上，方法是与目标应用共享空间相同，或者占用的空间大于或小于目标应用。
DisplayApplicationPicker	获取或设置一个值，该值指示在调用关联启动 API 时是否显示 打开方式 对话框。
FallbackUri	获取或设置一个值，该值表示用户应在浏览器中获取的 URI（如果不存在用于处理文件类型或 URI 的应用）。
IgnoreAppUriHandlers	指示是否忽略可以处理 http（s） 方案的处理程序（如浏览器）。 相反，启动将回退到默认浏览器。
LimitPickerToCurrentAppAndAppUriHandlers	获取或设置是否将启动器选取器限制为当前应用及其关联的 URI 处理程序。
NeighboringFilesQuery	使应用能够访问与用于激活应用的文件相关的文件。
PreferredApplicationDisplayName	获取或设置一个值，该值表示用户在存储中应安装的应用的显示名称（如果没有应用来处理文件类型或 URI）。
PreferredApplicationPackageFamilyName	获取或设置一个值，该值表示应用商店中用户应安装的应用的包系列名称（如果不存在用于处理文件类型或 URI 的应用）。
TargetApplicationPackageFamilyName	应用于启动文件或 URI 的目标包的包系列名称。 在某些情况下，此属性是可选的。 请参阅 备注。
TreatAsUntrusted	获取或设置一个值，该值指示系统在启动与文件或 URI 关联的应用时是否应显示一条警告，指出文件或 URI 可能不安全。
UI	在启动默认应用时获取用户界面（UI）选项。

另请参阅

• LaunchFileAsync(IStorageFile, LauncherOptions)
• LaunchUriAsync(Uri, LauncherOptions)
• 关联启动示例
• 启动文件 的默认应用
• 启动 URI 的默认应用
• 文件类型和 URI 指南