Compartir a través de


ProtocolActivatedEventArgs Clase

Definición

Proporciona datos cuando se activa una aplicación porque es la aplicación asociada a un nombre de esquema de URI.

Javascript Este tipo aparece como WebUIProtocolActivatedEventArgs.

public ref class ProtocolActivatedEventArgs sealed : IApplicationViewActivatedEventArgs, IProtocolActivatedEventArgs, IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndData, IViewSwitcherProvider
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 : 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 : 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 IApplicationViewActivatedEventArgs, IProtocolActivatedEventArgs, IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndData, IViewSwitcherProvider
Public NotInheritable Class ProtocolActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IProtocolActivatedEventArgs, IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndData, IViewSwitcherProvider
Herencia
Object Platform::Object IInspectable ProtocolActivatedEventArgs
Atributos
Implementaciones

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

El controlador de eventos OnActivated recibe todos los eventos de activación. La propiedad indica el tipo de evento de activación. En este ejemplo se configura para controlar los eventos de activación 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
   } 
}

Comentarios

Se tiene acceso a este objeto cuando se implementa un controlador de eventos para responder a eventos activados cuando ActivationKind es Protocolo.

La aplicación para UWP que usa C++, C# o Visual Basic suele implementar puntos de activación reemplazando los métodos del objeto Application . Los archivos de código subyacente de la plantilla predeterminada app.xaml siempre incluyen una invalidación para OnLaunched, pero definir invalidaciones para otros puntos de activación, como OnActivated , depende del código de la aplicación. Si ActivationKind es Protocol , el IActivatedEventArgs con tipo de interfaz de OnActivated se puede convertir a ProtocolActivatedEventArgs.

Todas las invalidaciones de aplicación implicadas en un escenario de activación deben llamar a Window.Activate en sus implementaciones.

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1607 14393 Usuario

Propiedades

CallerPackageFamilyName

Obtiene el nombre de familia del paquete de la aplicación que activó la aplicación actual.

CurrentlyShownApplicationViewId

Obtiene el identificador de la vista de aplicación que se muestra actualmente.

Data

Datos recibidos de la aplicación que activó la aplicación actual.

Kind

Obtiene el tipo de activación.

PreviousExecutionState

Obtiene el estado de ejecución de la aplicación antes de activarla.

SplashScreen

Obtiene el objeto de pantalla de presentación que proporciona información sobre la transición de la pantalla de presentación a la aplicación activada.

Uri

Obtiene el identificador uniforme de recursos (URI) para el que se activó la aplicación.

User

Obtiene el usuario para el que se activó la aplicación.

ViewSwitcher

Obtiene el objeto modificador de vista que permite establecer la vista para la aplicación.

Se aplica a

Consulte también