ProtocolActivatedEventArgs Kelas

Definisi

Ruang nama:

Windows.ApplicationModel.Activation

Menyediakan data saat aplikasi diaktifkan karena ini adalah aplikasi yang terkait dengan nama skema URI.

Javascript Jenis ini muncul sebagai 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

Warisan

Object Platform::Object IInspectable ProtocolActivatedEventArgs

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute

Penerapan

IActivatedEventArgs IApplicationViewActivatedEventArgs IProtocolActivatedEventArgs IProtocolActivatedEventArgsWithCallerPackageFamilyNameAndData IViewSwitcherProvider IActivatedEventArgsWithUser

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Penanganan aktivitas Aktif menerima semua peristiwa aktivasi. Properti menunjukkan jenis peristiwa aktivasi. Contoh ini disiapkan untuk menangani peristiwa aktivasi 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
   } 
}

Keterangan

Objek ini diakses ketika Anda mengimplementasikan penanganan aktivitas untuk merespons peristiwa diaktifkan ketika ActivationKind adalah Protokol.

Aplikasi UWP menggunakan C++, C#, atau Visual Basic biasanya menerapkan titik aktivasi dengan menimpa metode objek Aplikasi . File app.xaml code-behind templat default selalu menyertakan penimpaan untuk OnLaunched, tetapi menentukan penimpaan untuk titik aktivasi lain seperti OnActivated terserah kode aplikasi Anda. Jika ActivationKind adalah Protokol , maka IActivatedEventArgs yang diketik antarmuka dari OnActivated dapat ditransmisikan ke ProtocolActivatedEventArgs.

Semua penimpaan Aplikasi yang terlibat dalam skenario aktivasi harus memanggil Window.Activate dalam implementasinya.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1607	14393	Pengguna

Properti

CallerPackageFamilyName	Mendapatkan nama keluarga paket aplikasi yang mengaktifkan aplikasi saat ini.
CurrentlyShownApplicationViewId	Mendapatkan pengidentifikasi untuk tampilan aplikasi yang ditampilkan saat ini.
Data	Data yang diterima dari aplikasi yang mengaktifkan aplikasi saat ini.
Kind	Mendapatkan jenis aktivasi.
PreviousExecutionState	Mendapatkan status eksekusi aplikasi sebelum diaktifkan.
SplashScreen	Mendapatkan objek layar splash yang menyediakan informasi tentang transisi dari layar splash ke aplikasi yang diaktifkan.
Uri	Mendapatkan Pengidentifikasi Sumber Daya Seragam (URI) tempat aplikasi diaktifkan.
User	Mendapatkan pengguna tempat aplikasi diaktifkan.
ViewSwitcher	Mendapatkan objek pengalih tampilan yang memungkinkan Anda mengatur tampilan untuk aplikasi.

Lihat juga

• Activated
• OnActivated(IActivatedEventArgs)
• Uri
• Sampel peluncuran asosiasi
• Menangani sampel Tindakan Kontak
• Menangani aktivasi URI
• Mulai cepat: Menangani tindakan kontak
• Panduan untuk jenis file dan URI
• Sampel peluncuran asosiasi (Windows 10)