Partilhar via

Como registrar e implementar um manipulador de folha de propriedades para um aplicativo do painel de controle

  • Artigo

Muitos aplicativos do Painel de Controle exibem uma folha de propriedades para permitir que os usuários visualizem e modifiquem várias configurações do dispositivo e do sistema. Dois desses aplicativos — Mouse e Display — permitem que os manipuladores de folha de propriedades substituam uma ou mais de suas páginas por uma página personalizada. A imagem a seguir mostra a folha de propriedades Propriedades do Mouse .

folha de propriedades do mouse

Os manipuladores de folha de propriedades para aplicativos do Painel de Controle são semelhantes aos dos tipos de arquivo, com duas exceções principais:

  • Eles são chamados por um aplicativo do Painel de Controle, não pelo Shell.
  • São registados de forma diferente.

O que precisa de saber

Tecnologias

  • Concha

Pré-requisitos

  • Uma compreensão do Painel de Controle
  • Uma compreensão dos menus de atalho

Instruções

Etapa 1: Registrando um manipulador de folha de propriedades para um aplicativo do painel de controle

Um gerenciador de folhas de propriedades de aplicativos do Painel de Controlo deve ser registado na subchave do Painel de Controlo. Essa chave pode estar em qualquer um dos dois locais, dependendo se o gestor deve ser por utilizador ou por computador. Para o registo por utilizador, a subchave do Painel de Controlo é HKEY_CURRENT_USER\Painel de Controlo. A macro REGSTR_PATH_CONTROLPANEL como definido em Regstr.h pode ser usado no código no lugar de "Painel de Controle". Para o registo por computador, a localização é:

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows
            Current Version
               Controls Folder

Este caminho pode ser referido no código como HKEY_LOCAL_MACHINE\REGSTR_PATH_CONTROLSFOLDER, usando a macro REGSTR_PATH_CONTROLSFOLDER que é definida em Regstr.h.

Os aplicativos do Painel de Controle que permitem que manipuladores de folha de propriedades substituam páginas têm uma subchave sob a subchave do Painel de Controle, nomeada para o aplicativo, como Mouse e Display. A subchave do aplicativo deve ter uma subchave shellex com uma subchave PropertySheetHandlers. Para registrar um manipulador de folha de propriedades, adicione seu GUID à subchave PropertySheetHandlers associada ao aplicativo Painel de Controle. Para fazer isso, crie uma subchave do PropertySheetHandlers subchave, nomeada para o manipulador de folha de propriedades, e defina seu valor padrão para a forma de cadeia de caracteres do GUID do manipulador.

O exemplo a seguir regista um gestor de folha de propriedades para a aplicação Painel de Controlo do Rato, para cada computador. Para registrá-lo por usuário, substitua HKEY_LOCAL_MACHINE\REGSTR_PATH_CONTROLSFOLDER por HKEY_CURRENT_USER\REGSTR_PATH_CONTROLPANEL.

HKEY_LOCAL_MACHINE
   REGSTR_PATH_CONTROLSFOLDER
      Mouse
         shellex
            PropertySheetHandlers
               MyPropHandler
                  (Default) = {MyPropHandler CLSID GUID}

Etapa 2: Implementando um manipulador de folha de propriedades para um aplicativo do painel de controle

O procedimento para implementar um manipulador de folha de propriedades do Painel de Controle é muito semelhante ao discutido em Como registrar e implementar um manipulador de folha de propriedades para um tipo de arquivo. A principal diferença é que agora IShellPropSheetExt::ReplacePage precisa de uma implementação não token em vez de IShellPropSheetExt::AddPages.

Quando um aplicativo do Painel de Controle está prestes a exibir sua folha de propriedades, ele chama o método IShellPropSheetExt::ReplacePage do manipulador de folha de propriedades uma vez para cada página que pode ser substituída. O parâmetro uPageID é definido como ID da página. Os IDs para as páginas disponíveis são definidos em Cplext.h. Os IDs atualmente disponíveis estão listados na tabela a seguir.

ID da página Descrição Aplicação do Painel de Controlo
PÁGINA_CPL_BOTÕES_RATO Página de Botões Rato
CPLPAGE_MOUSE_PTRMOTION A página do Motion Rato
Página de Controlo da Roda do Rato A página da roda Rato
VELOCIDADE_DO_TECLADO_CPLPAGE A página Velocidade Teclado
PLANO_DE_FUNDO_DE_EXIBIÇÃO_CPLPAGE A página de fundo Ecrã

 

Comentários

O procedimento para criar e substituir uma página é idêntico ao da adição de uma página. Para obter mais informações, consulte Como registrar e implementar um manipulador de folha de propriedades para um tipo de arquivo.