Utilisation de CPLApplet

  • Article

Avant Windows Vista, vous créiez un élément Panneau de configuration en créant un fichier .dll et en le nommant avec une extension .cpl. Ce fichier a exporté la fonction CPlApplet . Ce schéma est toujours pris en charge dans Windows Vista et les versions ultérieures et est abordé dans cette rubrique. Toutefois, les instructions pour les nouveaux éléments Panneau de configuration recommandent une approche plus simple avec l’élément Panneau de configuration créé en tant que fichier .exe qui utilise une disposition de flux de tâches.

Quand Panneau de configuration charge un fichier .dll (ou .cpl), il appelle la fonction CPlApplet pour obtenir des informations telles que le nombre d’éléments Panneau de configuration que le fichier héberge, ainsi que des informations sur chaque élément. Panneau de configuration appelle également la fonction lorsque la fenêtre de l’élément est initialisée, ouverte ou fermée.

Lorsque Windows charge pour la première fois l’élément Panneau de configuration, il récupère l’adresse de la fonction CPlApplet et utilise ensuite cette adresse pour appeler la fonction et lui transmettre des messages. Il peut envoyer les messages suivants.

Message Description
CPL_DBLCLK Envoyé pour informer CPlApplet que l’utilisateur a choisi l’icône associée à un élément Panneau de configuration donné. CPlApplet doit afficher la boîte de dialogue de l’élément spécifié et effectuer toutes les tâches spécifiées par l’utilisateur. Le paramètre CPlAppletlParam1 est un entier qui représente l’index de base zéro de l’élément Panneau de configuration. Le paramètre lParam2 est le pointeur lpData retourné dans la structure CPLINFO ou NEWCPLINFO dans le message CPL_INQUIRE ou CPL_NEWINQUIRE . La valeur de retour est ignorée.
CPL_EXIT Envoyé après le dernier message CPL_STOP et immédiatement avant que Windows utilise la fonction FreeLibrary pour libérer la DLL qui contient l’élément Panneau de configuration. CPlApplet doit libérer toute mémoire restante et se préparer à la fermeture. La valeur de retour est ignorée.
CPL_GETCOUNT Envoyé après le CPL_INIT message pour inviter CPlApplet à retourner un nombre qui indique le nombre de sous-programmes qu’il prend en charge.
CPL_INIT Envoyé immédiatement après le chargement de la DLL qui contient l’élément Panneau de configuration. Le message invite CPlApplet à effectuer des procédures d’initialisation, y compris l’allocation de mémoire.
CPL_INQUIRE Envoyé après le CPL_GETCOUNT message pour inviter CPlApplet à fournir des informations sur un sous-programme spécifié. La valeur lParam1 est un entier qui représente l’index de base zéro du sous-programme sur lequel les informations sont demandées. Le paramètre lParam2 de CPlApplet pointe vers une structure CPLINFO . La valeur de retour est ignorée.
CPL_NEWINQUIRE Envoyé après le message de CPL_GETCOUNT pour inviter CPlApplet à fournir des informations sur un élément de Panneau de configuration spécifié. La valeur lParam1 est un entier qui représente l’index de base zéro du sous-programme sur lequel les informations sont demandées. Le paramètre lParam2 est un pointeur vers une structure NEWCPLINFO . CPL_NEWINQUIRE doivent normalement être ignorés. Votre application doit traiter uniquement CPL_INQUIRE sur Windows 95, Microsoft Windows NT 4.0 et les systèmes ultérieurs, car Panneau de configuration performances souffrent lorsque CPL_NEWINQUIRE est utilisé. Cela est dû au fait que les chaînes et icônes retournées ne peuvent pas être mises en cache. La valeur de retour est ignorée.
CPL_SELECT Obsolète. Les versions actuelles de Windows n’envoient pas ce message.
CPL_STARTWPARMS Envoyé pour informer CPlApplet que l’utilisateur a choisi l’icône associée à une boîte de dialogue donnée. CPlApplet doit afficher la boîte de dialogue correspondante et effectuer toutes les tâches spécifiées par l’utilisateur. Ce message est similaire à CPL_DBLCLK, mais il peut y avoir des informations supplémentaires. Le paramètre lParam1 est le Panneau de configuration numéro d’élément et lParam2 est un LPCTSTR pour toutes les directions supplémentaires qui peuvent être nécessaires. Retourne TRUE si ce message est géré ; sinon, FALSE. Ce message est valide pour les versions 5.00 et ultérieures de Shell32.dll.
CPL_STOP Envoyé une fois pour chaque élément Panneau de configuration dans le fichier .cpl avant que Windows décharge l’extension Panneau de configuration. CPlApplet doit libérer toute mémoire associée au numéro d’élément fourni dans lParam1. Le paramètre lParam2 est le pointeur lpData retourné dans la structure CPLINFO ou NEWCPLINFO dans le message CPL_INQUIRE ou CPL_NEWINQUIRE . La valeur de retour est ignorée.

 

Panneau de configuration Éléments

Conseils sur l’expérience utilisateur

Inscription d’éléments Panneau de configuration

traitement des messages Panneau de configuration

Exécution d’éléments Panneau de configuration

Extension des éléments de Panneau de configuration système

Affectation de catégories Panneau de configuration

Création de liens de tâche pouvant faire l’objet d’une recherche pour un élément Panneau de configuration

Accès au Panneau de configuration en mode sans échec sous Windows Vista