ProtocolActivatedEventArgs Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.Activation

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 : 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

Herencia

Object Platform::Object IInspectable ProtocolActivatedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementaciones

IActivatedEventArgs IApplicationViewActivatedEventArgs IProtocolActivatedEventArgs IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndData IViewSwitcherProvider IActivatedEventArgsWithUser

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.

Consulte también

• Activated
• OnActivated(IActivatedEventArgs)
• Uri
• Ejemplo de inicio por asociación
• Ejemplo de control de las acciones de contacto
• Controlar la activación de URI
• Inicio rápido: Control de acciones de contacto
• Directrices sobre tipos de archivo y URI
• Ejemplo de inicio de asociación (Windows 10)