Compartilhar via


Launcher Classe

Definição

Inicia o aplicativo padrão associado ao arquivo ou URI especificado.

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
Herança
Object Platform::Object IInspectable Launcher
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Iniciar um arquivo contido no pacote do aplicativo

Consulte o exemplo de código no tópico LaunchFileAsync(IStorageFile).

Iniciar um URI

Consulte o exemplo de código no tópico LaunchUriAsync(Uri).

Iniciar com uma caixa de diálogo de aviso

Este exemplo chama launchUriAsync(Uri, LauncherOptions) para iniciar um URI com um aviso. Use a propriedade treatAsUntrusted para indicar que o sistema deve exibir um aviso.

Observação

Para um aplicativo do Windows usando JavaScript, chame preventDefault em seu manipulador de eventos se a propriedade treatAsUntrusted estiver definida e você estiver usando um elemento de âncora para iniciar o 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
                    }
                });
        }
    }
}

Comentários

Observação

Essa classe não é ágil, o que significa que você precisa considerar seu modelo de threading e comportamento de marshaling. Para obter mais informações, consulte Threading and Marshaling (C++/CX) e Using Windows Runtime objects in a multithreaded environment (.NET).

Histórico de versão

Versão do Windows Versão do SDK Valor adicionado
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)

Métodos

FindAppUriHandlersAsync(Uri)

Enumerar os manipuladores de URI (Uniform Resource Identifiers) no dispositivo.

FindFileHandlersAsync(String)

Enumerar os manipuladores de arquivos no dispositivo.

FindUriSchemeHandlersAsync(String)

Enumerar os manipuladores de esquema no dispositivo.

FindUriSchemeHandlersAsync(String, LaunchQuerySupportType)

Enumerar os manipuladores de esquema no dispositivo.

LaunchFileAsync(IStorageFile)

Inicia o aplicativo padrão associado ao arquivo especificado.

LaunchFileAsync(IStorageFile, LauncherOptions)

Inicia o aplicativo padrão associado ao arquivo especificado, usando as opções especificadas.

LaunchFolderAsync(IStorageFolder)

Inicia Explorador de Arquivos e exibe o conteúdo da pasta especificada.

LaunchFolderAsync(IStorageFolder, FolderLauncherOptions)

Inicia Explorador de Arquivos com as opções especificadas e exibe o conteúdo da pasta especificada.

LaunchFolderPathAsync(String)

Inicia Explorador de Arquivos e exibe o conteúdo da pasta especificada.

LaunchFolderPathAsync(String, FolderLauncherOptions)

Inicia Explorador de Arquivos com as opções especificadas e exibe o conteúdo da pasta especificada.

LaunchFolderPathForUserAsync(User, String)

Inicia Explorador de Arquivos e exibe o conteúdo da pasta especificada.

LaunchFolderPathForUserAsync(User, String, FolderLauncherOptions)

Inicia Explorador de Arquivos com as opções especificadas e exibe o conteúdo da pasta especificada.

LaunchUriAsync(Uri)

Inicia o aplicativo padrão associado ao nome do esquema de URI para o URI especificado.

LaunchUriAsync(Uri, LauncherOptions)

Inicia o aplicativo padrão associado ao nome do esquema de URI ou aquele especificado pelo ContentType para o URI especificado, usando as opções especificadas.

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

Inicia o aplicativo padrão associado ao nome do esquema de URI para o URI especificado, usando as opções especificadas e os dados de entrada.

LaunchUriForResultsAsync(Uri, LauncherOptions)

Inicia de forma assíncrona o aplicativo padrão associado ao nome do esquema de URI para o URI especificado, usando as opções especificadas.

LaunchUriForResultsAsync(Uri, LauncherOptions, ValueSet)

Inicia de forma assíncrona o aplicativo padrão associado ao nome do esquema de URI para o URI especificado, usando as opções especificadas e os dados de entrada.

LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions)

Inicia de forma assíncrona o aplicativo padrão associado ao nome do esquema de URI para o URI especificado usando as opções especificadas e fornece um Usuário como contexto específico.

LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions, ValueSet)

Inicia de forma assíncrona o aplicativo padrão associado ao nome do esquema de URI para o URI especificado usando as opções especificadas e os dados de entrada e fornece um Usuário específico como contexto.

LaunchUriForUserAsync(User, Uri)

Inicia o aplicativo multiusuário padrão associado ao nome do esquema de URI para o URI especificado e fornece um usuário específico como contexto.

LaunchUriForUserAsync(User, Uri, LauncherOptions)

Inicia o aplicativo multiusuário padrão associado ao nome do esquema de URI para o URI especificado usando as opções especificadas e fornece um usuário específico como contexto.

LaunchUriForUserAsync(User, Uri, LauncherOptions, ValueSet)

Inicia o aplicativo multiusuário padrão associado ao nome do esquema de URI para o URI especificado, usando as opções especificadas e os dados de entrada, e fornece um Usuário específico como contexto.

QueryAppUriSupportAsync(Uri)

Consulte de forma assíncrona se há um aplicativo que pode lidar com o URI especificado.

QueryAppUriSupportAsync(Uri, String)

Consulte de forma assíncrona se o aplicativo especificado pode lidar com o URI especificado.

QueryFileSupportAsync(StorageFile)

Consulte de forma assíncrona se um aplicativo pode ser ativado para o arquivo especificado.

QueryFileSupportAsync(StorageFile, String)

Consulte de forma assíncrona se um aplicativo com o nome do pacote especificado pode ser ativado para o arquivo especificado.

QueryUriSupportAsync(Uri, LaunchQuerySupportType)

Consulte de forma assíncrona se um aplicativo pode ser ativado para o URI especificado e o tipo de inicialização.

QueryUriSupportAsync(Uri, LaunchQuerySupportType, String)

Consulte de forma assíncrona se um aplicativo pode ser ativado para o URI, o tipo de inicialização e o nome do pacote especificados.

Aplica-se a

Confira também