FileOpenPickerActivatedEventArgs 클래스

정의

네임스페이스:

Windows.ApplicationModel.Activation

사용자가 앱에서 제공하는 파일 또는 폴더를 선택하려고 할 때 발생하는 활성화된 이벤트에 대한 정보를 제공합니다.

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

public ref class FileOpenPickerActivatedEventArgs sealed : IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileOpenPickerActivatedEventArgs final : IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileOpenPickerActivatedEventArgs : IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

Public NotInheritable Class FileOpenPickerActivatedEventArgs
Implements IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2

상속

Object Platform::Object IInspectable FileOpenPickerActivatedEventArgs

특성

ContractVersionAttribute MarshalingBehaviorAttribute

구현

IActivatedEventArgs IFileOpenPickerActivatedEventArgs IFileOpenPickerActivatedEventArgs2 IActivatedEventArgsWithUser

Windows 요구 사항

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

예제

파일 선택기 계약 샘플에서는 FileOpenPicker 활성화 지점에 응답하는 방법을 보여 줍니다.

// File open picker activated event handler
protected override void OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs args)
{
    var FileOpenPickerPage = new SDKTemplate.FileOpenPickerPage();
    FileOpenPickerPage.Activate(args);
}

// Overloaded method to respond to fileOpenPicker events
public void Activate(FileOpenPickerActivatedEventArgs args)
{
    // Perform tasks to prepare your app to display its file picker page

    // Get file picker UI
    fileOpenPickerUI = args.FileOpenPickerUI;

    Window.Current.Content = this;
    this.OnNavigatedTo(null);
    Window.Current.Activate();
}

C# args 의 경우 OnFileOpenPickerActivated 재정의의 경우 FileOpenPickerActivatedEventArgs 개체를 참조합니다. OnFileOpenPickerActivated 재정의는 App.xaml.cs 파일에 있으며 Activate 메서드는 파일 선택기 계약 샘플의 FileOpenPickerPage.xaml.cs 파일에 있습니다.

설명

빠른 시작: Windows.Storage.Pickers.Provider 네임스페이스 참조를 통해 파일 서비스 제공 에서 사용자가 앱에서 선택할 수 있는 파일을 제공하는 방법을 알아봅니다.

사용자가 앱에서 제공하는 파일 또는 폴더를 선택하려는 경우 FileOpenPickerActivatedEventArgs 개체가 앱의 활성화된 이벤트 처리기에 전달됩니다. 이 유형의 활성화는 Kind 속성에서 반환되는 ActivationKind.FileOpenPicker 값으로 표시됩니다.

JavaScript로 작성된 앱은 Windows.UI.WebUI.webUIApplication.activated 이벤트를 수신 대기하고 처리해야 합니다.

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

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

버전 기록

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

속성

CallerPackageFamilyName	앱을 시작한 앱의 패키지 패밀리 이름입니다.
FileOpenPickerUI	사용자가 앱에서 제공하는 파일 또는 폴더를 선택하려고 할 때 표시되는 파일 선택기의 편지함 UI를 가져옵니다.
Kind	활성화 유형을 가져옵니다.
PreviousExecutionState	활성화되기 전에 앱의 실행 상태를 가져옵니다.
SplashScreen	시작 화면에서 활성화된 앱으로의 전환에 대한 정보를 제공하는 SplashScreen 개체를 가져옵니다.
User	앱이 활성화된 사용자를 가져옵니다.

추가 정보

• OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs)
• Application
• FileOpenPicker
• Windows.Storage.Pickers.Provider
• Activated
• Activated
• 빠른 시작: 를 통해 파일 서비스 제공
• 파일 선택기 계약 샘플