FileOpenPickerActivatedEventArgs Класс

Определение

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

Javascript Этот тип отображается как WebUIFileOpenPickerActivatedEventArgs.

public ref class FileOpenPickerActivatedEventArgs sealed : IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
public ref class FileOpenPickerActivatedEventArgs sealed : IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileOpenPickerActivatedEventArgs final : IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileOpenPickerActivatedEventArgs final : IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileOpenPickerActivatedEventArgs : IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileOpenPickerActivatedEventArgs : IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
Public NotInheritable Class FileOpenPickerActivatedEventArgs
Implements IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
Public NotInheritable Class FileOpenPickerActivatedEventArgs
Implements IActivatedEventArgsWithUser, IFileOpenPickerActivatedEventArgs, IFileOpenPickerActivatedEventArgs2
Наследование
Object Platform::Object IInspectable FileOpenPickerActivatedEventArgs
Атрибуты
Реализации

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
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 для переопределения OnFileOpenPickerActivated ссылается на объект FileOpenPickerActivatedEventArgs. Переопределение OnFileOpenPickerActivated находится в файле App.xaml.cs, а Activate метод — в файле FileOpenPickerPage.xaml.cs примера контрактов средства выбора файлов.

Комментарии

Узнайте, как предоставить файлы, которые пользователь может выбрать в приложении, в статье Краткое руководство. Предоставление файловой службы с помощью и в справочнике по пространству имен Windows.Storage.Pickers.Provider .

Объект FileOpenPickerActivatedEventArgs передается обработчику активированных событий приложения, когда пользователь хочет выбрать файлы или папки, предоставляемые приложением. Этот тип активации обозначается значением ActivationKind.FileOpenPicker , возвращаемым свойством Kind .

Приложения, написанные на JavaScript, должны прослушивать и обрабатывать события Windows.UI.WebUI.webUIApplication.activated .

Приложение UWP, использующее C++, C# или Visual Basic, обычно реализует точки активации путем переопределения методов объекта Application . Файлы кода программной части app.xaml по умолчанию всегда содержат переопределение для OnLaunched, но определение переопределений для других точек активации, таких как OnFileOpenPickerActivated , зависит от кода приложения.

Все переопределения приложений , участвующие в сценарии активации, должны вызывать Window.Activate в своих реализациях.

Журнал версий

Версия Windows Версия пакета SDK Добавленная стоимость
1607 14393 Пользователь

Свойства

CallerPackageFamilyName

Имя семейства пакетов приложения, которое запустило приложение.

FileOpenPickerUI

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

Kind

Возвращает тип активации.

PreviousExecutionState

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

SplashScreen

Возвращает объект SplashScreen , предоставляющий сведения о переходе с экрана-заставки на активированное приложение.

User

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

Применяется к

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