WINCE6.0在控制面板添加控制面板应用程序.doc

WINCE6.0在控制面板添加控制面板应用程序 1. WINCE控制面板架构WINCE系统的控制面板提供的应用是基于windows桌面系统下应用的小子集，在WINCE系统中，控制面板系统由三部分组成，分别是Ctlpnl.exe、Control.exe和一些控制面板文件(.cpl)。Ctlpnl.exe和Control.exe相应地被操作系统用于控制控制面板文件夹显示和机构，这两部分构成控制面板系统架构的最根本部分，而那些.cpl文件对应于控制面板功能的应用。如果要创建子集的控制面板应用，我们必须创建一个.cpl文件，这个文件导出适合于Control.exe建立的架构的回调函数一个控制面板应用程序实际是一个dll，但它的扩展名是.cpl的文件，这个文件导出回调函数CPlApplet来处理控制面板系统发送过来的CPL_INIT、CPL_GETCOUNT、CPL_NEWINQURE、CPL_STOP|和CPL_EXIT消息，在处理这些消息的时候可以只直接调用某个.exe来执行相应的应用，也可以是直接的处理。当用户打开控制面板的时候，OS通过搜索位于“Windows”目录下面的.cpl文件来列举出控制面板系统下的控制面板应用，比如我们当前的系统中有下面的.cpl：图1我双击“控制面板”图标进入控制面板的时候，输出下面的出错提示信息：CPL: Failed to load Windowssystem.cpl说明加载system.cpl失败，而我在系统中添加自己的应用HelloCPL.cpl的系统中，在双击“控制面板”的时候，也相应的提示下面的信息：CPL: Failed to load WindowsHelloCPL.cpl后来在HelloCPL.文件中加入下面的内容才成功加载HelloCPL.cpl的LIBRARYHelloCPLEXPORTSCPlApplet可以在WINCE600的目录下没有找到生成system.cpl的地方，只在下面的目录中WINCE600PUBLICDATASYNCOAKCTLPANELSYSTEM找到生成systemcpl.cpl的源代码所在地方，但其导出函数为KillAllApps，并且为空函数，所以在控制面板下是看不到此控制面板应用程序对应的图标。CTLPNL文件夹中有九个文件夹，分别对应不同的CPL文件：ADVBACKLIGHT:高级背光灯管理。BTHPNL:蓝牙。CONNPNL:拨号网络。CONTROL:主控制台，我们在explorer中看到的控制面板应该就是这个。CPLMAIN:会生成cplmain.cpl,控制面板的大多数选项均源自于此。CTLPNL:和CONTROL相关联的DMPNL:对应设备管理器。INTL2:区域和语言设置。STGUI:存储器管理。图22. 控制面板应用程序的入口和导出函数2.1 入口函数DllMain因为.cpl文件实际就是dll，而dll的入口函数是DllMain，所以控制面板应用程序的入口函数是DllMain也就很自然的事情了。在进程和现场被初始化和终止的时候，系统会调用这个函数，或者在调用LoadLibrary()和FreeLibrary()函数的时候会调用这个入口函数。DllMai函数在这里的作用主要是保存好传递进来的指向DLL的句柄，以便后面使用。2.2 .def函数要导出的回调函数CPlAppletLONG CPlApplet(HWND hwndCPl, UINT msg, LPARAM lParam1, LPARAM lParam2)hwndCPl：控制面板窗口的句柄msg：发给控制面应用程序的消息WinCE中所支持的控制面板消息如下：CPL_INIT：被首次加载的时候会收到该消息，也是第一个消息，控制面板应用程序接收到该消息后会立刻执行全局变量的初始化，尤其是内存的分配的动作也在这里执行。CPL_GETCOUNT：第二个被收到的消息，该消息用于获得该控制面板应用程序中的组件数，因为.cpl文件中可能包含多个Applet程序，比如cplmain.cpl中就有十几个Applent程序，见图2。CPL_NEWINQUIRE：查询当前控制面板程序支持的对话框(dialog box)信息，如果该.cpl中包含多个对话框，那么lParam1表示对话框号，lParam2是一个指向NEWCPLINFO结构的指针，描述的是一个对话框的相关信息，见图2，connpnl.cpl中有14个组件，比如“笔针”就是其支持的一个对话框，我们在双击“笔针”图标的时候，串口输出下面的信息：CTLPNL: cmdline=Windowscplmain.cpl,9 -CTLPNL: CPL=Windowscplmain.cpl icon=9 tab=0说明“笔针”是cplmain.cpl支持的第9个对话框，而双击图2的“显示分辨率”图标的时候，输出下面的串口信息：CTLPNL: cmdline=WindowsHelloCPL.cpl,0 -CTLPNL: CPL=WindowsHelloCPL.cpl icon=0 tab=0因为添加的控制面板应用程序HelloCPL.cpl只支持一个对话框，上面的0表示第0个对话框。lParam2指向的NEWCPLINFO结构体定义如下：typedef struct tagNEWCPLINFO DWORD dwSize; DWORD dwFlags; DWORD dwHelpContext; LONG lData; HICON hIcon; TCHAR szName32; TCHAR szInfo64; TCHAR szHelpFile128; NEWCPLINFO;dwSize：该结构的信息dwFlags：忽略dwHelpContext：忽略lData：传给组建程序的数据hIcon：显示在控制面板中的图标的句柄，见图2，就是这些图标信息。szName：显示在控制面板中的组件的名字，比如“笔针”szInfo：显示在控制面板中的描述信息szHelpFile：忽略CPL_DBCLK：用户在控制面板界面中双击某个应用时，会收到该消息，在该消息中执行对应的应用程序。如果包含多个对话框，那么lParam1表示对话框号，lParam2为传给应用程序的数据。CPL_STOP：关闭控制面应用程序时，收到该消息，用于释放资源。如果包含多个对话框，那么lParam1表示对话框号，lParam2为传给应用程序的数据。CPL_EXIT：在CPL_STOP消息之后，控制面板释放该应用程序时，收到该消息。lParam1：消息参数1lParam2：消息参数23. 在WINCE控制面板中添加控制面板应用程序的步骤3.1 创建一个添加一个应用程序在创建应用程序之前，我们首先要有一个WINCE的系统工程，在打开这个工程的基础上我们创建一个应用程序子工程，在File-New-Subproject中选择WCE Application，这里我们选择Hello World应用程序，创建这个应用程序的目的为后面创建的控制面板应用程序调用的。3.2 创建控制面板应用程序的CPL工程点击File-New-Subproject，然后选择WCE Dynamic-Link Library，工程名为HelloCPL。图3然后点击Next，在Auto-generated subproject files页面中选择A Dll that exports some symbols。图4然后点击Finish完成，经过前面两部后我们可以看到：图53.3 修改DllMain和添加CPlApplet函数#include Cpl.h /因为添加CPlApplet函数，此函数又对CPL_XXX消息的处理#include resource.h/ IDI_HELLO_CPL、IDS_HELLO_KANDI和IDS_HELLO_SANDI的定义在这里#define lengthof(exp) (sizeof(exp)/sizeof(*(exp) HMODULE g_hModule = NULL; / Handle to the DLL.BOOL APIENTRY DllMain( HANDLE hModule, DWORD ul_reason_for_call, LPVOID lpReserved ) switch (ul_reason_for_call) case DLL_PROCESS_ATTACH:g_hModule = (HMODULE) hModule; case DLL_THREAD_ATTACH: case DLL_THREAD_DETACH: case DLL_PROCESS_DETACH: break; return TRUE;/ =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=/ The entry point to the Control Panel application./ =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=extern C LONG CALLBACK CPlApplet(HWND hwndCPL, UINT message, LPARAM lParam1, LPARAM lParam2) switch (message) case CPL_INIT: / Perform global initializations, especially memory / allocations, here. / Return 1 for success or 0 for failure. / Control Panel does not load if failure is returned./RETAILMSG(1, (TEXT(kandi helloworld test 1111rn); return 1; case CPL_GETCOUNT: / The number of actions supported by this Control / Panel application./RETAILMSG(1, (TEXT(kandi helloworld test 2222rn); return 1; case CPL_NEWINQUIRE: / This message is sent once for each dialog box, as / determined by the value returned from CPL_GETCOUNT. / lParam1 is the 0-based index of the dialog box. / lParam2 is a pointer to the NEWCPLINFO structure. ASSERT(0 = lParam1); ASSERT(lParam2); NEWCPLINFO* lpNewCplInfo = (NEWCPLINFO *) lParam2; / Release(TEXT(kandi test 1111rn); / RETAILMSG(1, (TEXT(kandi helloworld test 3333rn); if (lpNewCplInfo) lpNewCplInfo-dwSize = sizeof(NEWCPLINFO); lpNewCplInfo-dwFlags = 0; lpNewCplInfo-dwHelpContext = 0; lpNewCplInfo-lData = IDI_HELLO_CPL;/RETAILMSG(1, (TEXT(kandi helloworld test 44444rn); / The large icon for this application. Do not free this / HICON; it is freed by the Control Panel infrastructure. lpNewCplInfo-hIcon = LoadIcon(g_hModule, MAKEINTRESOURCE(IDI_HELLO_CPL); LoadString(g_hModule, IDS_HELLO_KANDI, lpNewCplInfo-szName, lengthof(lpNewCplInfo-szName); LoadString(g_hModule, IDS_HELLO_SANDI, lpNewCplInfo-szInfo, lengthof(lpNewCplInfo-szInfo); _tcscpy(lpNewCplInfo-szHelpFile, _T(); return 0; return 1; / Nonzero value means CPlApplet failed. case CPL_DBLCLK: / The user has double-clicked the icon for the / dialog box in lParam1 (zero-based)./RETAILMSG(1, (TEXT(kandi helloworld test 5555rn); PROCESS_INFORMATION pi = 0; if (CreateProcess(_T(WindowsHelloWorld.exe), NULL, NULL, NULL, FALSE, 0, NULL, NULL, NULL, &pi) CloseHandle(pi.hThread); CloseHandle(pi.hProcess); return 0; return 1; / CPlApplet failed. case CPL_STOP: / Called once for each dialog box. Used for cleanup./RETAILMSG(1, (TEXT(kandi helloworld test 66666rn); case CPL_EXIT: / Called only once for the application. Used for cleanup./RETAILMSG(1, (TEXT(kandi helloworld test 77777rn); default: return 0; return 1; / CPlApplet failed. / CPlApple3.4 为CPlApplet函数处理CPL_NEWINQUIRE时添加其所需要加载的图标和字符串在这里图标和字符串分别对应ID: IDI_HELLO_CPL、IDS_HELLO_KANDI和IDS_HELLO_SANDI的定义，添加的步骤如下：1) 为CPL工程添加rc资源文件右击图5的HelloCPL-source files，选择Add-New Item，见下图：图6点击Add后，双击HelloCPL-source files-HelloCPL.rc，见下图图73.5 为rc资源文件添加ICO图标和字符串右击图7的HelloCPL.rc，选择Add Resource，弹出下面的对话框。图8具体就不描述了。3.6 修改HelloCPL工