Partilhar via

Como registrar itens executáveis do painel de controle

Para itens do Painel de Controle que são implementados como arquivos .exe, nenhuma exportação especial ou manipulação de mensagens é necessária. Qualquer arquivo .exe pode ser registrado como um objeto de comando para aparecer com um ponto de entrada na pasta Painel de Controle.

Um exemplo é usado aqui para demonstrar os requisitos de registro. O exemplo mostra como registrar um item do Painel de Controle chamado Minhas Configurações como um objeto de comando para que ele apareça na janela do Painel de Controle. A janela My Settings também aparece quando o comando MyApp.exe /settings é executado.

Instruções

1º Passo:

Gere um GUID para o item do Painel de Controle. O GUID identifica exclusivamente o item do Painel de Controle. Neste exemplo, {0052D9FC-6764-4D29-A66F-2F3BD9E2BB40} é o GUID do item Painel de Controle.

2º Passo:

Usando o GUID como um nome, adicione uma subchave ao registro da seguinte maneira.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows
            CurrentVersion
               Explorer
                  ControlPanel
                     NameSpace
                        {0052D9FC-6764-4D29-A66F-2F3BD9E2BB40}
                           (Default) = My Settings

Os dados para a entrada padrão é simplesmente o nome REG_SZ do item do painel de controle. A entrada Default pode ser útil para identificar a entrada GUID, mas é opcional.

3º Passo:

Usando o GUID como um nome, adicione uma subchave e suas entradas ao registro da seguinte maneira.

HKEY_CLASSES_ROOT
   CLSID
      {0052D9FC-6764-4D29-A66F-2F3BD9E2BB40}
         (Default) = My Settings
         LocalizedString = @%ProgramFiles%\MyCorp\MyApp.exe,-9
         InfoTip = @%ProgramFiles%\MyCorp\MyApp.exe,-5
         System.ApplicationName = MyCorporation.MySettings
         System.ControlPanel.Category = 1,8
         System.Software.TasksFileUrl = %ProgramFiles%\MyCorp\MyApp\MyTaskLinks.xml

  • Padrão. REG_SZ. O nome para exibição do item do Painel de Controle.

  • LocalizedString. Opcional. REG_SZ ou REG_EXPAND_SZ. O nome do módulo e o ID da tabela de cadeia de caracteres do nome localizado do item do Painel de Controle. O formato é um sinal "at" (@) seguido pelo nome do .exe ou .dll que contém a tabela de strings MUI (Interface de Utilizador Multilingue). As variáveis de ambiente podem ser usadas como um substituto para uma parte do caminho. O caminho e o nome do arquivo são seguidos por uma vírgula (,) e um hífen (-), seguidos pelo ID na tabela de cadeia de caracteres.

    Se o módulo não tiver uma tabela de cadeia de caracteres, então esta entrada pode ser simplesmente a cadeia de caracteres de nome de exibição. Se você usar apenas a cadeia de caracteres de nome de exibição em vez de uma tabela de cadeia de caracteres, o nome não será ajustado ao idioma de exibição atual.

  • InfoTip. REG_SZ ou REG_EXPAND_SZ. Uma descrição do item do Painel de Controle. Essas informações são mostradas em uma dica de informação que é exibida quando o mouse passa sobre o ícone do item. A sintaxe é a mesma usada para LocalizedString, incluindo a opção de simplesmente fornecer uma string em vez de uma referência de tabela de string.

  • System.ApplicationName. REG_SZ. O nome canônico do item. O comando de formulário control.exe /name System.ApplicationName abre o item; por exemplo, control.exe /name MyCorporation.MySettings. Consulte Executando itens do painel de controle para obter mais informações sobre o uso do Control.exe.

  • System.ControlPanel.Category. REG_SZ. Um valor que declara as categorias do Painel de Controle onde o item aparece. Várias categorias são separadas por vírgulas. No caso do exemplo acima, a entrada especifica que o item Minhas configurações deve aparecer nas categorias Aparência e Personalização e Programas. Consulte Atribuição de categorias do painel de controle para obter possíveis valores de categoria.

  • System.Software.TasksFileUrl. REG_SZ ou REG_EXPAND_SZ. O caminho do arquivo XML que define as ligações de tarefas . Isso pode ser um caminho de arquivo direto, como mostrado no exemplo, ou um recurso incorporado especificado como um nome de módulo e ID de recurso, como "%ProgramFiles%\MyCorp\MyApp\MyApp.exe,-31".

4º passo:

Sob essa mesma subchave GUID, adicione a seguinte subchave ao Registro para fornecer o caminho do arquivo que contém o ícone e o ID de recurso da imagem dentro desse arquivo.

HKEY_CLASSES_ROOT
   CLSID
      {0052D9FC-6764-4D29-A66F-2F3BD9E2BB40}
         DefaultIcon
            (Default) = %ProgramFiles%\MyCorp\MyApp.exe,-2

Observe que, embora a sintaxe seja semelhante às entradas LocalizedString e InfoTip discutidas anteriormente, nenhum caractere '@' é usado como um prefixo na entrada REG_SZ ou REG_EXPAND_SZ que especifica o caminho.

5º Passo:

Adicione as seguintes informações ao registro para fornecer o comando que é chamado pelo sistema quando o usuário abre o Painel de Controle.

HKEY_CLASSES_ROOT
   CLSID
      {0052D9FC-6764-4D29-A66F-2F3BD9E2BB40}
         Shell
            Open
               Command
                  (Default) = [REG_EXPAND_SZ] %ProgramFiles%\MyCorp\MyApp.exe /Settings

Registrando itens do painel de controle

Como registrar itens do painel de controle DLL

 

 

  • Last updated on