Launcher クラス

定義

名前空間:

Windows.System

指定したファイルまたは URI に関連付けられている既定のアプリを起動します。

public ref class Launcher abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Launcher final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class Launcher

Public Class Launcher

継承

Object Platform::Object IInspectable Launcher

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

アプリ パッケージに含まれているファイルを起動する

LaunchFileAsync(IStorageFile) トピックのコード例を参照してください。

URI を起動する

LaunchUriAsync(Uri) トピックのコード例を参照してください。

警告ダイアログを表示して起動する

この例では 、launchUriAsync(Uri, LauncherOptions) を呼び出して、警告を含む URI を起動します。 システムに警告を表示する必要があることを示すには、 treatAsUntrusted プロパティを使用します。

Note

JavaScript を使用する Windows アプリの場合、treatAsUntrusted プロパティが設定されていて、アンカー要素を使用して URI を起動している場合は、イベント ハンドラーで preventDefault を呼び出します。

function linkClickHandler(eventInfo) {
    var link = eventInfo.target;
    if (eventInfo.srcElement && (
        (eventInfo.type === "click") ||
        (eventInfo.type === "keydown" && (
        eventInfo.keyCode === WinJS.Utilities.Key.enter ||
        eventInfo.keyCode === WinJS.Utilities.Key.space)))) {
        eventInfo.preventDefault();
        if (link.href.indexOf("ms-appx") > -1) {
            WinJS.Navigation.navigate(link.href);
        }
        else if (link.href.indexOf("http") > -1) {
            // Create a Uri object from a URI string 
            var uri = new Windows.Foundation.Uri(link.href);
            var options = new Windows.System.LauncherOptions();
            // Launch the URI with a warning prompt
            options.treatAsUntrusted = true;
            // Launch the URI
            Windows.System.Launcher.launchUriAsync(uri, options).then(
                function (success) {
                    if (success) {
                        // URI launched
                    } else {
                        // URI launch failed
                    }
                });
        }
    }
}

注釈

Note

このクラスはアジャイルではありません。つまり、スレッド モデルとマーシャリング動作を考慮する必要があります。 詳細については、「スレッド処理とマーシャリング (C++/CX)」および「マルチスレッド環境でのWindows ランタイム オブジェクトの使用 (.NET)」を参照してください。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1607	14393	FindAppUriHandlersAsync
1607	14393	LaunchUriForResultsForUserAsync(User,Uri,LauncherOptions)
1607	14393	LaunchUriForResultsForUserAsync(User,Uri,LauncherOptions,ValueSet)
1607	14393	LaunchUriForUserAsync(User,Uri)
1607	14393	LaunchUriForUserAsync(User,Uri,LauncherOptions)
1607	14393	LaunchUriForUserAsync(User,Uri,LauncherOptions,ValueSet)
1607	14393	QueryAppUriSupportAsync(Uri)
1607	14393	QueryAppUriSupportAsync(Uri,String)
1809	17763	LaunchFolderPathAsync(String)
1809	17763	LaunchFolderPathAsync(String,FolderLauncherOptions)
1809	17763	LaunchFolderPathForUserAsync(User,String)
1809	17763	LaunchFolderPathForUserAsync(User,String,FolderLauncherOptions)

メソッド

FindAppUriHandlersAsync(Uri)	デバイス上の Uri (Uniform Resource Identifier) ハンドラーを列挙します。
FindFileHandlersAsync(String)	デバイス上のファイル ハンドラーを列挙します。
FindUriSchemeHandlersAsync(String)	デバイス上のスキーム ハンドラーを列挙します。
FindUriSchemeHandlersAsync(String, LaunchQuerySupportType)	デバイス上のスキーム ハンドラーを列挙します。
LaunchFileAsync(IStorageFile)	指定したファイルに関連付けられている既定のアプリを起動します。
LaunchFileAsync(IStorageFile, LauncherOptions)	指定したオプションを使用して、指定したファイルに関連付けられている既定のアプリを起動します。
LaunchFolderAsync(IStorageFolder)	エクスプローラーを起動し、指定したフォルダーの内容を表示します。
LaunchFolderAsync(IStorageFolder, FolderLauncherOptions)	指定したオプションを使用してエクスプローラーを起動し、指定したフォルダーの内容を表示します。
LaunchFolderPathAsync(String)	エクスプローラーを起動し、指定したフォルダーの内容を表示します。
LaunchFolderPathAsync(String, FolderLauncherOptions)	指定したオプションを使用してエクスプローラーを起動し、指定したフォルダーの内容を表示します。
LaunchFolderPathForUserAsync(User, String)	エクスプローラーを起動し、指定したフォルダーの内容を表示します。
LaunchFolderPathForUserAsync(User, String, FolderLauncherOptions)	指定したオプションを使用してエクスプローラーを起動し、指定したフォルダーの内容を表示します。
LaunchUriAsync(Uri)	指定した URI の URI スキーム名に関連付けられている既定のアプリを起動します。
LaunchUriAsync(Uri, LauncherOptions)	指定したオプションを使用して、URI スキーム名または指定した URI の ContentType で指定された名前に関連付けられている既定のアプリを起動します。
LaunchUriAsync(Uri, LauncherOptions, ValueSet)	指定したオプションと入力データを使用して、指定した URI の URI スキーム名に関連付けられている既定のアプリを起動します。
LaunchUriForResultsAsync(Uri, LauncherOptions)	指定したオプションを使用して、指定した URI の URI スキーム名に関連付けられている既定のアプリを非同期的に開始します。
LaunchUriForResultsAsync(Uri, LauncherOptions, ValueSet)	指定したオプションと入力データを使用して、指定した URI の URI スキーム名に関連付けられている既定のアプリを非同期的に起動します。
LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions)	指定したオプションを使用して、指定した URI の URI スキーム名に関連付けられている既定のアプリを非同期的に起動し、特定の ユーザー をコンテキストとして提供します。
LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions, ValueSet)	指定したオプションと入力データを使用して、指定した URI の URI スキーム名に関連付けられている既定のアプリを非同期的に起動し、特定の ユーザー をコンテキストとして提供します。
LaunchUriForUserAsync(User, Uri)	指定した URI の URI スキーム名に関連付けられている既定のマルチユーザー アプリを起動し、コンテキストとして特定の ユーザーを 提供します。
LaunchUriForUserAsync(User, Uri, LauncherOptions)	指定したオプションを使用して、指定した URI の URI スキーム名に関連付けられている既定のマルチユーザー アプリを起動し、特定の ユーザー をコンテキストとして提供します。
LaunchUriForUserAsync(User, Uri, LauncherOptions, ValueSet)	指定したオプションと入力データを使用して、指定した URI の URI スキーム名に関連付けられている既定のマルチユーザー アプリを起動し、特定の ユーザー をコンテキストとして提供します。
QueryAppUriSupportAsync(Uri)	指定した URI を処理できるアプリがあるかどうかを非同期的に照会します。
QueryAppUriSupportAsync(Uri, String)	指定したアプリが指定した URI を処理できるかどうかを非同期的に照会します。
QueryFileSupportAsync(StorageFile)	指定したファイルに対してアプリをアクティブにできるかどうかを非同期的に照会します。
QueryFileSupportAsync(StorageFile, String)	指定したファイルに対して、指定したパッケージ名を持つアプリをアクティブ化できるかどうかを非同期的に照会します。
QueryUriSupportAsync(Uri, LaunchQuerySupportType)	指定した URI と起動の種類に対してアプリをアクティブにできるかどうかを非同期的に照会します。
QueryUriSupportAsync(Uri, LaunchQuerySupportType, String)	指定した URI、起動の種類、パッケージ名に対してアプリをアクティブにできるかどうかを非同期的に照会します。

こちらもご覧ください

• LauncherOptions
• LauncherUIOptions
• ファイルに応じた既定のアプリの起動
• URI に応じた既定のアプリの起動
• Association Launching サンプル
• ファイルの種類と URI のガイドライン