LaunchActivatedEventArgs Klasse

Definition

Namespace:

Windows.ApplicationModel.Activation

Stellt Ereignisinformationen bereit, wenn eine App gestartet wird.

Javascript Dieser Typ wird als WebUILaunchActivatedEventArgs angezeigt.

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

Vererbung

Object Platform::Object IInspectable LaunchActivatedEventArgs

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

IActivatedEventArgs IApplicationViewActivatedEventArgs ILaunchActivatedEventArgs IPrelaunchActivatedEventArgs IViewSwitcherProvider IActivatedEventArgsWithUser ILaunchActivatedEventArgs2

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Auf dieses Objekt wird zugegriffen, wenn Sie auf aktivierte Ereignisse reagieren, wenn ActivationKindLaunch ist.

Die UWP-App mit C++, C# oder Visual Basic implementiert in der Regel Aktivierungspunkte, indem Methoden des Application-Objekts überschrieben werden. Die CodeBehind-Dateien der Standardvorlage app.xaml enthalten immer eine Überschreibung für OnLaunched. Die Standardimplementierung umfasst die anfängliche Navigationsunterstützung und zustandsverwaltung über die SuspensionManager-Hilfsklasse.

Alle Anwendungsüberschreibungen , die an einem Aktivierungsszenario beteiligt sind, sollten Window.Activate in ihren Implementierungen aufrufen.

Vermeiden Sie das Ausführen von Aufgaben während des Starts, wenn sie die zum Starten Ihrer App erforderliche Zeit erheblich verlängern könnten. Stattdessen können Sie zusätzliche Ladeaufgaben auslösen, indem Sie auf das SplashScreen.Dismissed-Ereignis lauschen.

Das Aktivierungsverzögerungsobjekt sollte nicht zum Ausführen komplexer Aufgaben während der Aktivierung verwendet werden. Alle nicht behandelten Fehler oder Ausnahmen, die während der Aktivierung auftreten (einschließlich der verzögerten Aktivierung), führen zum Absturz der App. Wenn Sie während der Aktivierung Netzwerkaufrufe ausführen oder eine Reihe zusätzlicher Dateien verarbeiten müssen, sollten Sie Ihre App auf einem erweiterten Begrüßungsbildschirm starten und dann diese Vorgänge ausführen. Weitere Informationen finden Sie unter Anzeigen eines Begrüßungsbildschirms für längere Zeit.

Wichtig

Apps, die für den Start eine übermäßige Zeit benötigen, werden möglicherweise vom System beendet.

Beachten Sie beim Testen Ihrer App, dass das sofortige Reaktivieren einer gerade beendeten App zu einer fehlgeschlagenen Aktivierung führt, wenn der Begrüßungsbildschirm weiterhin sichtbar ist.

JavaScript-Startabschluss

Wenn Sie mit JavaScript programmieren, ist der Start abgeschlossen, wenn Ihr aktivierter Ereignishandler nach dem Ausführen Ihrer Startaufgaben erfolgreich zurückgegeben wird.

.NET-Startabschluss

Wenn Sie mit C#, VB oder C++ programmieren, ist der Start abgeschlossen, wenn Sie ein App-Fenster aktivieren.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1607	14393	TileActivatedInfo
1607	14393	User

Eigenschaften

Arguments	Ruft die Argumente ab, die während der Startaktivierung an die App übergeben werden.
CurrentlyShownApplicationViewId	Ruft den Bezeichner für die aktuell angezeigte App-Ansicht ab.
Kind	Ruft den Grund ab, aus dem diese App aktiviert wird.
PrelaunchActivated	Gibt an, ob die App vorab gestartet wurde.
PreviousExecutionState	Ruft den Ausführungsstatus der App vor dieser Aktivierung ab.
SplashScreen	Ruft das Begrüßungsbildschirmobjekt ab, das Informationen zum Übergang vom Begrüßungsbildschirm zur aktivierten App bereitstellt.
TileActivatedInfo	Ruft zusätzliche Informationen ab, die bereitgestellt werden, wenn der Benutzer Ihre App von einer Kachel aus startet. Dies ist NULL , wenn die App nicht über die Kachel gestartet wird oder wenn die App auf einer Plattform gestartet wird, die diese Eigenschaft nicht unterstützt.
TileId	Ruft die ID der Kachel ab, die zum Starten der App aufgerufen wurde.
User	Ruft den Benutzer ab, für den die App aktiviert wurde.
ViewSwitcher	Ruft das Ansichtswechselobjekt ab, mit dem Sie die Ansicht für die Anwendung festlegen können.

Weitere Informationen

• Activated
• Application
• OnLaunched(LaunchActivatedEventArgs)
• Behandeln der App-Aktivierung