Поделиться через


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 , чтобы указать, что в системе должно отображаться предупреждение.

Примечание

Для приложения Windows на JavaScript вызовите preventDefault в обработчике событий, если задано свойство treatAsUntrusted и для запуска URI используется элемент привязки .

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
                    }
                });
        }
    }
}

Комментарии

Примечание

Этот класс не является гибким, что означает, что необходимо учитывать его потоковую модель и поведение маршалинга. Дополнительные сведения см. в разделах Потоки и маршалинг (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) на устройстве.

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, или приложение, указанное ContentType для указанного URI, используя указанные параметры.

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), типа запуска и имени пакета.

Применяется к

См. также раздел