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 屬性來指定您想要啟動的應用程式，藉由傳遞 LauncherOptions 參數，將屬性設定為包含該應用程式的應用程式套件的套件系列名稱。

有兩種情況如下：

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 時，是否要顯示 Open With 對話方塊。
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 的指導方針