---转载自《计算机世界日报》 (文/李进)

    当我们打开控制面板时，会看到一些控制面板项目，如“添加/删除程序”，“调制解调器”，“系统”等。我们经常需要通过这些项目来对Windows进行配置。使用C++Builder，能方便快速地开发出自己的控制面板应用程序。

---- 一：利用BCB的可视化编程和控制面板程序标准编程相结合，框架使用标准的控制面板程序编程，具体的功能和显示窗口直接利用C++Builder强大的可视化编程能力来生成。

---- 控制面板程序实际上就是一个DLL（动态链接库）文件，关键是它实现了CPlApplet函数。CPlApplet是一个回调（callback）函数，它处理所有发送给控制面板应用程序的消息。当控制面板应用程序运行起来时，调用它的程序从该控制面板应用程序中取得CPlApplet函数的地址，然后用该地址调用CPlApplet函数，并将消息传递给它。在处理消息时，必须按照一定的顺序进行。控制面板应用程序还有一个特点，就是一个DLL文件可以实现多个模块，每个模块可以有自己的图标、字符串资源，每一个模块对应于控制面板中的一个项目。

---- 首先我们来看看控制面板应用程序执行的过程。弄明白了这点，才能编写出正确的控制面板应用程序。

---- 由于控制面板应用程序是一个DLL文件，所以调用者必须使用LocaLibrary()函数来装载并执行。在控制面板应用程序装载时，CPlApplet 函数会接收到CPL_INIT消息，它表示控制面板应用程序正在初始化。这时CPlApplet 函数应该进行一些必要的初始化工作。如果初始化失败，CPlApplet 函数应该返回零值，通知调用者中止该控制面板应用程序的运行并释放占用的资源。该消息只发送一次。

---- 当CPlApplet 函数返回初始化成功的信息后，调用者会发送CPL_GETCOUNT消息给它，CPlApplet 函数应该返回控制面板应用程序中模块的个数。该消息只发送一次。

---- 随后，对于每个模块，CPlApplet 函数都会收到一条CPL_INQUIRE 和CPL_NEWINQUIRE消息。响应此消息，CPlApplet函数将填充CPLINFO或者NEWCPLINFO结构，其中存放了控制面板应用程序的名称、图标及描述信息。通常只需要处理CPL_INQUIRE消息，如果想更改图标和显示信息（如在不同的语言平台上显示不同的语言文字），则需要响应CPL_NEWINQUIRE消息。对于每个模块都会发送这两个消息一次。

---- 当CPlApplet 函数接收到CPL_DBLCLK消息时，表示将要运行相应的模块。这个消息可以多次发送，一般的，当使用者用鼠标双击某个图标时，就会发送一个CPL_DBLCLK消息。该消息包含了模块的识别号，因此CPlApplet 函数可以分辨出是需要执行那个模块的功能。

---- 在控制面板应用程序退出前，对于每一个模块CPlApplet函数都会接收到一条CPL_STOP消息，消息中包含该模块的识别号。此时CPlApplet函数需要针对不同的模块做不同的清理工作。

---- 在处理完最后一条CPL_STOP消息后，CPlApplet函数会收到CPL_EXIT消息，表示控制面板应用程序即将退出。在CPlApplet函数返回后，调用者将立即使用FreeLibrary()函数释放占用的资源。

---- 下面我们用C++ Builder来创建一个DLL文件，并编写CPlApplet函数代码。该控制面板应用程序包含一个模块，该模块的功能是显示一个窗口，窗口中显示“Hello World”。以下代码在BCB4专业版和BCB5企业版中调试通过。

1. 首先选择菜单“File - > new ”，在出现的画面中选择“DLL Wizard”。
   
2. 选择菜单中的“save project as”，保存项目文件和CPP文件到指定的目录下。项目文件名称使用默认project1。
   
3. 定义控制面板应用程序在控制面板中显示的图标。这里我们使用RC资源文件。首先选择菜单中的“new- >Text file”，生成一个文本文件，然后将它另存为ico.rc文件。编辑该文件，在其中加入一行“ MYICON ICON icon1.ico”。

---- 将一个图标文件复制到程序所在的目录里，并将文件名改为 icon1.ico。或者用Image Editor创建一个。注意，这个图标大小应该为32X32（大图标）。

---- 在Project Manager中，将该RC文件加入到工程项目中。

4. 加入一个新的Form，该Form将被作为窗口显示出来。

---- 选择菜单中的“file- >new”，从中选择Form。然后在Forn上加上一个Label对象，设置其Caption为“Hello World”。

5. 编辑project1.cpp文件。

---- 首先需要包含头文件cpl.h，这样才可以使用一些常数，如CPL_INIT等消息。

---- 然后定义一个全局变量 gInstance。

---- 处理DLL的入口函数，将程序句柄保存到全局变量gInstance中。程序内容如下：

  #include  < vcl.h >
#include  < cpl.h >
	HINSTANCE 		gInstance;  
int WINAPI DllEntryPoint(HINSTANCE hinst, 
unsigned long reason, void*)
{
if (reason==DLL_PROCESS_ATTACH) gInstance=hinst;  
//gInstance 中存放着程序的句柄。
    return 1;
}
5：继续编辑project1.cpp文件，完成CPlApplet函数。
//  由于CPlApplet函数需要在DLL外部使用，所以必须被输出。
extern "C" int __stdcall __declspec(dllexport)
CPlApplet(HWND HwControlPanel,  int Msg,  
int lParam1,   int lParam2)
{
  switch (Msg) {
    case CPL_INIT:
       return true; 	// 返回初始化成功的信息
    case CPL_GETCOUNT:
return 1;	// 告诉调用者该控制面板应用程序包含一个模块
    case CPL_NEWINQUIRE: {
      // 在这里设置图标，名称等信息
      NEWCPLINFO *Info=(NEWCPLINFO *)lParam2;
      ZeroMemory(Info,sizeof(NEWCPLINFO));
      Info- >dwSize=sizeof(NEWCPLINFO);
      // 图标用资源文件ico.rc文件中定义的MYICON
      Info- >hIcon=LoadIcon(gInstance,"MYICON");
      strcpy(Info- >szName,"模块名称");  
// szName为控制面板中该模块的名称
      strcpy(Info- >szInfo,"模块详细说明" ); 
// szInfo为对该模块的说明。在控制面板
//中使用列表方式查看时，左面是模块的名称，右面是模块的说明。
      return 0;
      }
    case CPL_DBLCLK:
// 在这里加入需要实现的功能。这里我们只是简单的显示Form。
      try
      {
        Application- >Initialize();
Application- >CreateForm(__classid(TForm1), &Form1);
        Application- >Run();
      }
      catch (Exception &exception)
      {
Application- >ShowException(&exception);
      }
      return 0;
    }
}

---- 需要注意的是，在BCB4中，用DLL Wizard会生成Project1.cpp文件，新加入的Form为Form1，对应CPP文件为Unit1.cpp；而在BCB5中，不会生成project1.cpp，而是生成了Unit1.cpp，新加入的Form为Form2，对应CPP文件为Unit2.cpp。如果使用的是BCB5，则需要对上述代码做修改。

6. 好了，现在我们来编译该程序，成功后会生成一个project1.dll文件。为了让该DLL文件作为控制面板应用程序来运行，我们必须用以下两种方式之一：

---- ①将其扩展名修改为CPL，并将文件复制到Windows的系统目录下。对于Win9x，复制到c:\windows\system目录下，对于Winnt，复制到c:\winnt\system32下。

---- ②将其扩展名修改为CPL，并在c:\windows\control.ini文件的[MMCPL]部分，加入该文件的路径，形式为 “name=CPL文件的全路径”。

---- 现在打开控制面板，就会多了一项“模块名称”。

---- 二：利用C++Builder本身提供的控制面板应用程序类TappletModule

---- BCB5中提供了直接生成控制面板应用程序的功能。下面的例子生成一个控制面板应用程序，拥有两个模块，就是说，在控制面板中，会出现两个新的项目。

1. 运行C++ Builder5，执行菜单中的“File- >New”，选择“Control Panel Application”。
   
2. 在默认情况下，BCB5已经有了一个模块TAppletModule1，我们需要再增加一个模块TAppletModule2。
   执行菜单中的“File- >New”，选择“Control Panel Module”。模块1和模块2的CPP文件分别为Unit1.cpp和Unit2.cpp。
   
3. 在“Object Inspector”中分别设置这两个模块的图标，名称。这里将TAppletModule1的Caption设置为“模块1”，TAppletModule2的Caption设置为“模块2”，这将是模块显示在控制面板中的名称。点击AppletIcon属性，为它们选择不同的图标。
   
4. 分别在两个模块中编写对消息的处理函数。

---- TAppletModule提供了7个事件。其中OnActivate对应于CPL_DBLCLICK消息，OnInquire对应于CPL_INQUIRE消息，OnNewInquire对应于NEWINQUIRE消息，OnStop对应于CPL_STOP消息，OnCreate对应于CPL_INIT消息，OnDestroy对应于CPL_EXIT消息。还有一个OnStartWParms事件，如果控制面板应用程序是由RunDll（包括Rundll.exe和Rundll32.exe）启动的，则此事件被触发。例如我想运行控制面板中的“调制解调器”，你可以在命令行上运行：rundll32 shell32.dll,Control_RunDll modem.cpl ，这时OnStartWParms事件会被触发。如果是进入控制面板来运行“调制解调器”， OnStartWParms事件就不会被触发。

---- 为了增加功能和实现窗口，在两个模块中分别加入Form。对于每个模块，可以作为一个标准的BCB窗口程序来编写。

5. 至此，一个控制面板应用程序就已经编写好了。编译后，将生成的project1.cpl复制到c:\windows\system目录下。下图是控制面板中的显示。模块1和模块2实际上是由一个控制面板程序实现的。

---- 从以上步骤可以看出，用BCB5编写控制面板应用程序非常的方便，所有的框架BCB已经自动的为你编写好了，你只需要决定使用几个模块，并针对每个模块来编写功能代码，从而避免了繁琐的消息处理。