ProtocolActivatedEventArgs Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Activation

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

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.

Vedi anche

• Activated
• OnActivated(IActivatedEventArgs)
• Uri
• Esempio di avvio di associazione
• Esempio di gestione delle azioni sui contatti
• Gestire l'attivazione di URI
• Guida introduttiva: Gestione delle azioni di contatto
• Linee guida per tipi di file e URI
• Esempio di avvio dell'associazione (Windows 10)