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 パラメーターを渡すことによって、起動するアプリを正確に指定する必要があります。

このような場合は、次の 2 つがあります。

1. Launcher.LaunchUriAsync(Uri, LauncherOptions, ValueSet)を使用して、URI を使用してアプリを起動し、起動したアプリに追加の入力データを渡す必要があります。
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 スキーム (ブラウザーなど) を処理できるハンドラーを無視するかどうかを示します。 代わりに、起動は既定のブラウザーにフォールバックします。
LimitPickerToCurrentAppAndAppUriHandlers	現在のアプリとそれに関連付けられている URI ハンドラーにランチャーのピッカーを制限するかどうかを取得または設定します。
NeighboringFilesQuery	アプリが、アプリのアクティブ化に使用されるファイルに関連するファイルにアクセスできるようにします。
PreferredApplicationDisplayName	ファイルの種類または URI を処理するアプリが存在しない場合にユーザーがインストールするストア内のアプリの表示名を表す値を取得または設定します。
PreferredApplicationPackageFamilyName	ファイルの種類または URI を処理するアプリが存在しない場合にユーザーがインストールする必要があるストア内のアプリのパッケージ ファミリ名を表す値を取得または設定します。
TargetApplicationPackageFamilyName	ファイルまたは URI の起動に使用するターゲット パッケージのパッケージ ファミリ名。 場合によっては、このプロパティは省略可能です。 「解説参照してください。
TreatAsUntrusted	ファイルまたは URI に関連付けられているアプリを起動するときに、ファイルまたは URI が安全でない可能性があることを示す警告をシステムに表示するかどうかを示す値を取得または設定します。
UI	既定のアプリを起動するときのユーザー インターフェイス (UI) オプションを取得します。

こちらもご覧ください

• LaunchFileAsync(IStorageFile, LauncherOptions)
• LaunchUriAsync(Uri, LauncherOptions)
• Association の起動サンプル
• ファイル の既定のアプリを起動する
• URI の既定のアプリを起動します
• ファイルの種類と URI の ガイドライン