LauncherOptions Classe

Définition

Espace de noms:

Windows.System

Spécifie les options utilisées pour lancer l’application par défaut pour un fichier ou un URI.

Dans une application de bureau, avant d’utiliser une instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow.

public ref class LauncherOptions sealed : ILauncherViewOptions

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class LauncherOptions final : ILauncherViewOptions

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class LauncherOptions : ILauncherViewOptions

function LauncherOptions()

Public NotInheritable Class LauncherOptions
Implements ILauncherViewOptions

Héritage

Object Platform::Object IInspectable LauncherOptions

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

ILauncherViewOptions

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

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

Remarques

Dans certains cas, lorsque vous appelez Launcher méthodes statiques pour lancer une application associée à un type de fichier ou un protocole d’URI, vous devez spécifier exactement l’application à lancer en transmettant un paramètre LauncherOptions avec la propriété TargetApplicationPackageFamilyName définie sur le nom de famille de package pour le package d’application contenant cette application.

Deux de ces cas sont les suivants :

1. Vous souhaitez lancer une application avec un URI et transmettre des données d’entrée supplémentaires à l’application lancée, à l’aide de Launcher.LaunchUriAsync(Uri, LauncherOptions, ValueSet).
2. Vous souhaitez lancer une application avec un URI et attendre que l’application renvoie des données de sortie à votre application à l’aide de toute surcharge de Launcher.LaunchUriForResultsAsync.

Dans ces cas, l’application appelante et l’application lancée doivent être d’accord sur la façon d’interpréter les données supplémentaires transmises d’une application à l’autre. L’application appelante ne peut pas lancer une application qui est la valeur par défaut pour ce protocole d’URI. Dans d’autres cas, la propriété TargetApplicationPackageFamilyName est facultative.

Historique des versions

Version de Windows	Version du Kit de développement logiciel (SDK	Valeur ajoutée
1607	14393	IgnoreAppUriHandlers
1703	15063	LimitPickerToCurrentAppAndAppUriHandlers

Constructeurs

LauncherOptions()

Crée et initialise une nouvelle instance de l’objet options du lanceur. Dans une application de bureau, avant d’utiliser une instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow.

Propriétés

ContentType	Obtient ou définit le type de contenu associé à un URI qui représente un fichier sur le réseau.
DesiredRemainingView	Lancez une application cible et l’application source en cours d’exécution reste sur l’écran en partageant l’espace de façon égale avec l’application cible ou en prenant plus ou moins d’espace que l’application cible.
DisplayApplicationPicker	Obtient ou définit une valeur qui indique s’il faut afficher la boîte de dialogue Ouvrir avec chaque fois que l’API de lancement d’association est appelée.
FallbackUri	Obtient ou définit une valeur qui représente un URI vers lequel l’utilisateur doit être dirigé dans le navigateur si aucune application n’existe pour gérer le type de fichier ou l’URI.
IgnoreAppUriHandlers	Indique s’il faut ignorer les gestionnaires qui peuvent gérer les schémas http(s) (tels que les navigateurs). Au lieu de cela, le lancement revient au navigateur par défaut.
LimitPickerToCurrentAppAndAppUriHandlers	Obtient ou définit s’il faut limiter le sélecteur du lanceur à l’application actuelle et à ses gestionnaires d’URI associés.
NeighboringFilesQuery	Permet à une application d’accéder aux fichiers associés au fichier utilisé pour activer l’application.
PreferredApplicationDisplayName	Obtient ou définit une valeur qui représente le nom complet de l’application dans le Store que l’utilisateur doit installer si aucune application n’existe pour gérer le type de fichier ou l’URI.
PreferredApplicationPackageFamilyName	Obtient ou définit une valeur qui représente le nom de famille de package de l’application dans le Windows Store que l’utilisateur doit installer si aucune application n’existe pour gérer le type de fichier ou l’URI.
TargetApplicationPackageFamilyName	Nom de la famille de packages du package cible qui doit être utilisé pour lancer un fichier ou un URI. Cette propriété est facultative dans certains cas. Consultez remarques.
TreatAsUntrusted	Obtient ou définit une valeur qui indique si le système doit afficher un avertissement indiquant que le fichier ou l’URI est potentiellement dangereux lors du démarrage de l’application associée à un fichier ou un URI.
UI	Obtient les options d’interface utilisateur lors du démarrage d’une application par défaut.

Voir aussi

• LaunchFileAsync(IStorageFile, LauncherOptions)
• LaunchUriAsync(Uri, LauncherOptions)
• exemple de de lancement de l’association
• Lancer l’application par défaut pour un fichier
• Lancer l’application par défaut pour un URI
• Recommandations pour les types de fichiers et les URI