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 的指導方針