LauncherOptions クラス

  • リファレンス

定義

名前空間:
Windows.System
編集

ファイルまたは URI の既定のアプリを起動するために使用するオプションを指定します。

デスクトップ アプリでは、UI を表示する方法でこのクラスのインスタンスを使用する前に、オブジェクトを所有者のウィンドウ ハンドルに関連付ける必要があります。 詳細とコード例については、「CoreWindowに依存する WinRT UI オブジェクトを表示する」を参照してください。

public ref class LauncherOptions sealed : ILauncherViewOptions
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class LauncherOptions final : 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")]
class LauncherOptions final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class LauncherOptions : 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")]
public sealed class LauncherOptions : 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) オプションを取得します。

適用対象

こちらもご覧ください