Windows控制面板编程
Windows 控制面板编程
说明：本文章为本人在做项目时查阅相关文章而写成，如有不当之处，请指出。
mail: [email protected]
关键字：
控制面板，控制面板应用程序，
一、 什么是控制面板
打开Windows的控制面板会看到类似的图像
图一
双击其中的一个图标，会显示对话框，让用户来完成相应的软硬件设置工作。这就是我们看到的控制面板。那么如何开发控制面板程序呢？带着疑问在MSDN和google里搜索关键字“Control Panel”，就会找到相关的技术文章。这是我工作的方法：借鉴已有的资源。但实际情况是那样吗？我们可以跟着MSDN的讲述来一步一步深入下去。
经过挖掘，发现并不是exe文件（Windows Vista下支持exe的控制面板应用程序，并且微软建议做成exe文件），而是有着cpl后缀名的文件，在windows－>system32下可以找到这样的文件。如果借助工具，Dependency Walker for Win32 (x86) 或dumpbin等就可以看到该文件导出了一些函数。
图二
多观察几个这样的文件，发现导出的函数虽有差异，但其中都有CPLApplet函数被导出。这些特征与DLL的特征吻合。去MSDN上查阅CPLApplet函数的说明证明我们的猜测是正确的。可以说控制面板应该程序就是以CPL为后缀名并且一定要导出CPLApplet函数的dll文件。
对于具体的描述可以参考：
http://msdn2.microsoft.com/en-us/library/bb776838(VS.85).aspx
二、 明确几个概念
l 控制面板管理程序：用于管理控制面板的程序，在桌面windows版本是CONTROL.EXE，在windows CE版本是CTLPNL.EXE，它们负责管理控制面板里的控制面板条目。简单的说，我们打开控制面板时，这些管理程序就在运行了。只不过我们看到的是挂上了Shell外观而已（注：这是我的猜测，还没有找到依据）。
l 控制面板条目（Control Panel Item）：在控制面板里看到的每个图标所对应的就是一个控制面板条目。
l 控制面板应用程序（Control Panel Application）：就是最终看到的CPL文件，一个控制面板应用程序可以实现几个控制面板条目。
三、 控制面板应用程序的编写
编写控制面板应用程序，就是编写dll文件，在该文件中实现控制所需要的功能。这就涉及到一个不得不说的函数，没有它就无法完成控制面板程序的实现。该函数为CPLApplet。下面就该函数的参数等知识做些介绍。
函数：LONG CPLApplet（HWND hwndCPl，UINT msg, LPARAM lParam1, LPARAM lParam2）
函数CPLApplet是控制面板应用程序（Control Panel application）的入口点，它被控制面板管理程序（control.exe 或Ctlpnl.exe）自动调用，它是个回调函数（Callback），注意：CPL文件一定要把函数CPLApplet导出，这样控制面板才能找到程序的入口点。
当启动控制面板时，它会搜索Windows或System32或注册表的相应条目目录下的文件，并把以CPL作为扩展名的文件载入，它调用CPL文件的导出函数CPLApplet（），发送消息给该函数。所以，控制面板应用程序要处理控制面板发送过来的消息，即在函数CPLApplet中进行处理，该函数没有默认的行为。如果一个CPL文件中实现了多个控制面板程序，那么只会有一个CPLApplet函数，它负责所有的控制面板应用程序。
参数说明：
hwndCPl：控制面板管理程序或称为控制面板的窗口句柄，即为control.exe的窗口句柄。如果控制面板应用程序或其它窗口需要传递父窗口句柄，可以使用该参数。
Msg：发送到控制面板应用程序的消息，由控制面板管理程序发送。
lParam1：消息参数
lParam2：消息参数
函数的返回值依据消息的不同而不同。
应用程序要使用该函数需要包含头文件：cpl.h
| 消息名称 |
描述 |
| CPL_INIT |
控制面板应用程序收到的第一个消息，通常在此处理全局初始化和内存分配。成功返回非0，否则返回0，此时控制面板管理程序终止和该应用程序的通信，并释放相应的CPL文件。 |
| CPL_GETCOUNT |
该消息紧接在CPL_INIT消息之后被发送，它返回控制面板管理程序所能看到该CPL文件中所包含的控制面板组件的数目，即该CPL文件可以出现在控制面板中的图标的数目。 |
| CPL_INQUIRE |
于CPL_GETCOUNT之后被发送，为指定的控制面板条目提供信息。 |
| CPL_NEWINQUIRE |
于CPL_GETCOUNT之后被发送，与消息CPL_INQUIRE完成的功能类似，只不过其实现要求TNewCPLInfo结构指针，所包含的资源不提供缓存，所以控制面板启动的较慢，一般不建议处理该消息，除非特别必要，如要根据一定的条件动态的改变控制面板条目的图标、字符串等。 |
| CPL_DBLCLK |
表明用户选定了一个控制面板条目，程序应该显示相应的对话框以便用户完成相应的任务。成功返回0，否则，返回非0. |
| CPL_STOP |
控制面板管理程序关闭时被发送，控制面板应用程序在此时处理内存释放等动作。成功处理，返回0. |
| CPL_SELECT |
目前不被使用。只有Windows 95 和Microsoft Windows NT 4.0之前的系统使用。 |
| CPL_STARTWPARMS |
该消息与CPL_DBLCLK类似，但lParam2指向LPCTSTR，该消息在shell32.dll version 5.0 （Windows 2000 ，Windows Millennium Edition (Windows Me)）及以后版本有效 |
| CPL_EXIT |
于CPL_STOP消息之后被发送，这是控制面板应用程序在释放资源的最后机会。成功处理返回0. |
CPL_INQUIRE：lParam1是以0为起点的整数，它是该CPL文件中所包含的控制面板条目的索引，lParam2参数要求一个CPLINFO结构的指针，用来填充所需的图标、字符串等信息。如果成功处理了该消息，应该返回0。
CPL_NEWINQUIRE：该消息与CPL_INQUIRE都是CPL_GETCOUNT之后被发送的消息，但并没有明确的先后顺序。所以程序里不要依赖它们的顺序来处理不同的事务。
编写控制面板应用程序的步骤：
1 选择适当的开发工具（如：Visual Studio 2008），建立DLL项目；
2 导出函数CPLApplet；
3 在函数CPLApplet的消息处理过程中完成你需要的工作；
一个简单的例子
开发工具：Microsoft Visual Studio 2008
操作系统：Windows XP SP2
步骤：
1 新建Win32 Project,工程名为CPLTest；
2 应用程序类型选择DLL（CPL文件本质上是DLL）；
3 在项目中新增或导入一个图标文件和两个字符串资源，用于在控制面板管理程序中显示图标和提示；
在Resource Files 上右键选择Add－>Resource，然后选择Icon或String Table
以下为resource.h 的部分内容
#define IDI_ICON1 101 //图标标识
#define IDS_STRING102 102 //字符串tom
#define IDS_STRING103 103//字符串cui
4 在dllmain.cpp文件中增加函数的导出CPLApplet；
extern "C" __declspec(dllexport) LONG APIENTRY CPlApplet(HWND hwndCPL, UINT uMsg, LPARAM lParam1, LPARAM lParam2);
原则上可以按照上面的方式导出就可以了，但是请注意CPlApplet的调用方式是APIENTRY，通过这样方式导出的函数会被改名，通过多次实验也不可行。你可能会上去掉APIENTRY，但这样编出来的CPL文件无法运行，查阅了相关文档，在Windows Mobile Version 5.0 SDK 的文档里指明了该函数的调用方式，windows CE 5.0 和Windows Shell and Controls没有指明这种调用方式。所以，只有加上APIENTRY。
现在的问题是如何导出该函数？看来要通过DEF文件了，如果你的项目里没有产生DEF文件，可以通过Project->Properties->Linker->Module Definition File来指定或自己用记事本建立这样的文件，输入如下内容。
; CPLTest.def : Declares the module parameters for the DLL.
LIBRARY "CPLTest"
EXPORTS
; Explicit exports can go here
CPlApplet
5 在dllmain.cpp文件中增加函数CPLApplet的消息处理函数来完成指定的功能；
在dllmain.cpp中包含以上两个头文件
#include "resource.h" //资源标识
#include
我的例子完成显示一个MessageBox的功能。
dllmain.cpp的完整代码：
// dllmain.cpp : Defines the entry point for the DLL application.
#include "stdafx.h"
#include "resource.h"
#include
LONG APIENTRY CPlApplet(HWND hwndCPL, UINT uMsg, LPARAM lParam1, LPARAM lParam2);
BOOL APIENTRY DllMain( HMODULE hModule,
DWORD ul_reason_for_call,
LPVOID lpReserved
)
{
switch (ul_reason_for_call)
{
case DLL_PROCESS_ATTACH:
case DLL_THREAD_ATTACH:
case DLL_THREAD_DETACH:
case DLL_PROCESS_DETACH:
break;
}
return TRUE;
}
LONG APIENTRY CPlApplet(HWND hwndCPL, UINT uMsg, LPARAM lParam1, LPARAM lParam2)
{
int i;
LPCPLINFO lpCPlInfo;
i = (int) lParam1;
switch (uMsg) {
case CPL_INIT: // first message, sent once
return TRUE;
case CPL_GETCOUNT: // second message, sent once
return 1;
break;
case CPL_INQUIRE: // third message, sent once per application
lpCPlInfo = (LPCPLINFO) lParam2;
lpCPlInfo->lData = 0;
lpCPlInfo->idIcon = IDI_ICON1;
lpCPlInfo->idName = IDS_STRING102;
lpCPlInfo->idInfo = IDS_STRING103;
break;
case CPL_DBLCLK: // application icon double-clicked
MessageBox(NULL, TEXT("Tom66"), TEXT("Cuei666"), MB_OK);
break;
case CPL_STOP: // sent once per application before CPL_EXIT
break;
case CPL_EXIT: // sent once before FreeLibrary is called
break;
default:
break;
}
return 0;
}
6 编译
Project->Properties->Linker->Output File修改输出文件的后缀名为CPL，也可以不修改，到最后把dll改为cpl也可以的。
四、 控制面板应用程序的安装与运行
l 将cpl文件拷贝到Windows（Windows CE）或Windows/system32(桌面版本Windows)，可以在这里双击运行，也可以打开控制面板就可以看到该CPL文件所包含的控制面板条目，图标和文件就是你在CPLApplet里指定的，双击也可运行。
2 在命令行下运行rundll32 shell32.dll,Control_RunDLL CPLTest.cpl（CPL文件名）@1(数字指定运行第几个控制面板条目，一个CPL文件可以包含几个控制面板条目)。在windows CE下，在命令行输入ctlpnl.exe /windows/cplmain.cpl,5，与桌面版本有些差异。
3 在windows的注册表[HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Windows/CurrentVersion/Control Panel/Cpls] 下新建字符串，并指定cpl所在的完整路径，然后就可以在控制面板里看到新增加的控制面板条目。通过写注册表的方式，是一些应用软件惯用的方式，安装时可以通过InstallShield等安装制作工具将其添加到注册表，卸载时，删除注册表中相关的项。
4 通过拷贝的方式，直接删除相应的CPL文件就可以了。至于有没有更好的方式，我还没有发现。
五、参考资料：
1 http://msdn2.microsoft.com/en-us/library/aa926276.aspx
2 http://msdn2.microsoft.com/en-us/library/bb776392.aspx