Utilisation de CPLApplet
Avant Windows Vista, vous pouviez créer un élément du panneau de configuration en créant un fichier .dll et en le nommant avec une extension .cpl. Ce fichier exporte 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. Cependant, les directives pour les nouveaux éléments du panneau de configuration recommandent une approche plus simple avec l'élément du panneau de configuration construit comme un fichier .exe qui utilise une disposition de flux de tâches.
Lorsque le Panneau de contrôle charge un fichier .dll (ou .cpl), il appelle la fonction CPlApplet pour obtenir des informations telles que le nombre d'éléments du Panneau de contrôle que le fichier héberge, ainsi que des informations sur chaque élément. Le 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 du 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 notifier à CPlApplet que l'utilisateur a choisi l'icône associée à un élément donné du panneau de configuration. CPlApplet doit afficher la boîte de dialogue pour l'élément spécifié et exécuter les tâches spécifiées par l'utilisateur. Le paramètre CPlApplet lParam1 est un entier qui représente l'indice de base zéro de l'élément du panneau de configuration. Le paramètre lParam2 est le pointeur lpData renvoyé 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 n'utilise la fonction FreeLibrary pour libérer la DLL qui contient l'élément du panneau de configuration. CPlApplet doit libérer la mémoire restante et se préparer à se fermer. La valeur de retour est ignorée. |
| CPL_GETCOUNT | Envoyé après le message CPL_INIT pour demander à CPlApplet de renvoyer un nombre indiquant 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 du panneau de configuration. Le message invite CPlApplet à effectuer des procédures d'initialisation, notamment l'allocation de mémoire. |
| CPL_INQUIRE | Envoyé après le message CPL_GETCOUNT pour demander à CPlApplet de fournir des informations sur un sous-programme spécifié. La valeur lParam1 est un nombre entier qui représente l'index à base zéro du sous-programme au sujet duquel des 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 CPL_GETCOUNT pour demander à CPlApplet de fournir des informations sur un élément spécifié du panneau de configuration. La valeur lParam1 est un nombre entier qui représente l'index à base zéro du sous-programme au sujet duquel des informations sont demandées. Le paramètre lParam2 est un pointeur sur une structure NEWCPLINFO. CPL_NEWINQUIRE doit normalement être ignoré. Votre application ne doit traiter que CPL_INQUIRE sous Windows 95, Microsoft Windows NT 4.0 et les systèmes ultérieurs, car les performances du panneau de configuration sont affectées par l'utilisation de CPL_NEWINQUIRE. En effet, les chaînes et les icônes renvoyé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 notifier à 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 exécuter les tâches spécifiées par l'utilisateur. Ce message est similaire à CPL_DBLCLK, mais il peut contenir des informations supplémentaires. Le paramètre lParam1 est le numéro de l'élément du panneau de contrôle et lParam2 est un LPCTSTR pour toutes les instructions supplémentaires qui pourraient être nécessaires. Retourne TRUE si ce message est traité ; sinon, FALSE. Ce message est valable pour les versions 5.00 et ultérieures de Shell32.dll. |
| CPL_STOP | Envoyé une fois pour chaque élément du panneau de configuration dans le fichier .cpl avant que Windows ne décharge l'extension du panneau de configuration. CPlApplet doit libérer la mémoire associée au numéro d'article fourni dans lParam1. Le paramètre lParam2 est le pointeur lpData renvoyé dans la structure CPLINFO ou NEWCPLINFO dans le message CPL_INQUIRE ou CPL_NEWINQUIRE. La valeur de retour est ignorée. |
Rubriques connexes
-
Création de liens de tâches consultables pour un élément du panneau de contrôle
-
Accès au panneau de configuration en mode sans échec sous Windows Vista