Cara Mendaftarkan Item Panel Kontrol DLL

  • Artikel

Catatan

Pedoman implementasi saat ini menyatakan bahwa item Panel Kontrol baru harus diimplementasikan sebagai file .exe daripada file .cpl. Informasi berikut disertakan terutama untuk tujuan warisan.

 

Panel Kontrol item yang diimplementasikan dalam DLL yang mengekspor fungsi CPlApplet memiliki persyaratan pendaftaran yang berbeda dari file .exe. Pada Windows XP, DLL item Panel Kontrol baru harus diinstal di folder aplikasi terkait di bawah folder Program Files. Item yang disimpan dalam direktori System32 dengan ekstensi .cpl tidak perlu didaftarkan; mereka secara otomatis ditampilkan dalam Panel Kontrol. Semua item Panel Kontrol lain yang menggunakan CPlApplet harus didaftarkan dengan salah satu dari dua cara:

  • Jika item Panel Kontrol tersedia untuk semua pengguna, daftarkan jalur per komputer dengan menambahkan nilai REG_EXPAND_SZ ke subkunciMicrosoft\Windows\CurrentVersion\Panel Kontrol\CplsPerangkat Lunak\HKEY_LOCAL_MACHINE\, atur ke jalur DLL.
  • Jika item Panel Kontrol tersedia per pengguna, gunakan HKEY_CURRENT_USER sebagai kunci akar alih-alih HKEY_LOCAL_MACHINE.

Dua contoh berikut mendaftarkan item Panel Kontrol MyCplApp. DLL diberi nama MyCpl.cpl dan terletak di direktori aplikasi MyCorp\MyApp . Contoh pertama ini menggambarkan pendaftaran per komputer.

Petunjuk

Langkah 1:

Tambahkan informasi ini ke registri untuk mendaftarkan keberadaan file .cpl.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Control Panel
                  Cpls
                     MyCpl = [REG_EXPAND_SZ] %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl

Langkah 2:

Windows Vista dan yang lebih baru: Tambahkan informasi tambahan ini ke registri untuk menyediakan GUID untuk item Panel Kontrol.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Control Panel
                  Extended Properties
                     System.Software.AppId
                        %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = {A newly generated GUID}

Dengan membuat GUID untuk mengidentifikasi item Panel Kontrol secara unik, Anda dapat menambahkan tautan tugas ke Panel Kontrol. Tanpa GUID ini, tidak ada cara agar tautan tugas dikaitkan dengan item Panel Kontrol. Lihat Membuat Tautan Tugas yang Dapat Dicari untuk Item Panel Kontrol.

Langkah 3:

Windows Vista dan yang lebih baru: Tambahkan informasi berikut ke registri untuk membuat nama kanonis untuk item tersebut.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Control Panel
                  Extended Properties
                     System.ApplicationName
                        %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_SZ] MyCorporation.MyCpl

Dengan menambahkan nama kanonis, pengguna dapat meluncurkan item Panel Kontrol dari baris perintah dengan memasukkan control.exe /name MyCorporation.MyCpl. Ini juga memungkinkan untuk mengubah implementasi dari file .cpl ke file .exe nanti, tanpa mengharuskan program panggilan untuk membuat perubahan apa pun karena mereka dapat terus membuka item melalui nama kanonisnya. Untuk informasi selengkapnya tentang nama kanonis, lihat Menjalankan item Panel Kontrol.

Langkah 4:

Windows Vista dan yang lebih baru: Tambahkan informasi berikut ke registri untuk menetapkan item Panel Kontrol ke satu atau beberapa kategori.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Control Panel
                  Extended Properties
                     System.ControlPanel.Category
                        %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_DWORD] 3

Windows XP: Tambahkan informasi berikut ke registri untuk menetapkan item Panel Kontrol ke satu atau beberapa kategori.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Control Panel
                  Extended Properties
                     {305CA226-D286-468e-B848-2B2E8E697B74} 2
                        %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_DWORD] 3

Contoh ini menetapkan item ke kategori 3, yaitu Jaringan dan Internet. Untuk menambahkan item ke beberapa kategori, berikan daftar sebagai nilai REG_SZ yang dipisahkan oleh koma, seperti "3,8". Nilai dapat disediakan sebagai desimal atau heksadesimal. Perhatikan bahwa kemampuan untuk menambahkan item ke beberapa kategori hanya dimungkinkan di Windows XP Service Pack 2 (SP2) dan yang lebih baru. Lihat Menetapkan Kategori Panel Kontrol untuk semua nilai yang mungkin.

Langkah 5:

Windows Vista dan yang lebih baru: Tambahkan informasi berikut ke registri untuk membuat dan menunjuk ke file XML untuk menyimpan tautan tugas untuk item tersebut. Nilai harus berupa jalur REG_SZ seperti yang ditunjukkan di sini atau modul dan ID sumber daya (misalnya, "C:\Program Files\MyCorp\MyApp\MyApp.exe,-31") jika itu adalah sumber daya yang disematkan. Lokasi file XML harus sepenuhnya ditentukan. Ini tidak dapat menggunakan variabel lingkungan seperti %ProgramFiles%.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            CurrentVersion
               Control Panel
                  Extended Properties
                     System.Software.TasksFileUrl
                        %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_SZ] C:\ProgramFiles\MyCorp\MyApp\MyTasks.xml

Untuk detail selengkapnya tentang tautan tugas dan cara membuat file XML untuk menahannya, lihat Membuat Tautan Tugas yang Dapat Dicari untuk Item Panel Kontrol.

Mendaftarkan Item Panel Kontrol

Cara Mendaftarkan Item Panel Kontrol yang Dapat Dieksekusi