Usar CPLApplet
Antes de Windows Vista, para crear un elemento del Panel de control se creaba un archivo .dll y se le asignaba una extensión .cpl. Este archivo exporta el CPlApplet función. Este esquema sigue siendo compatible con Windows Vista y versiones posteriores y se trata en este tema. Sin embargo, las directrices para los nuevos elementos del Panel de control recomiendan un enfoque más sencillo con el elemento del Panel de control creado como un archivo .exe que utiliza un diseño de flujo de tareas.
Cuando el Panel de control carga un archivo .dll (o .cpl), llama al comando CPlApplet función para obtener información como el número de elementos del Panel de Control que aloja el archivo, así como información sobre cada elemento. El Panel de control también llama a la función cuando la ventana del elemento se inicializa, se abre o se cierra.
Cuando Windows carga por primera vez el elemento Panel de control, recupera la dirección del elemento CPlApplet función y posteriormente utiliza esa dirección para llamar a la función y pasarle mensajes. Podría enviar los siguientes mensajes.
| Mensaje | Descripción |
|---|---|
| CPL_DBLCLK | Enviar notificación CPlApplet que el usuario ha elegido el icono asociado a un determinado elemento del Panel de control. CPlApplet debe mostrar el cuadro de diálogo del elemento especificado y llevar a cabo cualquier tarea especificada por el usuario. El CPlApplet lParam1 es un número entero que representa el índice de base cero del elemento del panel de control. El lParam2 parámetro es el lpData apuntador de retorno en el CPLINFO or NEWCPLINFO estructura en el CPL_INQUIRE o CPL_NEWINQUIRE mensaje. El valor de retorno se ignora. |
| CPL_EXIT | Enviado después del último mensaje CPL_STOP e inmediatamente antes de que Windows utilice el FreeLibrary función para liberar la DLL que contiene el elemento Panel de control. CPlApplet debe liberar la memoria restante y prepararse para cerrar. El valor de retorno se ignora. |
| CPL_GETCOUNT | Enviado después del mensaje CPL_INIT para solicitar CPlApplet para devolver un número que indique cuántos sub-programas admite. |
| CPL_INIT | Se envía inmediatamente después de cargar la DLL que contiene el elemento del Panel de control. El mensaje indica CPlApplet para realizar procedimientos de inicialización, incluida la asignación de memoria. |
| CPL_INQUIRE | Enviado después del mensaje CPL_GETCOUNT para solicitar CPlApplet para proporcionar información sobre un sub-programa determinado. El lParam1 es un número entero que representa el índice de base cero del sub-programa sobre el que se solicita información. El lParam2 parámetro de CPlApplet apunta a CPLINFO estructura. El valor de retorno se ignora. |
| CPL_NEWINQUIRE | Enviado después del mensaje CPL_GETCOUNT para solicitar CPlApplet para proporcionar información sobre un elemento del panel de control determinado. El lParam1 es un número entero que representa el índice de base cero del sub-programa sobre el que se solicita información. El lParam2 es un puntero a un NEWCPLINFO estructura. CPL_NEWINQUIRE normalmente debe ignorarse. Su aplicación debería procesar solo CPL_INQUIRE en Windows 95, Microsoft Windows NT 4.0 y sistemas posteriores, ya que el rendimiento del Panel de Control se resiente cuando se utiliza CPL_NEWINQUIRE. Esto se debe a que las cadenas e iconos devueltos no pueden almacenarse en caché. El valor de retorno se ignora. |
| CPL_SELECT | Obsoleto. Las versiones actuales de Windows no envían este mensaje. |
| CPL_STARTWPARMS | Enviar notificación CPlApplet que el usuario ha elegido el icono asociado a un cuadro de diálogo dado. CPlApplet debe mostrar el cuadro del correspondiente diálogo y llevar a cabo cualquier tarea especificada por el usuario. Este mensaje es similar a CPL_DBLCLK, pero puede contener información adicional. El lParam1 parámetro es el número de elemento del panel de control lParam2 es un LPCTSTR a las indicaciones adicionales que puedan ser necesarias. Volver VERDAD si este mensaje se gestiona; de lo contrario, FALSO. Este mensaje es válido para version 5.00 y una versión posterior de Shell32.dll. |
| CPL_STOP | Se envía una vez por cada elemento del Panel de control en el archivo .cpl antes de que Windows descargue la extensión del Panel de control. CPlApplet debe liberar cualquier memoria asociada con el número de elemento proporcionado en lParam1. El lParam2 parámetro es lpData apuntador de retorno en el CPLINFO or NEWCPLINFO estructura en el CPL_INQUIRE o CPL_NEWINQUIRE mensaje. El valor de retorno se ignora. |
Temas relacionados