次の方法で共有


Launcher クラス

定義

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

public ref class Launcher abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class Launcher final
/// [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)]
public static class Launcher
[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
属性

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、起動の種類、パッケージ名に対してアプリをアクティブにできるかどうかを非同期的に照会します。

適用対象

こちらもご覧ください