Launcher Classe

Définition

Espace de noms:

Windows.System

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)]
/// [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)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class Launcher

Public Class Launcher

Héritage

Object Platform::Object IInspectable Launcher

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Voir aussi

• LauncherOptions
• LauncherUIOptions
• Lancer l’application par défaut pour un fichier
• Lancer l’application par défaut pour un URI
• Exemple de lancement d’association
• Recommandations en matière de types de fichiers et d’URI