ProtocolActivatedEventArgs Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.ApplicationModel.Activation
Modifica

Fornisce i dati quando un'app viene attivata perché è l'app associata a un nome di schema URI.

Javascript Questo tipo viene visualizzato come 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
Ereditarietà
Object Platform::Object IInspectable ProtocolActivatedEventArgs
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute
Implementazioni
IActivatedEventArgs IApplicationViewActivatedEventArgs IProtocolActivatedEventArgs IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndData IViewSwitcherProvider IActivatedEventArgsWithUser

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Il gestore dell’evento OnActivated riceve tutti gli eventi di attivazione. La proprietà indica il tipo di evento di attivazione. Questo esempio è configurato per gestire gli eventi di attivazione 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
   } 
}

Commenti

Questo oggetto è accessibile quando si implementa un gestore eventi per rispondere agli eventi Activated quando ActivationKind è Protocol.

L'app UWP che usa C++, C# o Visual Basic implementa in genere i punti di attivazione eseguendo l'override dei metodi dell'oggetto Application . I file code-behind app.xaml predefiniti includono sempre un override per OnLaunched, ma la definizione degli override per altri punti di attivazione, ad esempio OnActivated , è fino al codice dell'app. Se ActivationKind è Protocol , è possibile eseguire il cast di IActivatedEventArgs con interfaccia da OnActivated a ProtocolActivatedEventArgs.

Tutte le sostituzioni dell'applicazione coinvolte in uno scenario di attivazione devono chiamare Window.Activate nelle implementazioni.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1607 14393 Utente

Proprietà

CallerPackageFamilyName

Ottiene il nome della famiglia di pacchetti dell'applicazione che ha attivato l'applicazione corrente.
CurrentlyShownApplicationViewId

Ottiene l'identificatore per la visualizzazione dell'app attualmente visualizzata.
Data

Dati ricevuti dall'applicazione che ha attivato l'applicazione corrente.
Kind

Ottiene il tipo di attivazione.
PreviousExecutionState

Ottiene lo stato di esecuzione dell'app prima dell'attivazione.
SplashScreen

Ottiene l'oggetto schermata iniziale che fornisce informazioni sulla transizione dalla schermata iniziale all'app attivata.
Uri

Ottiene l'URI (Uniform Resource Identifier) per il quale l'app è stata attivata.
User

Ottiene l'utente per cui è stata attivata l'app.
ViewSwitcher

Ottiene l'oggetto switcher di visualizzazione che consente di impostare la visualizzazione per l'applicazione.

Si applica a

Vedi anche