Bagikan melalui


ProtocolActivatedEventArgs Kelas

Definisi

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 : 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
Warisan
Object Platform::Object IInspectable ProtocolActivatedEventArgs
Atribut
Penerapan

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.

Berlaku untuk

Lihat juga