LaunchActivatedEventArgs Класс

Определение

Пространство имен:

Windows.ApplicationModel.Activation

Предоставляет сведения о событиях при запуске приложения.

Javascript Этот тип отображается как 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

Наследование

Object Platform::Object IInspectable LaunchActivatedEventArgs

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Реализации

IActivatedEventArgs IApplicationViewActivatedEventArgs ILaunchActivatedEventArgs IPrelaunchActivatedEventArgs IViewSwitcherProvider IActivatedEventArgsWithUser ILaunchActivatedEventArgs2

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Доступ к этому объекту осуществляется при реагировании на события Activated , когда ActivationKind имеет значение Launch.

Приложение UWP, использующее C++, C# или Visual Basic, обычно реализует точки активации путем переопределения методов объекта Application . Файлы кода программной части app.xaml по умолчанию всегда содержат переопределение для OnLaunched. Реализация по умолчанию включает начальную поддержку навигации и управление состоянием с помощью вспомогательного класса SuspensionManager.

Все переопределения приложений , участвующие в сценарии активации, должны вызывать Window.Activate в своих реализациях.

Избегайте выполнения задач во время запуска, если они могут значительно увеличить время, необходимое для запуска приложения. Вместо этого можно активировать дополнительные задачи загрузки, прослушивая событие SplashScreen.Dismissed .

Объект отсрочки активации не следует использовать для выполнения сложных задач во время активации. Любые необработанные ошибки или исключения, возникающие во время активации (включая отложенную активацию), приводят к сбою приложения. Если во время активации необходимо выполнить сетевые вызовы или обработать несколько дополнительных файлов, попробуйте запустить приложение на расширенном экране-заставке, а затем выполнить эти операции. Дополнительные сведения см. в разделе Отображение экрана-заставки в течение длительного времени.

Важно!

Приложения, для запуска которых требуется слишком много времени, могут быть завершены системой.

При тестировании приложения имейте в виду, что немедленная повторная активация приложения, которое только что было завершено, приведет к сбою активации, если экран-заставка по-прежнему виден.

Завершение запуска JavaScript

При программировании с помощью JavaScript запуск завершается после успешного возврата активированного обработчика событий после выполнения задач запуска.

Завершение запуска .NET

Если программирование на C#, VB или C++, запуск завершается при активации окна приложения.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1607	14393	TileActivatedInfo
1607	14393	Пользователь

Свойства

Arguments	Возвращает аргументы, передаваемые приложению во время активации его запуска.
CurrentlyShownApplicationViewId	Возвращает идентификатор текущего представления приложения.
Kind	Возвращает причину активации этого приложения.
PrelaunchActivated	Указывает, было ли приложение предварительно запущено.
PreviousExecutionState	Возвращает состояние выполнения приложения до этой активации.
SplashScreen	Возвращает объект экрана-заставки, предоставляющий сведения о переходе с экрана-заставки на активированное приложение.
TileActivatedInfo	Возвращает дополнительные сведения, которые предоставляются при запуске приложения пользователем с плитки. Это значение будет иметь значение NULL , если приложение не запускается с плитки или если приложение запускается на платформе, которая не поддерживает это свойство.
TileId	Возвращает идентификатор плитки, которая была вызвана для запуска приложения.
User	Возвращает пользователя, для которому было активировано приложение.
ViewSwitcher	Возвращает объект переключателя представлений, который позволяет задать представление для приложения.

См. также раздел

• Activated
• Application
• OnLaunched(LaunchActivatedEventArgs)
• Обработка активации приложения