내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

FileOpenPicker Class

사용자가 파일을 선택하고 열 수 있는 UI 요소를 나타냅니다.

구문


var fileOpenPicker = new Windows.Storage.Pickers.FileOpenPicker();

특성

[Muse()]
[Version(0x06020000)]

멤버

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

생성자

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

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

 

메서드

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

메서드Description
PickMultipleFilesAsync Shows the file picker so that the user can pick multiple files.
PickSingleFileAsync Shows the file picker so that the user can pick one file.

 

속성

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

속성사용 권한Description

CommitButtonText

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

FileTypeFilter

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

SettingsIdentifier

읽기/쓰기Gets or sets the settings identifier associated with the state of the file open picker.

SuggestedStartLocation

읽기/쓰기Gets or sets the initial location where the file open picker looks for files to present to the user.

ViewMode

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

 

설명

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

중요   Windows 8에서 앱이 기본 뷰로 맞춰져 있을 때 파일 선택기를 표시하려고 하면 파일 선택기가 표시되지 않고 예외가 throw됩니다. 파일 선택기를 호출하기 전에 앱이 기본 뷰로 맞춰지지 않았는지 확인하거나 앱을 맞춤 해제하여 이를 방지할 수 있습니다. 다음 코드 예제와 파일 선택기 샘플에서는 방법을 보여 줍니다. Windows 8.1에서는 특정 사이드 창 크기를 정의하지 않습니다. 대신, 사용자는 최소값까지 모든 너비로 앱 크기를 조정할 수 있습니다. 따라서 앱이 Windows 8.1에만 배포되는 경우 이 항목의 예제 코드에서 EnsureUnsnapped 함수 및 함수 호출을 무시할 수 있습니다.

Windows Phone 8

이 API는 네이티브 앱에서만 지원됩니다.

예제

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


// 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 openPicker = new Windows.Storage.Pickers.FileOpenPicker();
openPicker.viewMode = Windows.Storage.Pickers.PickerViewMode.thumbnail;
openPicker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.picturesLibrary;
// 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.
openPicker.fileTypeFilter.replaceAll([".png", ".jpg", ".jpeg"]);

// Open the picker for the user to pick a file
openPicker.pickSingleFileAsync().then(function (file) {
    if (file) {
        // Application now has read/write access to the picked file
        WinJS.log && WinJS.log("Picked photo: " + file.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;
}


파일 선택기 샘플에서는 사용자가 여러 파일을 선택할 수 있도록 파일 선택기를 표시하는 방법도 보여 줍니다.

참고  앱이 기본 뷰로 맞춰지지 않았는지 또는 맞춤 해제될 수 있는지를 항상 확인하고 사용자가 파일을 하나만 선택하는지 여러 개 선택하는지에 관계없이 파일 선택기 속성을 설정해야 합니다.


openPicker.pickMultipleFilesAsync().then(function (files) {
    if (files.size > 0) {
        // Application now has read/write access to the picked file(s)
        var outputString = "Picked files:\n";
        for (var i = 0; i < files.size; i++) {
            outputString = outputString + files[i].name + "\n";
        }
        WinJS.log && WinJS.log(outputString, "sample", "status");
    } else {
        // The picker was dismissed with no selected file
        WinJS.log && WinJS.log("Operation cancelled.", "sample", "status");
    }
});


Windows Phone의 파일 선택기를 사용할 수도 있습니다. 다음은 C++ 예제입니다. Windows Phone에서 FileOpenPicker는 네이티브 앱에서만 지원됩니다.


FileOpenPicker^ openPicker = ref new FileOpenPicker(); 
openPicker->ViewMode = PickerViewMode::Thumbnail; 
openPicker->SuggestedStartLocation = PickerLocationId::PicturesLibrary; 
openPicker->FileTypeFilter->Append("*"); 
   
create_task(openPicker->PickSingleFileAsync()).then([this](StorageFile^ file) 
{
    if (file) 
    { 
        m_PickedFileName = file->Name; 
    } 
    else 
    { 
        // Operation cancelled.
    } 
});


요구 사항

지원되는 최소 클라이언트

Windows 8 [Windows 스토어 앱만]

지원되는 최소 서버

Windows Server 2012 [Windows 스토어 앱만]

지원되는 최소 전화

Windows Phone 8

Namespace

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

Metadata

Windows.winmd

참고 항목

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

 

 

Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2014 Microsoft