다음을 통해 공유


FolderPicker 클래스

정의

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

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

public ref class FolderPicker sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FolderPicker final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class FolderPicker final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FolderPicker
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class FolderPicker
[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
특성

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됩니다. 모든 폴더를 나열하려면 필터로 "*"를 사용합니다.

적용 대상

추가 정보