Condividi tramite


LaunchActivatedEventArgs Classe

Definizione

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

Javascript Questo tipo viene visualizzato come 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
Ereditarietà
Object Platform::Object IInspectable LaunchActivatedEventArgs
Attributi
Implementazioni

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.

Si applica a

Vedi anche