ProtocolActivatedEventArgs Класс

Определение

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

Windows.ApplicationModel.Activation

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

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

public ref class ProtocolActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IProtocolActivatedEventArgs, IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndData, IViewSwitcherProvider

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ProtocolActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IProtocolActivatedEventArgs, IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndData, IViewSwitcherProvider

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ProtocolActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IProtocolActivatedEventArgs, IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndData, IViewSwitcherProvider

Public NotInheritable Class ProtocolActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IProtocolActivatedEventArgs, IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndData, IViewSwitcherProvider

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

Object Platform::Object IInspectable ProtocolActivatedEventArgs

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Реализации

IActivatedEventArgs IApplicationViewActivatedEventArgs IProtocolActivatedEventArgs IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndData IViewSwitcherProvider IActivatedEventArgsWithUser

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

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

Примеры

Обработчик событий OnActivated принимает все события активации. Свойство указывает тип события активации. Этот пример настроен для обработки событий активации URI .

public partial class App
{
   protected override void OnActivated(IActivatedEventArgs args)
   {
      if (args.Kind == ActivationKind.Protocol)
      {
         ProtocolActivatedEventArgs eventArgs = args as ProtocolActivatedEventArgs;

         // TODO: Handle URI activation
         // The received URI is eventArgs.Uri.AbsoluteUri
      }
   }
}

Private Sub OnFileActivated(ByVal args As Windows.ApplicationModel.Activation.IActivatedEventArgs)
   If args.Kind = ActivationKind.Protocol Then
      ProtocolActivatedEventArgs eventArgs = args As ProtocolActivatedEventArgs

      ' TODO: Handle URI activation
      ' The received URI is eventArgs.Uri.AbsoluteUri
   End If
End Sub

void App::OnActivated(Windows::ApplicationModel::Activation::IActivatedEventArgs const& args)
{
    if (args.Kind() == Windows::ApplicationModel::Activation::ActivationKind::Protocol)
    {
        auto eventArgs{ args.as<Windows::ApplicationModel::Activation::ProtocolActivatedEventArgs>() };

        // TODO: Handle URI activation.
        // The received URI is eventArgs.Uri().RawUri().
    }
}

void App::OnActivated(Windows::ApplicationModel::Activation::IActivatedEventArgs^ args)
{
   if (args->Kind == Windows::ApplicationModel::Activation::ActivationKind::Protocol)
   {
      Windows::ApplicationModel::Activation::ProtocolActivatedEventArgs^ eventArgs = 
          dynamic_cast<Windows::ApplicationModel::Activation::ProtocolActivatedEventArgs^>(args);

      // TODO: Handle URI activation  
      // The received URI is eventArgs->Uri->RawUri
   } 
}

Комментарии

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

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

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

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

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

Свойства

CallerPackageFamilyName	Возвращает имя семейства пакетов приложения, которое активировало текущее приложение.
CurrentlyShownApplicationViewId	Возвращает идентификатор текущего представления приложения.
Data	Данные, полученные от приложения, которое активировало текущее приложение.
Kind	Возвращает тип активации.
PreviousExecutionState	Возвращает состояние выполнения приложения до его активации.
SplashScreen	Возвращает объект экрана-заставки, предоставляющий сведения о переходе с экрана-заставки на активированное приложение.
Uri	Возвращает универсальный код ресурса (URI), для которого было активировано приложение.
User	Возвращает пользователя, для которому было активировано приложение.
ViewSwitcher	Возвращает объект переключателя представлений, позволяющий задать представление для приложения.

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

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