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) 主题中的代码示例。

注解

版本历史记录

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

构造函数

LauncherOptions()

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

属性

ContentType	获取或设置与表示网络上文件的 URI 关联的内容类型。
DesiredRemainingView	启动目标应用，并通过与目标应用平均共享空间或占用比目标应用多或少的空间，使当前运行的源应用保持在屏幕上。
DisplayApplicationPicker	获取或设置一个值，该值指示在调用关联启动 API 时是否显示 “打开方式 ”对话框。
FallbackUri	获取或设置一个值，该值表示在不存在用于处理文件类型或 URI 的应用时用户应在浏览器中转到的 URI。
IgnoreAppUriHandlers	指示是否忽略可以处理 http () 方案 (（例如浏览器) ）的处理程序。 相反，启动将回退到默认浏览器。
LimitPickerToCurrentAppAndAppUriHandlers	获取或设置是否将启动器选取器限制为当前应用及其关联的 URI 处理程序。
NeighboringFilesQuery	使应用能够访问与用于激活应用的文件相关的文件。
PreferredApplicationDisplayName	获取或设置一个值，该值表示应用商店中用户应安装的应用的显示名称（如果不存在用于处理文件类型或 URI 的应用）。
PreferredApplicationPackageFamilyName	获取或设置一个值，该值表示应用商店中应用的包系列名称，如果不存在用于处理文件类型或 URI 的应用，则用户应安装该名称。
TargetApplicationPackageFamilyName	应用于启动文件或 URI 的目标包的包系列名称。 此属性是可选的。
TreatAsUntrusted	获取或设置一个值，该值指示在启动与文件或 URI 关联的应用时，系统是否应显示文件或 URI 可能不安全的警告。
UI	在启动默认应用时，获取用户界面 (UI) 选项。

另请参阅

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