Partage via


Launcher Classe

Définition

Démarre l’application par défaut associée au fichier ou à l’URI spécifié.

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
Héritage
Object Platform::Object IInspectable Launcher
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Lancer un fichier contenu dans le package d’application

Consultez l’exemple de code dans la rubrique LaunchFileAsync(IStorageFile).

Lancer un URI

Consultez l’exemple de code dans la rubrique LaunchUriAsync(Uri).

Lancer avec une boîte de dialogue d’avertissement

Cet exemple appelle launchUriAsync(Uri, LauncherOptions) pour lancer un URI avec un avertissement. Utilisez la propriété treatAsUntrusted pour indiquer que le système doit afficher un avertissement.

Notes

Pour une application Windows utilisant JavaScript, appelez preventDefault dans votre gestionnaire d’événements si la propriété treatAsUntrusted est définie et que vous utilisez un élément d’ancrage pour lancer l’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
                    }
                });
        }
    }
}

Remarques

Notes

Cette classe n’est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d’informations, consultez Threading and Marshaling (C++/CX) et Utilisation d’objets Windows Runtime dans un environnement multithread (.NET).

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
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éthodes

FindAppUriHandlersAsync(Uri)

Énumérez les gestionnaires d’URI (Uniform Resource Identifiers) sur l’appareil.

FindFileHandlersAsync(String)

Énumérez les gestionnaires de fichiers sur l’appareil.

FindUriSchemeHandlersAsync(String)

Énumérez les gestionnaires de schéma sur l’appareil.

FindUriSchemeHandlersAsync(String, LaunchQuerySupportType)

Énumérez les gestionnaires de schéma sur l’appareil.

LaunchFileAsync(IStorageFile)

Démarre l’application par défaut associée au fichier spécifié.

LaunchFileAsync(IStorageFile, LauncherOptions)

Démarre l’application par défaut associée au fichier spécifié, à l’aide des options spécifiées.

LaunchFolderAsync(IStorageFolder)

Lance Explorateur de fichiers et affiche le contenu du dossier spécifié.

LaunchFolderAsync(IStorageFolder, FolderLauncherOptions)

Lance Explorateur de fichiers avec les options spécifiées et affiche le contenu du dossier spécifié.

LaunchFolderPathAsync(String)

Lance Explorateur de fichiers et affiche le contenu du dossier spécifié.

LaunchFolderPathAsync(String, FolderLauncherOptions)

Lance Explorateur de fichiers avec les options spécifiées et affiche le contenu du dossier spécifié.

LaunchFolderPathForUserAsync(User, String)

Lance Explorateur de fichiers et affiche le contenu du dossier spécifié.

LaunchFolderPathForUserAsync(User, String, FolderLauncherOptions)

Lance Explorateur de fichiers avec les options spécifiées et affiche le contenu du dossier spécifié.

LaunchUriAsync(Uri)

Démarre l’application par défaut associée au nom du schéma d’URI pour l’URI spécifié.

LaunchUriAsync(Uri, LauncherOptions)

Démarre l’application par défaut associée au nom du schéma d’URI ou à celui spécifié par le ContentType pour l’URI spécifié, à l’aide des options spécifiées.

LaunchUriAsync(Uri, LauncherOptions, ValueSet)

Démarre l’application par défaut associée au nom du schéma d’URI pour l’URI spécifié, à l’aide des options et des données d’entrée spécifiées.

LaunchUriForResultsAsync(Uri, LauncherOptions)

Démarre de manière asynchrone l’application par défaut associée au nom du schéma d’URI pour l’URI spécifié, à l’aide des options spécifiées.

LaunchUriForResultsAsync(Uri, LauncherOptions, ValueSet)

Démarre de façon asynchrone l’application par défaut associée au nom du schéma d’URI pour l’URI spécifié, à l’aide des options et des données d’entrée spécifiées.

LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions)

Démarre de manière asynchrone l’application par défaut associée au nom du schéma d’URI pour l’URI spécifié à l’aide des options spécifiées et fournit un utilisateur spécifique comme contexte.

LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions, ValueSet)

Démarre de façon asynchrone l’application par défaut associée au nom du schéma d’URI pour l’URI spécifié à l’aide des options et des données d’entrée spécifiées, et fournit un utilisateur spécifique comme contexte.

LaunchUriForUserAsync(User, Uri)

Démarre l’application multi-utilisateur par défaut associée au nom du schéma d’URI pour l’URI spécifié et fournit un utilisateur spécifique comme contexte.

LaunchUriForUserAsync(User, Uri, LauncherOptions)

Démarre l’application multi-utilisateur par défaut associée au nom du schéma d’URI pour l’URI spécifié à l’aide des options spécifiées et fournit un utilisateur spécifique en tant que contexte.

LaunchUriForUserAsync(User, Uri, LauncherOptions, ValueSet)

Démarre l’application multi-utilisateur par défaut associée au nom du schéma d’URI pour l’URI spécifié, en utilisant les options et les données d’entrée spécifiées, et fournit un utilisateur spécifique comme contexte.

QueryAppUriSupportAsync(Uri)

Interrogez de façon asynchrone s’il existe une application qui peut gérer l’URI spécifié.

QueryAppUriSupportAsync(Uri, String)

Interrogez de façon asynchrone si l’application spécifiée peut gérer l’URI spécifié.

QueryFileSupportAsync(StorageFile)

Interrogez de manière asynchrone si une application peut être activée pour le fichier spécifié.

QueryFileSupportAsync(StorageFile, String)

Interrogez de façon asynchrone si une application portant le nom de package spécifié peut être activée pour le fichier spécifié.

QueryUriSupportAsync(Uri, LaunchQuerySupportType)

Interrogez de façon asynchrone si une application peut être activée pour l’URI et le type de lancement spécifiés.

QueryUriSupportAsync(Uri, LaunchQuerySupportType, String)

Interrogez de façon asynchrone si une application peut être activée pour l’URI, le type de lancement et le nom de package spécifiés.

S’applique à

Voir aussi