LaunchActivatedEventArgs 클래스

정의

네임스페이스:

Windows.ApplicationModel.Activation

앱이 시작될 때 이벤트 정보를 제공합니다.

자바 스크립트 이 형식은 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에서 도입되었습니다.)

설명

ActivationKind가 시작되면 활성화된 이벤트에 응답할 때 이 개체에 액세스합니다.

C++, C#또는 Visual Basic을 사용하는 UWP 앱은 일반적으로 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	앱을 시작하기 위해 호출된 타일의 ID를 가져옵니다.
User	앱이 활성화된 사용자를 가져옵니다.
ViewSwitcher	애플리케이션에 대한 보기를 설정할 수 있는 뷰 전환기 개체를 가져옵니다.

추가 정보

• Activated
• Application
• OnLaunched(LaunchActivatedEventArgs)
• 앱 활성화 처리