• 编写控制面板应用程序
    时间:2008-10-16   作者:佚名   出处:互联网

      当我们打开控制面板时,会看到一些控制面板项目,如“添加/删除程序”、“调制解调器”、“系统”等。我们经常需要通过这些项目来对Windows进行配置。还有一些软件,如雅马哈声卡的驱动程序,会在控制面板中增加自己的配置项目。使用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。然后在 Form上加上一个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; }

    6.继续编辑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,则需要对上述代码做修改。

    7.编译、运行

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

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

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

    现在打开控制面板,就会多了一项“模块名称”。 利用C++B提供的控制面板应用程序类TAppletModule   BCB5中提供了直接生成控制面板应用程序的功能。下面的例子生成一个控制面板应用程序,拥有两个模块,就是说,在控制面板中,会出现两个新的项目。 运行C++ Builder5,执行菜单中的“File->New”,选择“Control Panel Application”。

    在默认情况下,BCB5已经有了一个模块 TAppletModule1,我们需要再增加一个模块TAppletModule2。

    执行菜单中的“File->New”,选择“Control Panel Module”。模块1和模块2的CPP文件分别为Unit1.cpp和Unit2.cpp。

    在“Object Inspector”中分别设置这两个模块的图标、名称。这里将TAppletModule1的Caption设置为“模块 1”,TAppletModule2的Caption设置为“模块2”,这将是模块显示在控制面板中的名称。点击AppletIcon属性,为它们选择不同的图标。

    分别在两个模块中编写对消息的处理函数。 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窗口程序来编写。

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

    [点击图片可在新窗口打开]

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

    网友留言/评论

    我要留言/评论