FolderPicker 클래스

정의

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

데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 인스턴스를 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 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 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만듭니다.

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

속성

CommitButtonText

폴더 선택기 커밋 단추의 레이블 텍스트를 가져오거나 설정합니다.

ContinuationData

앱이 활성화될 때 컨텍스트를 제공하기 위해 앱을 비활성화하는 작업 전에 PickFolderAndContinue 앱에서 채울 값 집합을 가져옵니다. (Windows Phone 8.x 앱)

FileTypeFilter

폴더 선택기가 표시하는 파일 형식의 컬렉션을 가져옵니다.

SettingsIdentifier

현재 FolderPicker 인스턴스와 연결된 설정 식별자를 가져오거나 설정합니다.

SuggestedStartLocation

폴더 선택기가 사용자에게 표시할 폴더를 찾는 초기 위치를 가져오거나 설정합니다.

User

만들어진 사용자에 대한 FolderPicker 정보를 가져옵니다. 다중 사용자 애플리케이션에 이 속성을 사용합니다.

ViewMode

폴더 선택기에서 항목을 표시하는 데 사용하는 보기 모드를 가져오거나 설정합니다.

메서드

CreateForUser(User)

FolderPicker 지정된 사용자의 개인 디렉터리로 범위가 지정된 해당 디렉터리를 만듭니다. 다중 사용자 애플리케이션에 이 메서드를 사용합니다.

PickFolderAndContinue()

Windows 10 현재 사용되지 않습니다. 대신 PickSingleFolderAsync를 사용합니다. 사용자가 폴더를 선택하고, 비활성화하고, 앱을 비활성화하고, 작업이 완료되면 다시 활성화할 수 있도록 파일 선택기를 표시합니다. (Windows Phone 8.x 앱)

PickSingleFolderAsync()

사용자가 폴더를 folderPicker 선택할 수 있도록 개체를 표시합니다. (UWP 앱)

참고

이 메서드를 FileTypeFilter 호출하기 전에 지정해야 합니다. 그렇지 않으면 예외가 throw됩니다. 모든 폴더를 나열하려면 필터로 "*"를 사용합니다.

적용 대상

추가 정보