Come registrare elementi Pannello di controllo DLL
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.
Argomenti correlati