ProtocolActivatedEventArgs Classe

Definição

Namespace:

Windows.ApplicationModel.Activation

Fornece dados quando um aplicativo é ativado porque é o aplicativo associado a um nome de esquema de URI.

Javascript Esse tipo aparece como 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

Herança

Object Platform::Object IInspectable ProtocolActivatedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

IActivatedEventArgs IApplicationViewActivatedEventArgs IProtocolActivatedEventArgs IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndData IViewSwitcherProvider IActivatedEventArgsWithUser

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O manipulador de eventos OnActivated recebe todos os eventos de ativação. A propriedade indica o tipo de evento de ativação. Este exemplo é configurado para manipular eventos de ativação de 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
   } 
}

Comentários

Esse objeto é acessado quando você implementa um manipulador de eventos para responder a eventos ativados quando ActivationKind é Protocol.

O aplicativo UWP usando C++, C# ou Visual Basic normalmente implementa pontos de ativação substituindo métodos do objeto Application . Os arquivos code-behind do modelo padrão app.xaml sempre incluem uma substituição para OnLaunched, mas definir substituições para outros pontos de ativação, como OnActivated , depende do código do aplicativo. Se ActivationKind for Protocol , os IActivatedEventArgs do tipo interface de OnActivated poderão ser convertidos em ProtocolActivatedEventArgs.

Todas as substituições de aplicativo envolvidas em um cenário de ativação devem chamar Window.Activate em suas implementações.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	Usuário

Propriedades

CallerPackageFamilyName	Obtém o nome da família de pacotes do aplicativo que ativou o aplicativo atual.
CurrentlyShownApplicationViewId	Obtém o identificador para a exibição de aplicativo mostrada no momento.
Data	Dados recebidos do aplicativo que ativou o aplicativo atual.
Kind	Obtém o tipo de ativação.
PreviousExecutionState	Obtém o estado de execução do aplicativo antes de ser ativado.
SplashScreen	Obtém o objeto de tela inicial que fornece informações sobre a transição da tela inicial para o aplicativo ativado.
Uri	Obtém o URI (Uniform Resource Identifier) para o qual o aplicativo foi ativado.
User	Obtém o usuário para o qual o aplicativo foi ativado.
ViewSwitcher	Obtém o objeto do alternador de exibição que permite definir o modo de exibição para o aplicativo.

Confira também

• Activated
• OnActivated(IActivatedEventArgs)
• Uri
• Amostra de inicialização de associação
• Amostra de manipulação de ações de contato
• Tratar a ativação do URI
• Início Rápido: Manipulando ações de contato
• Diretrizes para tipos de arquivos e URIs
• Exemplo de inicialização de associação (Windows 10)