LauncherOptions Classe

Définition

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.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class LauncherOptions final : 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")]
class LauncherOptions final : 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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class LauncherOptions : 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")]
public sealed class LauncherOptions : 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
Implémente

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.

S’applique à

Voir aussi