LaunchActivatedEventArgs Classe
Définition
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.
Fournit des informations sur les événements lorsqu’une application est lancée.
Javascript Ce type apparaît en tant que WebUILaunchActivatedEventArgs.
public ref class LaunchActivatedEventArgs sealed : IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
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 : IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, 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 : IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, 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 IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
Public NotInheritable Class LaunchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
- Héritage
- Attributs
- Implémente
Configuration requise pour Windows
| Configuration requise | Description |
|---|---|
| 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 lancé.
Application UWP utilisant C++, C# ou Visual Basic implémentez généralement des points d’activation en substituant les méthodes de l’objet Application. Les fichiers code-behind app.xaml par défaut incluent toujours un remplacement 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 s’ils pourraient augmenter considérablement le temps nécessaire pour lancer 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 non gérées ou exceptions 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 lors de 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 de lancement peuvent être arrêtées par le système.
Lorsque vous testez votre application, sachez que la réactivation immédiate d’une application qui vient d’être arrêtée entraîne un échec de l’activation si l’écran de démarrage est toujours visible.
Saisie semi-automatique du lancement JavaScript
Si la programmation avec JavaScript est terminée, le lancement est terminé lorsque votre gestionnaire d’événements activé retourne correctement après l’exécution de vos tâches de lancement.
.NET l’achèvement du lancement
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
| Nom | Description |
|---|---|
| Arguments |
Obtient les arguments de lancement passés à l’application pendant 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 qui a été 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 l’affichage de l’application. |