LaunchActivatedEventArgs Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Activation

Fornisce informazioni sugli eventi all'avvio di un'app.

Javascript Questo tipo viene visualizzato come 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

Ereditarietà

Object Platform::Object IInspectable LaunchActivatedEventArgs

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni

IActivatedEventArgs IApplicationViewActivatedEventArgs ILaunchActivatedEventArgs IPrelaunchActivatedEventArgs IViewSwitcherProvider IActivatedEventArgsWithUser ILaunchActivatedEventArgs2

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Questo oggetto è accessibile quando si risponde agli eventi Activated quando ActivationKind è Launch.

L'app UWP che usa C++, C# o Visual Basic implementa in genere i punti di attivazione eseguendo l'override dei metodi dell'oggetto Application . I file code-behind del modello predefinito app.xaml includono sempre un override per OnLaunched. L'implementazione predefinita include il supporto di spostamento iniziale e la gestione dello stato tramite la classe helper SuspensionManager.

Tutte le sostituzioni dell'applicazione coinvolte in uno scenario di attivazione devono chiamare Window.Activate nelle implementazioni.

Evitare di eseguire attività durante l'avvio se potrebbero aumentare significativamente il tempo necessario per avviare l'app. È invece possibile attivare attività di caricamento aggiuntive ascoltando l'evento SplashScreen.Dismissed .

L'oggetto differire dell'attivazione non deve essere usato per completare attività complesse durante l'attivazione. Eventuali errori o eccezioni non gestiti che si verificano durante l'attivazione (inclusa l'attivazione posticipata) causeranno l'arresto anomalo dell'app. Se è necessario eseguire chiamate di rete o elaborare diversi file aggiuntivi durante l'attivazione, è consigliabile avviare l'app in una schermata iniziale estesa e quindi eseguire queste operazioni. Per altre informazioni, vedere Come visualizzare una schermata iniziale per un periodo di tempo prolungato.

Importante

Le app che richiedono un periodo di tempo eccessivo per l'avvio possono essere terminate dal sistema.

Durante il test dell'app, tenere presente che la riattivazione immediata di un'app che è stata appena terminata comporterà un'attivazione non riuscita se la schermata iniziale è ancora visibile.

Completamento dell'avvio di JavaScript

Se la programmazione con JavaScript, l'avvio viene completato quando il gestore eventi attivato viene restituito correttamente dopo l'esecuzione delle attività di avvio.

Completamento dell'avvio di .NET

Se la programmazione con C#, VB o C++, l'avvio viene completato quando si attiva una finestra dell'app.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	TileActivatedInfo
1607	14393	Utente

Proprietà

Arguments	Ottiene gli argomenti passati all'app durante l'attivazione dell'avvio.
CurrentlyShownApplicationViewId	Ottiene l'identificatore per la visualizzazione dell'app attualmente visualizzata.
Kind	Ottiene il motivo per cui questa app viene attivata.
PrelaunchActivated	Indica se l'app è stata avviata in fase di preavvio.
PreviousExecutionState	Ottiene lo stato di esecuzione dell'app prima dell'attivazione.
SplashScreen	Ottiene l'oggetto schermata iniziale che fornisce informazioni sulla transizione dalla schermata iniziale all'app attivata.
TileActivatedInfo	Ottiene informazioni aggiuntive fornite quando l'utente avvia l'app da un riquadro. Questo valore sarà Null se l'app non viene avviata dal relativo riquadro o se l'app viene avviata in una piattaforma che non supporta questa proprietà.
TileId	Ottiene l'ID del riquadro richiamato per avviare l'app.
User	Ottiene l'utente per cui è stata attivata l'app.
ViewSwitcher	Ottiene l'oggetto switcher di visualizzazione che consente di impostare la visualizzazione per l'applicazione.

Vedi anche

• Activated
• Application
• OnLaunched(LaunchActivatedEventArgs)
• Gestire l’attivazione dell’app