패키지징 앱에 대한 활성화 정보 가져오기

Windows 10, 버전 1809부터 패키지된 데스크톱 앱은 AppInstance.GetActivatedEventArgs 메서드를 호출하여 시작하는 경우 특정 종류의 앱 활성화 정보를 검색할 수 있습니다. 예를 들어, 이 메서드를 호출하여 파일 열기, 대화형 알림 클릭 또는 프로토콜 사용에서 앱 활성화와 관련된 정보를 얻을 수 있습니다. Windows 10 버전 2004부터 이 기능은 외부 위치가 있는 패키지 앱에서도 지원됩니다(외부 위치를 사용하여 패키지하여 패키지 ID 부여 참조).

코드 예제

다음 코드 예제는 Windows Forms 앱의 Main 함수에서 AppInstance.GetActivatedEventArgs 메서드를 호출하는 방법을 보여 줍니다. 앱에서 지원하는 각 활성화 형식에 대해 args 반환 값을 해당하는 이벤트 args 형식으로 캐스팅합니다. 이 코드 예제에서 Handlexxx 메서드는 다른 곳에서 정의한 전용 활성화 처리기 코드로 간주됩니다.

static void Main()
{
    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);

    var args = AppInstance.GetActivatedEventArgs();
    switch (args.Kind)
    {
        case ActivationKind.Launch:
            HandleLaunch(args as LaunchActivatedEventArgs);
            break;
        case ActivationKind.ToastNotification:
            HandleToastNotification(args as ToastNotificationActivatedEventArgs);
            break;
        case ActivationKind.VoiceCommand:
            HandleVoiceCommand(args as VoiceCommandActivatedEventArgs);
            break;
        case ActivationKind.File:
            HandleFile(args as FileActivatedEventArgs);
            break;
        case ActivationKind.Protocol:
            HandleProtocol(args as ProtocolActivatedEventArgs);
            break;
        case ActivationKind.StartupTask:
            HandleStartupTask(args as StartupTaskActivatedEventArgs);
            break;
        default:
            HandleLaunch(null);
            break;
    }

지원되는 활성화 유형

AppInstance.GetActivatedEventArgs 메서드를 사용하여 다음 테이블에 나열된 지원되는 이벤트 args 개체 집합에서 활성화 정보를 검색할 수 있습니다. 이러한 활성화 형식 중 일부는 패키지 매니페스트에서 패키지 확장을 사용해야 합니다.

ShareTargetActivatedEventArgs 활성화 정보는 Windows 10, 버전 2004 이상에서만 지원됩니다. 다른 모든 활성화 정보 형식은 Windows 10, 버전 1809 이상에서 지원됩니다.