Compartilhar via


Como registrar itens de Painel de Controle executáveis

Para itens Painel de Controle implementados como arquivos .exe, nenhuma exportação especial ou tratamento de mensagens é necessário. 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 Painel de Controle chamado Minhas Configurações como um objeto de comando para que ele apareça na janela Painel de Controle. A janela Minhas Configurações também é exibida quando o comando MyApp.exe /settings é executado.

Instruções

Etapa 1:

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

Etapa 2:

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 da entrada Padrão são simplesmente o nome REG_SZ do item Painel de Controle. A entrada Padrão pode ser útil para identificar a entrada GUID, mas é opcional.

Etapa 3:

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
  • Default. REG_SZ. O nome de exibição do item Painel de Controle.

  • LocalizedString. Opcional. REG_SZ ou REG_EXPAND_SZ. O nome do módulo e a ID da tabela de cadeia de caracteres do nome localizado do item Painel de Controle. O formato é um sinal "at" (@) seguido pelo nome do .exe ou .dll que contém a tabela de cadeia de caracteres MUI (Interface do Usuário Multilíngue). 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 (-), seguido pela ID na tabela de cadeia de caracteres.

    Se o módulo não tiver uma tabela de cadeia de caracteres, essa entrada poderá 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 para o idioma de exibição atual.

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

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

  • System.ControlPanel.Category. REG_SZ. Um valor que declara as categorias Painel de Controle em que o item é exibido. 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 categoriasAparência e Personalização e Programas. Consulte Atribuindo categorias de 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 links de tarefa. Esse pode ser um caminho de arquivo direto, conforme mostrado no exemplo, ou um recurso inserido especificado como um nome de módulo e ID de recurso, como "%ProgramFiles%\MyCorp\MyApp\MyApp.exe,-31".

Etapa 4:

Sob essa mesma subchave GUID, adicione a subchave a seguir ao registro para fornecer o caminho do arquivo que contém o ícone e a ID do 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.

Etapa 5:

Adicione as informações a seguir 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 Painel de Controle

Como registrar itens de Painel de Controle de DLL