Launcher クラス

リファレンス

定義

名前空間:: Windows.System

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

指定したファイルまたは 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

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

適用対象

次の方法で共有

Launcher クラス

定義

Windows の要件

例

注釈

バージョン履歴

メソッド

適用対象

こちらもご覧ください

フィードバック

その他のリソース