FolderPicker 클래스

정의

네임스페이스:

Windows.Storage.Pickers

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

데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요.

public ref class FolderPicker sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FolderPicker final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class FolderPicker

function FolderPicker()

Public NotInheritable Class FolderPicker

상속

Object Platform::Object IInspectable FolderPicker

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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에서 도입되었습니다.)

설명

선택기를 사용하여 파일 및 폴더에 액세스하기 시작하려면 선택기로 파일 및 폴더 열기를 참조하세요.

버전 기록

Windows 버전	SDK 버전	추가된 값
1903	18362	CreateForUser
1903	18362	사용자

생성자

FolderPicker()

FolderPicker의 새 instance 만듭니다. 데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요.

속성

CommitButtonText	폴더 선택기 커밋 단추의 레이블 텍스트를 가져오거나 설정합니다.
ContinuationData	앱이 활성화될 때 컨텍스트를 제공하기 위해 앱을 비활성화하는 PickFolderAndContinue 작업 전에 앱에서 채울 값 집합을 가져옵니다. (Windows Phone 8.x 앱)
FileTypeFilter	폴더 선택기가 표시하는 파일 형식의 컬렉션을 가져옵니다.
SettingsIdentifier	현재 FolderPicker instance 와 연결된 설정 식별자를 가져오거나 설정합니다.
SuggestedStartLocation	폴더 선택기에서 사용자에게 표시할 폴더를 찾는 초기 위치를 가져오거나 설정합니다.
User	FolderPicker를 만든 사용자에 대한 정보를 가져옵니다. 다중 사용자 애플리케이션에 이 속성을 사용합니다.
ViewMode	폴더 선택기가 항목을 표시하는 데 사용하는 보기 모드를 가져오거나 설정합니다.

메서드

CreateForUser(User)	지정한 사용자의 개인 디렉터리로 범위가 지정된 FolderPicker 를 만듭니다. 다중 사용자 애플리케이션에 이 메서드를 사용합니다.
PickFolderAndContinue()	Windows 10 현재 사용되지 않습니다. 대신 PickSingleFolderAsync를 사용합니다. 사용자가 폴더를 선택하고, 비활성화하고, 앱을 비활성화하고, 작업이 완료되면 다시 활성화할 수 있도록 파일 선택기를 표시합니다. (Windows Phone 8.x 앱)
PickSingleFolderAsync()	사용자가 폴더를 선택할 수 있도록 folderPicker 개체를 표시합니다. (UWP 앱) 참고 이 메서드를 호출하기 전에 FileTypeFilter 를 지정해야 합니다. 그렇지 않으면 예외가 throw됩니다. 모든 폴더를 나열하려면 필터로 "*"를 사용합니다.

추가 정보

• 파일 선택기 샘플
• CoreWindow에 의존하는 WinRT UI 개체 표시