FileActivatedEventArgs Класс

Определение

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

Windows.ApplicationModel.Activation

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

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

public ref class FileActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

Public NotInheritable Class FileActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

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

Object Platform::Object IInspectable FileActivatedEventArgs

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Реализации

IActivatedEventArgs IApplicationViewActivatedEventArgs IFileActivatedEventArgs IFileActivatedEventArgsWithCallerPackageFamilyName IFileActivatedEventArgsWithNeighboringFiles IViewSwitcherProvider IActivatedEventArgsWithUser

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

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

Обработчик событий OnFileActivated в объекте Application получает все события активации файлов.

protected override void OnFileActivated(FileActivatedEventArgs args)
{
       // TODO: Handle file activation

       // The number of files received is args.Files.Size
       // The first file is args.Files[0].Name
}

Private Sub OnFileActivated(ByVal args As Windows.ApplicationModel.Activation.FileActivatedEventArgs)
      ' TODO: Handle file activation

      ' The number of files received is args.Files.Size
      ' The first file is args.Files(0).Name
End Sub

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs const& /* args */)
{
    // TODO: Handle file activation.

    // The number of files received is args.Files().Size().
    // The first file is args.Files().GetAt(0).Name().
}

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs^ args)
{
       // TODO: Handle file activation

       // The number of files received is args->Files->Size
       // The first file is args->Files->GetAt(0)->Name
}

Комментарии

Доступ к этому объекту осуществляется при реализации обработчика событий для реагирования на события Activated , когда ActivationKind имеет значение File.

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

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

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

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

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

Свойства

CallerPackageFamilyName	Имя семейства пакетов приложения, которое запустило приложение.
CurrentlyShownApplicationViewId	Возвращает идентификатор текущего представления приложения.
Files	Возвращает файлы, для которых было активировано приложение.
Kind	Возвращает тип активации.
NeighboringFilesQuery	Возвращает соседние файлы файлов, для которых было активировано приложение.
PreviousExecutionState	Возвращает состояние выполнения приложения до его активации.
SplashScreen	Возвращает объект экрана-заставки, предоставляющий сведения о переходе с экрана-заставки на активированное приложение.
User	Возвращает пользователя, для которому было активировано приложение.
Verb	Возвращает действие, связанное с активированным файлом.
ViewSwitcher	Предоставляет объект , позволяющий задать представление для приложения.

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

• Windows.Storage
• Activated
• OnFileActivated(FileActivatedEventArgs)
• Пример запуска с сопоставлением
• Обработка активации файла
• Руководство по типам файлов и URI
• Пример запуска связи (Windows 10)