Condividi tramite

Come registrare elementi Pannello di controllo DLL

  • Articolo

Nota

Le linee guida di implementazione correnti consentono di implementare nuovi elementi Pannello di controllo come file .exe anziché .cpl file. Le informazioni seguenti sono incluse principalmente per scopi legacy.

 

Pannello di controllo elementi implementati in una DLL che esporta la funzione CPlApplet hanno requisiti di registrazione diversi rispetto ai file di .exe. A partire da Windows XP, le DLL dell'elemento Pannello di controllo devono essere installate nella cartella dell'applicazione associata nella cartella Programmi. Gli elementi archiviati nella directory System32 con un'estensione .cpl non devono essere registrati; vengono visualizzati automaticamente nella Pannello di controllo. Tutti gli altri elementi Pannello di controllo che usano CPlApplet devono essere registrati in uno dei due modi seguenti:

  • Se l'elemento Pannello di controllo deve essere disponibile per tutti gli utenti, registrare il percorso in base a ogni computer aggiungendo un valore REG_EXPAND_SZHKEY_LOCAL_MACHINE\ alla sottochiaveSoftware\Microsoft\Windows\CurrentVersion\Pannello di controllo\Cpls, impostata sul percorso dll.
  • Se l'elemento Pannello di controllo deve essere disponibile su base utente, usare HKEY_CURRENT_USER come chiave radice anziché HKEY_LOCAL_MACHINE.

I due esempi seguenti registrano l'elemento MyCplApp Pannello di controllo. La DLL è denominata MyCpl.cpl e si trova nella directory dell'applicazione MyCorp\MyApp . Questo primo esempio illustra la registrazione per computer.

Istruzioni

Passaggio 1:

Aggiungere queste informazioni al Registro di sistema per registrare l'esistenza del file di .cpl.

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

Passaggio 2:

Windows Vista e versioni successive: Aggiungere queste informazioni aggiuntive al Registro di sistema per fornire un GUID per l'elemento Pannello di controllo.

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

Generando un GUID per identificare in modo univoco l'elemento Pannello di controllo, è possibile aggiungere collegamenti attività alla Pannello di controllo. Senza questo GUID, non è possibile associare i collegamenti attività all'elemento Pannello di controllo. Vedere Creazione di collegamenti attività ricercabili per un elemento Pannello di controllo.

Passaggio 3:

Windows Vista e versioni successive: Aggiungere le informazioni seguenti al Registro di sistema per creare un nome canonico per l'elemento.

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

Aggiungendo un nome canonico, gli utenti possono avviare l'elemento Pannello di controllo da una riga di comando immettendo control.exe /name MyCorporation.MyCpl. In questo modo è anche possibile modificare un'implementazione da un file .cpl a un file .exe in un secondo momento, senza dover chiamare programmi per apportare modifiche poiché possono continuare ad aprire l'elemento tramite il nome canonico. Per altre informazioni sui nomi canonici, vedere Esecuzione di elementi Pannello di controllo.

Passaggio 4:

Windows Vista e versioni successive: Aggiungere le informazioni seguenti al Registro di sistema per assegnare un elemento Pannello di controllo a una o più categorie.

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

Windows XP: Aggiungere le informazioni seguenti al Registro di sistema per assegnare un elemento Pannello di controllo a una o più categorie.

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

In questo esempio viene assegnato l'elemento alla categoria 3, ovvero Rete e Internet. Per aggiungere un elemento a più categorie, specificare l'elenco come valore REG_SZ separato da virgole, ad esempio "3,8". I valori possono essere forniti come decimali o esadecimali. Si noti che la possibilità di aggiungere un elemento a più categorie è possibile solo in Windows XP Service Pack 2 (SP2) e versioni successive. Vedere Assegnazione di categorie di Pannello di controllo per tutti i valori possibili.

Passaggio 5:

Windows Vista e versioni successive: Aggiungere le informazioni seguenti al Registro di sistema per creare e puntare a un file XML per contenere collegamenti attività per l'elemento. Il valore deve essere un percorso REG_SZ, come illustrato qui o un modulo e un ID risorsa ,ad esempio "C:\Program Files\MyCorp\MyApp\MyApp.exe,-31") se è una risorsa incorporata. Il percorso del file XML deve essere specificato completamente. Non può usare una variabile di ambiente, ad esempio %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

Per altre informazioni sui collegamenti alle attività e su come creare il file XML da contenere, vedere Creazione di collegamenti attività ricercabili per un elemento Pannello di controllo.

Registrazione di elementi Pannello di controllo

Come registrare elementi eseguibili Pannello di controllo