Como registrar itens de Painel de Controle de DLL
Observação
As diretrizes de implementação atuais afirmam que novos itens de Painel de Controle devem ser implementados como arquivos .exe em vez de arquivos de .cpl. As informações a seguir são incluídas principalmente para fins herdados.
Painel de Controle itens implementados em uma DLL que exporta a função CPlApplet têm requisitos de registro diferentes dos arquivos de .exe. A partir do Windows XP, novas DLLs de item de Painel de Controle devem ser instaladas na pasta do aplicativo associado na pasta Arquivos de Programas. Os itens armazenados no diretório System32 com uma extensão .cpl não precisam ser registrados; elas são mostradas automaticamente no Painel de Controle. Todos os outros itens Painel de Controle que usam CPlApplet devem ser registrados de uma das duas maneiras:
- Se o item Painel de Controle estiver disponível para todos os usuários, registre o caminho por computador adicionando um valor REG_EXPAND_SZ à subchave HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Painel de Controle\Cpls, definida como o caminho da DLL.
- Se o item Painel de Controle estiver disponível por usuário, use HKEY_CURRENT_USER como a chave raiz em vez de HKEY_LOCAL_MACHINE.
Os dois exemplos a seguir registram o item MyCplApp Painel de Controle. A DLL é nomeada MyCpl.cpl e está localizada no diretório do aplicativo MyCorp\MyApp . Este primeiro exemplo ilustra o registro por computador.
Instruções
Etapa 1:
Adicione essas informações ao registro para registrar a existência do arquivo .cpl.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Cpls
MyCpl = [REG_EXPAND_SZ] %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl
Etapa 2:
Windows Vista e posterior: Adicione essas informações adicionais ao registro para fornecer um GUID para o item Painel de Controle.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.Software.AppId
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = {A newly generated GUID}
Ao gerar um GUID para identificar exclusivamente o item Painel de Controle, você pode adicionar links de tarefa à Painel de Controle. Sem esse GUID, não há como os links de tarefa serem associados ao item Painel de Controle. Consulte Criando links de tarefa pesquisáveis para um item de Painel de Controle.
Etapa 3:
Windows Vista e posterior: Adicione as informações a seguir ao registro para criar um nome canônico para o item.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.ApplicationName
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_SZ] MyCorporation.MyCpl
Ao adicionar um nome canônico, os usuários podem iniciar o item Painel de Controle de uma linha de comando inserindo control.exe /name MyCorporation.MyCpl. Isso também possibilita alterar uma implementação de um arquivo .cpl para um arquivo .exe posteriormente, sem exigir que os programas de chamada façam alterações, pois eles podem continuar abrindo o item por meio de seu nome canônico. Para obter mais informações sobre nomes canônicos, consulte Executando itens de Painel de Controle.
Etapa 4:
Windows Vista e posterior: Adicione as informações a seguir ao registro para atribuir um item Painel de Controle a uma ou mais categorias.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.ControlPanel.Category
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_DWORD] 3
Windows XP: Adicione as informações a seguir ao registro para atribuir um item Painel de Controle a uma ou mais categorias.
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
Este exemplo atribui o item à categoria 3, que é Rede e Internet. Para adicionar um item a várias categorias, forneça a lista como um valor REG_SZ separado por vírgulas, como "3,8". Os valores podem ser fornecidos como decimal ou hexadecimal. Observe que a capacidade de adicionar um item a várias categorias só é possível no Windows XP Service Pack 2 (SP2) e posterior. Consulte Atribuindo categorias de Painel de Controle para obter todos os valores possíveis.
Etapa 5:
Windows Vista e posterior: Adicione as informações a seguir ao registro para criar e apontar para um arquivo XML para manter os links de tarefa para o item. O valor deve ser um caminho REG_SZ, conforme mostrado aqui ou um módulo e uma ID de recurso (por exemplo, "C:\Program Files\MyCorp\MyApp\MyApp.exe,-31") se for um recurso inserido. O local do arquivo XML deve ser totalmente especificado. Ele não pode usar uma variável de ambiente como %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
Para obter mais detalhes sobre links de tarefa e como criar o arquivo XML para mantê-los, consulte Criando links de tarefa pesquisáveis para um item de Painel de Controle.
Tópicos relacionados