FolderPicker Class

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

Синтаксис


Public NotInheritable Class FolderPicker

Атрибуты

[Version(0x06020000)]

Члены

FolderPickerКласс имеет следующие типы членов:

Конструкторы

FolderPickerКласс имеет эти конструкторы.

КонструкторОписание
FolderPicker Creates a new instance of a FolderPicker.

 

Методы

The FolderPicker Класс имеет следующие методы. В C#, Visual Basic и C++ также наследует методы от Object Класс.

МетодОписание
PickSingleFolderAsync Shows the folderPicker object so that the user can pick a folder.

 

Свойства

FolderPickerКласс имеет следующие свойства.

СвойствоТип доступаОписание

CommitButtonText

Чтение и записьGets or sets the label text of the folder picker's commit button.

FileTypeFilter

Только для чтенияGets the collection of file types that the folder picker displays.

SettingsIdentifier

Чтение и записьGets or sets the settings identifier associated with the with the current FolderPicker instance.

SuggestedStartLocation

Чтение и записьGets or sets the initial location where the folder picker looks for folders to present to the user.

ViewMode

Чтение и записьGets or sets the view mode that the folder picker uses to display items.

 

Примечания

Чтобы научиться осуществлять доступ к файлам и папкам с помощью средств выбора файлов, см. раздел Краткое руководство. Доступ к файлам с помощью средства выбора файлов.

Предупреждение  Если попытаться отобразить средство выбора файлов при прикрепленном приложении, средство выбора файлов не открывается и выдается исключение. Этого можно избежать, убедившись, что приложение не прикреплено, или отменив прикрепление приложения перед вызовом средства выбора файлов. Как это сделать, показано в следующих примерах кода и в примере средства выбора файлов.

Примеры

В примере средства выбора файлов демонстрируется, как проверить, прикреплено ли приложение, как задать свойства средства выбора файлов, а также как отобразить средство выбора файлов, чтобы пользователь мог выбрать папку, к которой должно получить доступ приложение.

В настоящее время язык не поддерживается либо пример кода отсутствует.

Для C# Пример средства выбора файлов показывает, как проверить, прикреплено ли приложение в методе EnsureUnsnapped.


internal bool EnsureUnsnapped()
{
    // FilePicker APIs will not work if the application is in a snapped state.
    // If an app wants to show a FilePicker while snapped, it must attempt to unsnap first
    bool unsnapped = ((ApplicationView.Value != ApplicationViewState.Snapped) || ApplicationView.TryUnsnap());
    if (!unsnapped)
    {
        NotifyUser("Cannot unsnap the sample.", NotifyType.StatusMessage);
    }

    return unsnapped;
}


Требования

Минимальный поддерживаемый клиент

Windows 8 [Только приложения для Магазина Windows]

Минимальный поддерживаемый сервер

Windows Server 2012 [Только приложения для Магазина Windows]

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

Windows.Storage.Pickers
Windows::Storage::Pickers [C++]

Metadata

Windows.winmd

См. также

Пример средства выбора файлов
Краткое руководство. Доступ к файлам с помощью средства выбора файлов

 

 

Показ:
© 2015 Microsoft