FileActivatedEventArgs 클래스

정의

네임스페이스:

Windows.ApplicationModel.Activation

앱이 파일과 연결된 앱이므로 활성화될 때 데이터를 제공합니다.

자바 스크립트 이 형식은 WebUIFileActivatedEventArgs로 표시됩니다.

public ref class FileActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

Public NotInheritable Class FileActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

상속

Object Platform::Object IInspectable FileActivatedEventArgs

특성

ContractVersionAttribute MarshalingBehaviorAttribute

구현

IActivatedEventArgs IApplicationViewActivatedEventArgs IFileActivatedEventArgs IFileActivatedEventArgsWithCallerPackageFamilyName IFileActivatedEventArgsWithNeighboringFiles IViewSwitcherProvider IActivatedEventArgsWithUser

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

Application 개체의 OnFileActivated 이벤트 처리기는 모든 파일 활성화 이벤트를 수신합니다.

protected override void OnFileActivated(FileActivatedEventArgs args)
{
       // TODO: Handle file activation

       // The number of files received is args.Files.Size
       // The first file is args.Files[0].Name
}

Private Sub OnFileActivated(ByVal args As Windows.ApplicationModel.Activation.FileActivatedEventArgs)
      ' TODO: Handle file activation

      ' The number of files received is args.Files.Size
      ' The first file is args.Files(0).Name
End Sub

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs const& /* args */)
{
    // TODO: Handle file activation.

    // The number of files received is args.Files().Size().
    // The first file is args.Files().GetAt(0).Name().
}

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs^ args)
{
       // TODO: Handle file activation

       // The number of files received is args->Files->Size
       // The first file is args->Files->GetAt(0)->Name
}

설명

이 개체는 ActivationKind가 File일 때 활성화된 이벤트에 응답하는 이벤트 처리기를 구현할 때 액세스됩니다.

C++, C#또는 Visual Basic을 사용하는 UWP 앱은 일반적으로 Application 개체의 메서드를 재정의하여 활성화 지점을 구현합니다. 기본 템플릿 app.xaml 코드 숨김 파일에는 항상 OnLaunched에 대한 재정의가 포함되어 있지만 OnFileActivated 와 같은 다른 활성화 지점에 대한 재정의 정의는 앱 코드에 달려 있습니다.

활성화 시나리오와 관련된 모든 애플리케이션 재정의는 해당 구현에서 Window.Activate 를 호출해야 합니다.

앱이 파일 계약에 대해 활성화되면 Files 속성을 통해 앱에 전달된 StorageFile 개체를 사용하여 데이터에 액세스해야 합니다. 앱에 파일 위치에 대한 권한이 없을 수 있으므로 파일 경로에 액세스하려고 시도해서는 안 됩니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1607	14393	사용자

속성

CallerPackageFamilyName	앱을 시작한 앱의 패키지 패밀리 이름입니다.
CurrentlyShownApplicationViewId	현재 표시된 앱 보기의 식별자를 가져옵니다.
Files	앱이 활성화된 파일을 가져옵니다.
Kind	활성화 유형을 가져옵니다.
NeighboringFilesQuery	앱이 활성화된 파일의 인접 파일을 가져옵니다.
PreviousExecutionState	활성화되기 전에 앱의 실행 상태를 가져옵니다.
SplashScreen	시작 화면에서 활성화된 앱으로의 전환에 대한 정보를 제공하는 시작 화면 개체를 가져옵니다.
User	앱이 활성화된 사용자를 가져옵니다.
Verb	활성화된 파일과 연결된 작업을 가져옵니다.
ViewSwitcher	애플리케이션에 대한 뷰를 설정할 수 있는 개체를 제공합니다.

추가 정보

• Windows.Storage
• Activated
• OnFileActivated(FileActivatedEventArgs)
• 연결 시작 샘플
• 파일 활성화 처리
• 파일 형식 및 URI에 대한 지침
• 연결 시작 샘플(Windows 10)