LaunchActivatedEventArgs Classe

Définition

Espace de noms:

Windows.ApplicationModel.Activation

Fournit des informations sur les événements lors du lancement d’une application.

Javascript Ce type apparaît sous la forme WebUILaunchActivatedEventArgs.

public ref class LaunchActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class LaunchActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class LaunchActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider

Public NotInheritable Class LaunchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider

Héritage

Object Platform::Object IInspectable LaunchActivatedEventArgs

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

IActivatedEventArgs IApplicationViewActivatedEventArgs ILaunchActivatedEventArgs IPrelaunchActivatedEventArgs IViewSwitcherProvider IActivatedEventArgsWithUser ILaunchActivatedEventArgs2

Configuration requise pour Windows

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

Remarques

Cet objet est accessible lorsque vous répondez aux événements activés lorsque ActivationKind est Launch.

L’application UWP utilisant C++, C# ou Visual Basic implémente généralement des points d’activation en remplaçant les méthodes de l’objet Application . Les fichiers code-behind de modèle par défaut app.xaml incluent toujours une substitution pour OnLaunched. L’implémentation par défaut inclut la prise en charge initiale de la navigation et la gestion de l’état via la classe d’assistance SuspensionManager.

Toutes les substitutions d’application impliquées dans un scénario d’activation doivent appeler Window.Activate dans leurs implémentations.

Évitez d’effectuer des tâches pendant le lancement si elles peuvent augmenter considérablement le temps nécessaire au lancement de votre application. Au lieu de cela, vous pouvez déclencher des tâches de chargement supplémentaires en écoutant l’événement SplashScreen.Dismissed .

L’objet de report d’activation ne doit pas être utilisé pour effectuer des tâches complexes pendant l’activation. Toutes les erreurs ou exceptions non gérées qui se produisent pendant l’activation (y compris l’activation différée) entraînent le blocage de l’application. Si vous devez effectuer des appels réseau ou traiter un certain nombre de fichiers supplémentaires pendant l’activation, envisagez de lancer votre application sur un écran de démarrage étendu, puis d’effectuer ces opérations. Pour plus d’informations, consultez Comment afficher un écran de démarrage pendant une période prolongée.

Important

Les applications qui nécessitent un délai excessif pour le lancement peuvent être arrêtées par le système.

Lorsque vous testez votre application, n’oubliez pas que la réactivation immédiate d’une application qui vient d’être terminée entraîne un échec de l’activation si l’écran de démarrage est toujours visible.

Exécution du lancement JavaScript

Si la programmation avec JavaScript, le lancement est terminé lorsque votre gestionnaire d’événements activé retourne correctement après l’exécution de vos tâches de lancement.

Fin du lancement .NET

Si la programmation avec C#, VB ou C++, le lancement est terminé lorsque vous activez une fenêtre d’application.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1607	14393	TileActivatedInfo
1607	14393	Utilisateur

Propriétés

Arguments	Obtient les arguments qui sont passés à l’application lors de son activation de lancement.
CurrentlyShownApplicationViewId	Obtient l’identificateur de la vue d’application actuellement affichée.
Kind	Obtient la raison pour laquelle cette application est activée.
PrelaunchActivated	Indique si l’application a été pré-lancée.
PreviousExecutionState	Obtient l’état d’exécution de l’application avant cette activation.
SplashScreen	Obtient l’objet d’écran de démarrage qui fournit des informations sur la transition de l’écran de démarrage à l’application activée.
TileActivatedInfo	Obtient des informations supplémentaires fournies lorsque l’utilisateur lance votre application à partir d’une vignette. Cette valeur est null si l’application n’est pas lancée à partir de sa vignette ou si l’application est lancée sur une plateforme qui ne prend pas en charge cette propriété.
TileId	Obtient l’ID de la vignette appelée pour lancer l’application.
User	Obtient l’utilisateur pour lequel l’application a été activée.
ViewSwitcher	Obtient l’objet sélecteur d’affichage qui vous permet de définir la vue pour l’application.

Voir aussi

• Activated
• Application
• OnLaunched(LaunchActivatedEventArgs)
• Gérer l’activation d’une application