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