Launcher Classe

Référence

Définition

Espace de noms:: Windows.System

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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 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 LaunchFileAsync(IStorageFile) rubrique.

Lancer un URI

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

Lancer avec une boîte de dialogue d’avertissement

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

Notes

Pour une application Windows à l’aide de JavaScript, appelez preventDefault dans votre gestionnaire d’événements si la treatAsUntrusted propriété 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 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émas sur l’appareil.
FindUriSchemeHandlersAsync(String, LaunchQuerySupportType)	Énumérez les gestionnaires de schémas 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 celle spécifiée par l’URI ContentType 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 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 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 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 spécifiées et fournit un contexte spécifique User .
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 contexte spécifique User .
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 contexte spécifique User .
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 contexte spécifique User .
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é, à l’aide des options et des données d’entrée spécifiées, et fournit un contexte spécifique User .
QueryAppUriSupportAsync(Uri)	Interrogez de façon asynchrone si une application 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 façon asynchrone si une application peut être activée pour le fichier spécifié.
QueryFileSupportAsync(StorageFile, String)	Interrogez de façon asynchrone si une application avec 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 du package spécifiés.

S’applique à