FileOpenPickerUI Класс

Определение

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

Windows.Storage.Pickers.Provider

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

public ref class FileOpenPickerUI sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FileOpenPickerUI final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FileOpenPickerUI

Public NotInheritable Class FileOpenPickerUI

Наследование

Object Platform::Object IInspectable FileOpenPickerUI

Атрибуты

ContractVersionAttribute

Требования к 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)

Примеры

В примере поставщика средства выбора файлов показано, как реагировать на событие активации FileOpenPicker.

// File open picker activated event handler
protected override void OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs args)
{
    var FileOpenPickerPage = new SDKTemplate.FileOpenPickerPage();
    FileOpenPickerPage.Activate(args);
}

// Overloaded method to respond to fileOpenPicker events
public void Activate(FileOpenPickerActivatedEventArgs args)
{
    // Perform tasks to prepare your app to display its file picker page

    // Get file picker UI
    fileOpenPickerUI = args.FileOpenPickerUI;

    Window.Current.Content = this;
    this.OnNavigatedTo(null);
    Window.Current.Activate();
}

Для C# args содержит объект FileOpenPickerActivatedEventArgs . Кроме того, объект находится в файле App.xaml.cs, OnFileOpenPickerActivated а Activate метод — в файле FileOpenPickerPage.xaml.cs примера поставщика средства выбора файлов.

Комментарии

Если приложение участвует в контракте средства выбора открытия файлов, этот объект можно получить с помощью свойства FileOpenPickerUI при обработке события активации FileOpenPicker .

Используйте свойство Windows.ApplicationModel.Activation.FileOpenPickerActivatedEventArgs.FileOpenPickerUI для доступа к FileOpenPickerUI.

Узнайте, как создать хороший интерфейс для пользователей при доступе к файлам через средство выбора файлов, прочитав рекомендации по пользовательскому интерфейсу по предоставлению файлов в разделе Открытие файлов и папок с помощью средства выбора.

Свойства

AllowedFileTypes	Возвращает список типов файлов (расширений), которые может выбрать пользователь.
SelectionMode	Возвращает значение перечисления, указывающее, ограничивает ли средство выбора файлов выделение одними файлами или можно ли выбрать несколько файлов.
SettingsIdentifier	Возвращает идентификатор для текущего контекста средства выбора файлов.
Title	Возвращает или задает заголовок, отображаемый в пользовательском интерфейсе средства выбора файлов, который определяет расположение, которое средство выбора файлов отображает пользователю.

Методы

AddFile(String, IStorageFile)	Добавляет указанный файл в список файлов, выбранных пользователем.
CanAddFile(IStorageFile)	Указывает, можно ли добавить указанный файл в список файлов, выбранных пользователем.
ContainsFile(String)	Определяет, входит ли указанный файл в список файлов, выбранных пользователем.
RemoveFile(String)	Удаляет указанный файл из списка файлов, выбранных пользователем.

События

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

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

• ActivationKind
• WebUIFileOpenPickerActivatedEventArgs
• FileOpenPickerActivatedEventArgs
• Открытие файлов и папок с помощью средства выбора
• Пример поставщика средства выбора файлов