FolderPicker Класс

Определение

Пространство имен:

Windows.Storage.Pickers

Представляет элемент пользовательского интерфейса, позволяющий пользователю выбирать папки.

В классическом приложении перед использованием экземпляра этого класса таким образом, чтобы отображать пользовательский интерфейс, необходимо связать объект с дескриптором окна владельца. Дополнительные сведения и примеры кода см. в статье Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.

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. В классическом приложении перед использованием экземпляра этого класса таким образом, чтобы отображать пользовательский интерфейс, необходимо связать объект с дескриптором окна владельца. Дополнительные сведения и примеры кода см. в статье Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.

Свойства

Имя	Описание
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 , иначе он вызовет исключение. Чтобы получить список всех папок, используйте "*" в качестве фильтра.

См. также раздел

• Пример средства выбора файлов
• Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow