Partilhar via

Usando o CPLApplet

Antes do Windows Vista, você criava um item do Painel de Controle criando um arquivo .dll e nomeando-o com uma extensão .cpl. Este ficheiro exportou a função CPlApplet. Este esquema ainda é suportado no Windows Vista e versões posteriores e é discutido neste tópico. No entanto, as diretrizes para novos itens do Painel de Controle recomendam uma abordagem mais simples com o item do Painel de Controle criado como um arquivo de .exe que usa um layout de fluxo de tarefas.

Quando o Painel de Controle carrega um arquivo .dll (ou .cpl), ele chama a funçãoCPlAppletpara obter informações como o número de itens do Painel de Controle que o arquivo hospeda, bem como informações sobre cada item. O Painel de Controle também chama a função quando a janela do item é inicializada, aberta ou fechada.

Quando o Windows carrega pela primeira vez o item do Painel de Controlo, ele recupera o endereço da funçãoCPlApplet doe, posteriormente, usa esse endereço para chamar a função e passar mensagens. Pode enviar as seguintes mensagens.

Mensagem Descrição
CPL_DBLCLK Enviado para notificar CPlApplet que o usuário escolheu o ícone associado a um determinado item do Painel de Controle. CPlApplet deve exibir a caixa de diálogo para o item especificado e executar todas as tarefas especificadas pelo usuário. O parâmetro CPlAppletlParam1 é um inteiro que representa o índice baseado em zero do item do Painel de Controle. O parâmetro lParam2 é o ponteiro lpData retornado na estrutura CPLINFO ou NEWCPLINFO na mensagem CPL_INQUIRE ou CPL_NEWINQUIRE. O valor de retorno é ignorado.
CPL_EXIT Enviado após a última mensagem de CPL_STOP e imediatamente antes de o Windows usar a função FreeLibrary para libertar a DLL que contém o item do Painel de Controlo. CPlApplet deve libertar qualquer memória restante e preparar-se para fechar. O valor de retorno é ignorado.
CPL_GETCOUNT Enviado após a mensagem de CPL_INIT para solicitar CPlApplet retornar um número que indica quantos subprogramas ele suporta.
CPL_INIT Enviado imediatamente após o carregamento da DLL que contém o item do Painel de Controle. A mensagem solicita que CPlApplet execute procedimentos de inicialização, incluindo alocação de memória.
CPL_INQUIRE Enviado após a mensagem de CPL_GETCOUNT para solicitar CPlApplet fornecer informações sobre um subprograma especificado. O valor de lParam1 é um inteiro que representa o índice de base zero do subprograma sobre o qual as informações estão a ser solicitadas. O parâmetro lParam2 de CPlApplet aponta para uma estrutura CPLINFO. O valor de retorno é ignorado.
CPL_NEWINQUIRE Enviado após a mensagem CPL_GETCOUNT para solicitar CPlApplet forneça informações sobre um item especificado do Painel de Controle. O valor de lParam1 é um inteiro que representa o índice baseado em zero do subprograma sobre o qual as informações estão sendo solicitadas. O parâmetro lParam2 é um ponteiro para uma estruturaNEWCPLINFO. CPL_NEWINQUIRE normalmente deve ser ignorado. Seu aplicativo deve processar apenas CPL_INQUIRE no Windows 95, Microsoft Windows NT 4.0 e sistemas posteriores, uma vez que o desempenho do painel de controle sofre quando CPL_NEWINQUIRE é usado. Isso ocorre porque as cadeias de caracteres e ícones retornados não podem ser armazenados em cache. O valor de retorno é ignorado.
CPL_SELECT Obsoleto. As versões atuais do Windows não enviam esta mensagem.
CPL_STARTWPARMS Enviado para notificar CPlApplet que o usuário escolheu o ícone associado a uma determinada caixa de diálogo. CPlApplet deve exibir a caixa de diálogo correspondente e executar todas as tarefas especificadas pelo usuário. Esta mensagem é semelhante a CPL_DBLCLK, mas pode haver algumas informações adicionais. O parâmetro lParam1 é o número do item do Painel de Controlo e lParam2 é um LPCTSTR para quaisquer instruções extras que possam ser necessárias. Devolve TRUE se esta mensagem for tratada; caso contrário, FALSE. Esta mensagem é válida para versão 5.00 e posterior do Shell32.dll.
CPL_STOP Enviado uma vez para cada item do Painel de Controle no arquivo .cpl antes do Windows descarregar a extensão do Painel de Controle. CPlApplet deve liberar qualquer memória associada ao número do item fornecido em lParam1. O parâmetro lParam2 é o ponteiro lpData retornado na estrutura CPLINFO ou NEWCPLINFO na mensagem CPL_INQUIRE ou CPL_NEWINQUIRE. O valor de retorno é ignorado.

 

Itens do Painel de Controle

Diretrizes de experiência do usuário

Registrando itens do painel de controle

Processamento de mensagens do painel de controlo

Executando itens do painel de controle

Estendendo os itens do painel de controle do sistema

Atribuição de categorias do painel de controle

Criando links pesquisáveis de tarefas para um item do Painel de Controlo

Aceder ao Painel de Controlo no Modo de Segurança no Windows Vista

 

 

  • Last updated on