FileOpenPickerUI 클래스

정의

네임스페이스:

Windows.Storage.Pickers.Provider

앱이 파일 열기 선택기 계약을 사용하여 파일을 제공하는 경우 파일 선택기와 상호 작용하는 데 사용됩니다.

public ref class FileOpenPickerUI sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileOpenPickerUI final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileOpenPickerUI

Public NotInheritable Class FileOpenPickerUI

상속

Object Platform::Object IInspectable FileOpenPickerUI

특성

ContractVersionAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox에서 도입되었습니다.)
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 의 경우 FileOpenPickerActivatedEventArgs 개체를 포함합니다. OnFileOpenPickerActivated 또한 는 App.xaml.cs 파일에 있고 Activate 메서드는 파일 선택기 공급자 샘플의 FileOpenPickerPage.xaml.cs 파일에 있습니다.

설명

앱이 파일 열기 선택기 계약에 참여하는 경우 FileOpenPicker 활성화 이벤트를 처리하는 동안 FileOpenPickerUI 속성을 사용하여 이 개체를 검색할 수 있습니다.

Windows.ApplicationModel.Activation.FileOpenPickerActivatedEventArgs.FileOpenPickerUI 속성을 사용하여 FileOpenPickerUI에 액세스합니다.

선택기가 있는 파일 및 폴더 열기에 파일을 제공하기 위한 UX 지침을 읽어 사용자가 파일 선택기를 통해 파일에 액세스할 때 좋은 환경을 만드는 방법을 알아봅니다.

속성

AllowedFileTypes	사용자가 선택할 수 있는 파일 형식(확장명) 목록을 가져옵니다.
SelectionMode	파일 선택기가 현재 선택 영역을 단일 파일로 제한하는지 또는 여러 파일을 선택할 수 있는지 여부를 나타내는 열거형 값을 가져옵니다.
SettingsIdentifier	파일 선택기의 현재 컨텍스트에 대한 식별자를 가져옵니다.
Title	파일 선택기가 사용자에게 표시하는 위치를 식별하는 파일 선택기 UI에 표시할 제목을 가져오거나 설정합니다.

메서드

AddFile(String, IStorageFile)	사용자가 선택한 파일 목록에 지정된 파일을 추가합니다.
CanAddFile(IStorageFile)	사용자가 선택한 파일 목록에 지정된 파일을 추가할 수 있는지 여부를 나타냅니다.
ContainsFile(String)	지정된 파일이 사용자가 선택한 파일 목록에 있는지 여부를 확인합니다.
RemoveFile(String)	사용자가 선택한 파일 목록에서 지정된 파일을 제거합니다.

이벤트

Closing	사용자가 파일 선택기를 닫을 때 발생합니다.
FileRemoved	참고 FileRemoved 이벤트는 더 이상 사용되지 않으며 사용하면 안 됩니다. 사용자가 파일을 제공하는 앱에서 해당 파일을 추가한 경우 사용자가 선택한 파일 목록에서 파일을 제거하면 발생합니다.

추가 정보

• ActivationKind
• WebUIFileOpenPickerActivatedEventArgs
• FileOpenPickerActivatedEventArgs
• 선택기를 사용하여 파일 및 폴더 열기
• 파일 선택기 공급자 샘플