Bagikan melalui

Menangani aktivasi file

  • Artikel

API penting

Aplikasi Anda dapat mendaftar untuk menjadi handler default untuk jenis file tertentu. Aplikasi desktop Windows dan aplikasi Platform Windows Universal (UWP) dapat mendaftar untuk menjadi penangan file default. Jika pengguna memilih aplikasi Anda sebagai handler default untuk jenis file tertentu, aplikasi Anda akan diaktifkan saat jenis file tersebut diluncurkan.

Kami menyarankan agar Anda hanya mendaftar untuk jenis file jika Anda ingin menangani semua peluncuran file untuk jenis file tersebut. Jika aplikasi Anda hanya perlu menggunakan jenis file secara internal, Maka Anda tidak perlu mendaftar untuk menjadi handler default. Jika Anda memilih untuk mendaftar untuk jenis file, Anda harus memberi pengguna akhir fungsionalitas yang diharapkan saat aplikasi Anda diaktifkan untuk jenis file tersebut. Misalnya, aplikasi penampil gambar dapat mendaftar untuk menampilkan file .jpg. Untuk informasi selengkapnya tentang asosiasi file, lihat Panduan untuk jenis file dan URI.

Langkah-langkah ini menunjukkan cara mendaftar untuk jenis file kustom, .alsdk, dan cara mengaktifkan aplikasi Anda saat pengguna meluncurkan file .alsdk.

Catatan Di aplikasi UWP, URI dan ekstensi file tertentu dicadangkan untuk digunakan oleh aplikasi bawaan dan sistem operasi. Upaya untuk mendaftarkan aplikasi Anda dengan URI yang dipesan atau ekstensi file akan diabaikan. Untuk informasi selengkapnya, lihat Nama skema file dan URI yang dipesan.

Langkah 1: Tentukan titik ekstensi dalam manifes paket

Aplikasi menerima peristiwa aktivasi hanya untuk ekstensi file yang tercantum dalam manifes paket. Berikut adalah cara Anda menunjukkan bahwa aplikasi Anda menangani file dengan .alsdk ekstensi.

  1. Di Penjelajah Solusi, klik dua kali package.appxmanifest untuk membuka perancang manifes. Pilih tab Deklarasi dan di menu drop-down Deklarasi yang Tersedia, pilih Asosiasi Tipe File lalu klik Tambahkan. Lihat Pengidentifikasi Terprogram untuk detail selengkapnya tentang pengidentifikasi yang digunakan oleh asosiasi file.

    Berikut adalah deskripsi singkat tentang setiap bidang yang dapat Anda isi dalam perancang manifes:

Bidang Deskripsi
Nama Tampilan Tentukan nama tampilan untuk sekelompok tipe file. Nama tampilan digunakan untuk mengidentifikasi jenis file dalam Atur Program Default pada Panel Kontrol.
Logo Tentukan logo yang digunakan untuk mengidentifikasi jenis file di desktop dan di Atur Program Default pada Panel Kontrol. Jika tidak ada Logo yang ditentukan, logo kecil aplikasi akan digunakan.
Tips Info Tentukan tips info untuk sekelompok tipe file. Teks tip alat ini muncul ketika pengguna mengarahkan kumparan pada ikon untuk file jenis ini.
Nama Pilih nama untuk sekelompok jenis file yang memiliki nama tampilan, logo, tips info, dan bendera edit yang sama. Pilih nama grup yang dapat tetap sama di seluruh pembaruan aplikasi. Catatan Nama harus dalam semua huruf kecil.
Jenis Konten Tentukan jenis konten MIME, seperti gambar/jpeg, untuk jenis file tertentu. Catatan Penting tentang jenis konten yang diizinkan: Berikut adalah daftar alfabet jenis konten MIME yang tidak dapat Anda masukkan ke dalam manifes paket karena dicadangkan atau dilarang: aplikasi/pengunduhan paksa, aplikasi/oktet-stream, aplikasi/tidak diketahui, aplikasi/x-msdownload.
Jenis file Tentukan jenis file yang akan didaftarkan, didahului oleh titik, misalnya, ".jpeg". Jenis file yang dicadangkan dan dilarang: Lihat Nama skema URI yang dicadangkan dan jenis file untuk daftar alfabet jenis file untuk aplikasi bawaan yang tidak dapat Anda daftarkan untuk aplikasi UWP Anda karena dicadangkan atau dilarang.
  1. Masukkan alsdk sebagai Nama.
  2. Masukkan .alsdk sebagai Jenis File.
  3. Masukkan "images\Icon.png" sebagai Logo.
  4. Tekan Ctrl+S untuk menyimpan perubahan ke package.appxmanifest.

Langkah-langkah di atas menambahkan elemen Ekstensi seperti ini ke manifes paket. Kategori windows.fileTypeAssociation menunjukkan bahwa aplikasi menangani file dengan .alsdk ekstensi.

      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap:FileTypeAssociation Name="alsdk">
            <uap:Logo>images\icon.png</uap:Logo>
            <uap:SupportedFileTypes>
              <uap:FileType>.alsdk</uap:FileType>
            </uap:SupportedFileTypes>
          </uap:FileTypeAssociation>
        </uap:Extension>
      </Extensions>

Langkah 2: Tambahkan ikon yang tepat

Aplikasi yang menjadi default untuk jenis file memiliki ikon yang ditampilkan di berbagai tempat di seluruh sistem. Misalnya, ikon ini ditampilkan di:

  • Tampilan Item Windows Explorer, menu konteks, dan Pita
  • Panel Kontrol program default
  • Pemilih file
  • Hasil pencarian di layar Mulai

Sertakan ikon 44x44 dengan proyek Anda sehingga logo Anda dapat muncul di lokasi tersebut. Cocokkan tampilan logo petak peta aplikasi dan gunakan warna latar belakang aplikasi Anda daripada membuat ikon transparan. Buat logo meluas ke tepi tanpa mengayuhnya. Uji ikon Anda di latar belakang putih. Lihat Panduan untuk petak peta dan aset ikon untuk detail selengkapnya tentang ikon.

Langkah 3: Menangani peristiwa yang diaktifkan

Penanganan aktivitas OnFileActivated menerima semua peristiwa aktivasi file.

protected override void OnFileActivated(FileActivatedEventArgs args)
{
       // TODO: Handle file activation
       // The number of files received is args.Files.Count
       // The name of the first file is args.Files[0].Name
}

Protected Overrides Sub OnFileActivated(ByVal args As Windows.ApplicationModel.Activation.FileActivatedEventArgs)
      ' TODO: Handle file activation
      ' The number of files received is args.Files.Size
      ' The name of the first file is args.Files(0).Name
End Sub

void App::OnFileActivated(Windows::ApplicationModel::Activation::FileActivatedEventArgs const& args)
{
    // TODO: Handle file activation.
    auto numberOfFilesReceived{ args.Files().Size() };
    auto nameOfTheFirstFile{ 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 name of the first file is args->Files->GetAt(0)->Name
}

Catatan

Saat diluncurkan melalui Kontrak File, pastikan bahwa tombol Kembali membawa pengguna kembali ke layar yang meluncurkan aplikasi dan bukan ke konten aplikasi sebelumnya.

Kami menyarankan agar Anda membuat Bingkai XAML baru untuk setiap peristiwa aktivasi yang membuka halaman baru. Dengan begitu, tumpukan belakang navigasi untuk Bingkai XAML baru tidak berisi konten sebelumnya yang mungkin dimiliki aplikasi di jendela saat ini saat ditangguhkan. Jika Anda memutuskan untuk menggunakan Satu Bingkai XAML untuk Peluncuran dan untuk Kontrak File, maka Anda harus menghapus halaman dalam jurnal navigasi Bingkai sebelum menavigasi ke halaman baru.

Saat aplikasi Anda diluncurkan melalui aktivasi File, Anda harus mempertimbangkan untuk menyertakan UI yang memungkinkan pengguna untuk kembali ke halaman atas aplikasi.

Keterangan

File yang Anda terima bisa berasal dari sumber yang tidak tepercaya. Kami menyarankan agar Anda memvalidasi konten file sebelum mengambil tindakan di atasnya.

Contoh lengkap

Konsep

Tugas

Panduan

Referensi