Freigeben über


LaunchActivatedEventArgs Klasse

Definition

Stellt Ereignisinformationen bereit, wenn eine App gestartet wird.

Javascript Dieser Typ wird als WebUILaunchActivatedEventArgs angezeigt.

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
Vererbung
Object Platform::Object IInspectable LaunchActivatedEventArgs
Attribute
Implementiert

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.

Gilt für:

Weitere Informationen