FolderPicker 클래스

FolderPicker Class

사용자가 폴더를 선택할 수 있는 UI 요소를 나타냅니다.

구문


var folderPicker = new Windows.Storage.Pickers.FolderPicker();

특성

[Version(0x06020000)]

멤버

FolderPicker클래스에는 다음과 같은 형식의 멤버가 있습니다.

생성자

FolderPicker클래스에는 다음과 같은 생성자가 있습니다.

생성자Description
FolderPicker Creates a new instance of a FolderPicker.

 

메서드

The FolderPicker 클래스 - 이러한 메서드가 있습니다. C#, Visual Basic 및 C++에서는 다음 위치의 메서드도 상속합니다. Object 클래스.

메서드Description
PickSingleFolderAsync Shows the folderPicker object so that the user can pick a folder.

 

속성

FolderPicker클래스 - 이러한 속성이 있습니다.

속성사용 권한Description

CommitButtonText

읽기/쓰기Gets or sets the label text of the folder picker's commit button.

FileTypeFilter

읽기 전용Gets the collection of file types that the folder picker displays.

SettingsIdentifier

읽기/쓰기Gets or sets the settings identifier associated with the with the current FolderPicker instance.

SuggestedStartLocation

읽기/쓰기Gets or sets the initial location where the folder picker looks for folders to present to the user.

ViewMode

읽기/쓰기Gets or sets the view mode that the folder picker uses to display items.

 

설명

파일 및 폴더 파일 선택기에 대한 액세스를 시작하려면 빠른 시작: 파일 선택기로 파일에 액세스를 참조하십시오.

경고  앱이 맞춰진 동안 파일 선택기를 표시하려고 하면 파일 선택기가 표시되지 않고 예외가 throw됩니다. 파일 선택기를 호출하기 전에 앱이 기본 뷰로 맞춰지지 않았는지 확인하거나 앱을 맞춤 해제하여 이를 방지할 수 있습니다. 다음 코드 예제와 파일 선택기 샘플에서는 방법을 보여 줍니다.

예제

파일 선택기 샘플에서는 앱을 끌어왔는지 여부를 확인하는 방법, 파일 선택기 속성을 설정하는 방법, 그리고 사용자가 앱에서 액세스할 폴더를 선택할 수 있도록 파일 선택기를 표시하는 방법을 보여 줍니다.


// Verify that we are currently not snapped, or that we can unsnap to open the picker
var currentState = Windows.UI.ViewManagement.ApplicationView.value;
if (currentState === Windows.UI.ViewManagement.ApplicationViewState.snapped &&
    !Windows.UI.ViewManagement.ApplicationView.tryUnsnap()) {
    // Fail silently if we can't unsnap
    return;
}

// Create the picker object and set options
var folderPicker = new Windows.Storage.Pickers.FolderPicker;
folderPicker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.desktop;
// Users expect to have a filtered view of their folders depending on the scenario.
// For example, when choosing a documents folder, restrict the filetypes to documents for your application.
folderPicker.fileTypeFilter.replaceAll([".docx", ".xlsx", ".pptx"]);

folderPicker.pickSingleFolderAsync().then(function (folder) {
    if (folder) {
        // Application now has read/write access to all contents in the picked folder (including sub-folder contents)
        // Cache folder so the contents can be accessed at a later time
        Windows.Storage.AccessCache.StorageApplicationPermissions.futureAccessList.addOrReplace("PickedFolderToken", folder);
        WinJS.log && WinJS.log("Picked folder: " + folder.name, "sample", "status");
    } else {
        // The picker was dismissed with no selected file
        WinJS.log && WinJS.log("Operation cancelled.", "sample", "status");
    }
});


C#의 경우 파일 선택기 샘플은 앱이 EnsureUnsnapped 메서드로 기본 뷰에 맞춰졌는지 여부를 확인하는 방법을 보여 줍니다.


internal bool EnsureUnsnapped()
{
    // FilePicker APIs will not work if the application is in a snapped state.
    // If an app wants to show a FilePicker while snapped, it must attempt to unsnap first
    bool unsnapped = ((ApplicationView.Value != ApplicationViewState.Snapped) || ApplicationView.TryUnsnap());
    if (!unsnapped)
    {
        NotifyUser("Cannot unsnap the sample.", NotifyType.StatusMessage);
    }

    return unsnapped;
}


요구 사항

지원되는 최소 클라이언트

Windows 8 [Windows 스토어 앱만]

지원되는 최소 서버

Windows Server 2012 [Windows 스토어 앱만]

Namespace

Windows.Storage.Pickers
Windows::Storage::Pickers [C++]

Metadata

Windows.winmd

참고 항목

파일 선택기 샘플
빠른 시작: 파일 선택기로 파일에 액세스

 

 

표시:
© 2017 Microsoft