FileActivatedEventArgs Kelas

Definisi

Ruang nama:

Windows.ApplicationModel.Activation

Menyediakan data saat aplikasi diaktifkan karena ini adalah aplikasi yang terkait dengan file.

Javascript Jenis ini muncul sebagai WebUIFileActivatedEventArgs.

public ref class FileActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FileActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FileActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

Public NotInheritable Class FileActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, IFileActivatedEventArgsWithCallerPackageFamilyName, IFileActivatedEventArgsWithNeighboringFiles, IViewSwitcherProvider

Warisan

Object Platform::Object IInspectable FileActivatedEventArgs

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute

Penerapan

IActivatedEventArgs IApplicationViewActivatedEventArgs IFileActivatedEventArgs IFileActivatedEventArgsWithCallerPackageFamilyName IFileActivatedEventArgsWithNeighboringFiles 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 OnFileActivated pada objek Aplikasi menerima semua peristiwa aktivasi file.

protected override void OnFileActivated(FileActivatedEventArgs args)
{
       // TODO: Handle file activation

       // The number of files received is args.Files.Size
       // The first file is args.Files[0].Name
}

Private Sub OnFileActivated(ByVal args As Windows.ApplicationModel.Activation.FileActivatedEventArgs)
      ' TODO: Handle file activation

      ' The number of files received is args.Files.Size
      ' The first file is args.Files(0).Name
End Sub

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs const& /* args */)
{
    // TODO: Handle file activation.

    // The number of files received is args.Files().Size().
    // The first file is args.Files().GetAt(0).Name().
}

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs^ args)
{
       // TODO: Handle file activation

       // The number of files received is args->Files->Size
       // The first file is args->Files->GetAt(0)->Name
}

Keterangan

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

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 OnFileActivated terserah kode aplikasi Anda.

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

Perhatikan bahwa saat aplikasi diaktifkan untuk kontrak file, Anda harus mengakses data menggunakan objek StorageFile yang diteruskan ke aplikasi Anda melalui properti File . Anda tidak boleh mencoba mengakses jalur file karena aplikasi Anda mungkin tidak memiliki izin ke lokasi file.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1607	14393	Pengguna

Properti

CallerPackageFamilyName	Nama keluarga paket aplikasi yang meluncurkan aplikasi Anda.
CurrentlyShownApplicationViewId	Mendapatkan pengidentifikasi untuk tampilan aplikasi yang ditampilkan saat ini.
Files	Mendapatkan file tempat aplikasi diaktifkan.
Kind	Mendapatkan jenis aktivasi.
NeighboringFilesQuery	Mendapatkan file tetangga dari file tempat aplikasi diaktifkan.
PreviousExecutionState	Mendapatkan status eksekusi aplikasi sebelum diaktifkan.
SplashScreen	Mendapatkan objek layar splash yang menyediakan informasi tentang transisi dari layar splash ke aplikasi yang diaktifkan.
User	Mendapatkan pengguna tempat aplikasi diaktifkan.
Verb	Mendapatkan tindakan yang terkait dengan file yang diaktifkan.
ViewSwitcher	Menyediakan objek yang memungkinkan Anda mengatur tampilan untuk aplikasi.

Lihat juga

• Windows.Storage
• Activated
• OnFileActivated(FileActivatedEventArgs)
• Sampel peluncuran asosiasi
• Menangani aktivasi file
• Panduan untuk jenis file dan URI
• Sampel peluncuran asosiasi (Windows 10)