LaunchActivatedEventArgs Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Ereignisinformationen bereit, wenn eine App gestartet wird.
Javascript Dieser Typ wird als WebUILaunchActivatedEventArgs angezeigt.
public ref class LaunchActivatedEventArgs sealed : IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProviderpublic 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, IViewSwitcherProviderPublic NotInheritable Class LaunchActivatedEventArgs
Implements IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProviderPublic NotInheritable Class LaunchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider- Vererbung
- Attribute
- Implementiert
Windows-Anforderungen
| Anforderungen | Beschreibung |
|---|---|
| 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 ActivationKindgestartet wird.
UWP-App mit C++, C# oder Visual Basic implementieren in der Regel Aktivierungspunkte durch Überschreiben von Methoden des Application-Objekts. Die Standardmäßigen CodeBehind-Dateien der Vorlage "app.xaml" enthalten immer eine Außerkraftsetzung für "OnLaunched". Die Standardimplementierung umfasst die anfängliche Navigationsunterstützung und zustandsverwaltung über die SuspensionManager-Hilfsklasse.
Alle Anwendungsüberschreibungen , die in einem Aktivierungsszenario beteiligt sind, sollten Window.Activate in ihren Implementierungen aufrufen.
Vermeiden Sie das Ausführen von Aufgaben während des Startvorgangs, wenn sie die zum Starten der App erforderliche Zeit erheblich erhöhen 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 (einschließlich verzögerter Aktivierung) auftreten, führen dazu, dass die App abstürzt. Wenn Sie während der Aktivierung Netzwerkaufrufe ausführen oder eine Reihe zusätzlicher Dateien verarbeiten müssen, sollten Sie die App auf einen erweiterten Begrüßungsbildschirm starten und diese Vorgänge ausführen. Weitere Informationen finden Sie unter Anzeigen eines Begrüßungsbildschirms für längere Zeit.
Important
Apps, die einen übermäßigen Zeitraum für den Start erfordern, können vom System beendet werden.
Beachten Sie beim Testen Ihrer App, dass das sofortige Reaktivieren einer soeben beendeten App zu einer fehlgeschlagenen Aktivierung führt, wenn der Begrüßungsbildschirm weiterhin sichtbar ist.
JavaScript-Startabschluss
Wenn die Programmierung mit JavaScript abgeschlossen ist, wird der Startvorgang abgeschlossen, wenn der aktivierte Ereignishandler nach dem Ausführen der Startaufgaben erfolgreich zurückgegeben wird.
.NET Abschluss des Starts
Wenn die Programmierung mit C#, VB oder C++ abgeschlossen ist, ist der Start abgeschlossen, wenn Sie ein App-Fenster aktivieren.
Versionsverlauf
| Windows-Version | SDK-Version | Mehrwert |
|---|---|---|
| 1607 | 14393 | TileActivatedInfo |
| 1607 | 14393 | Benutzer |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Arguments |
Ruft die Startargumente 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 für die Aktivierung dieser App ab. |
| 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 über eine Kachel 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 aufgerufen wurde, um die App zu starten. |
| User |
Ruft den Benutzer ab, für den die App aktiviert wurde. |
| ViewSwitcher |
Ruft das Ansichtsschalterobjekt ab, mit dem Sie die Ansicht für die Anwendung festlegen können. |