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

 

 ********************************LoongEmbedded********************************

作者：LoongEmbedded(kandi)

时间：2011.8.25

类别：WINCE 系统开发

********************************LoongEmbedded********************************

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 '\Windows\system.cpl'

说明加载system.cpl失败，而我在系统中添加自己的应用HelloCPL.cpl的系统中，在双击“控制面板”的时候，也相应的提示下面的信息：

CPL: Failed to load '\Windows\HelloCPL.cpl'

后来在HelloCPL.文件中加入下面的内容才成功加载HelloCPL.cpl的

LIBRARY       HelloCPL

EXPORTS

    CPlApplet

可以在WINCE600的目录下没有找到生成system.cpl的地方，只在下面的目录中

\WINCE600\PUBLIC\DATASYNC\OAK\CTLPANEL\SYSTEM找到生成systemcpl.cpl的源代码所在地方，但其导出函数为KillAllApps，并且为空函数，所以在控制面板下是看不到此控制面板应用程序对应的图标。

 

CTLPNL文件夹中有九个文件夹，分别对应不同的CPL文件：

ADVBACKLIGHT:高级背光灯管理。

BTHPNL:蓝牙。

CONNPNL:拨号网络。

CONTROL:主控制台，我们在explorer中看到的"控制面板"应该就是这个。

CPLMAIN:会生成cplmain.cpl,控制面板的大多数选项均源自于此。

CTLPNL:和CONTROL相关联的

DMPNL:对应设备管理器。

INTL2:区域和语言设置。

STGUI:存储器管理。

图2

2.    控制面板应用程序的入口和导出函数

2.1   入口函数DllMain

因为.cpl文件实际就是dll，而dll的入口函数是DllMain，所以控制面板应用程序的入口函数是DllMain也就很自然的事情了。在进程和现场被初始化和终止的时候，系统会调用这个函数，或者在调用LoadLibrary()和FreeLibrary()函数的时候会调用这个入口函数。

 

DllMai函数在这里的作用主要是保存好传递进来的指向DLL的句柄，以便后面使用。

2.2   .def函数要导出的回调函数CPlApplet

LONG 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=\Windows\cplmain.cpl,9

--->>>CTLPNL: CPL='\Windows\cplmain.cpl' icon=9 tab=0

说明“笔针”是cplmain.cpl支持的第9个对话框，而双击图2的“显示分辨率”图标的时候，输出下面的串口信息：

CTLPNL: cmdline=\Windows\HelloCPL.cpl,0

--->>>CTLPNL: CPL='\Windows\HelloCPL.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 szName[32];

  TCHAR szInfo[64];

  TCHAR szHelpFile[128];

} NEWCPLINFO;

 

dwSize：该结构的信息

dwFlags：忽略

dwHelpContext：忽略

lData：传给组建程序的数据

hIcon：显示在控制面板中的图标的句柄，见图2，就是这些图标信息。

szName：显示在控制面板中的组件的名字，比如“笔针”

szInfo：显示在控制面板中的描述信息

szHelpFile：忽略

 

CPL_DBCLK：用户在控制面板界面中双击某个应用时，会收到该消息，在该消息中执行对应的应用程序。如果包含多个对话框，那么lParam1表示对话框号，lParam2为传给应用程序的数据。

CPL_STOP：关闭控制面应用程序时，收到该消息，用于释放资源。如果包含多个对话框，那么lParam1表示对话框号，lParam2为传给应用程序的数据。

CPL_EXIT：在CPL_STOP消息之后，控制面板释放该应用程序时，收到该消息。

 

lParam1：消息参数1

lParam2：消息参数2

 

 

3.    在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完成，经过前面两部后我们可以看到：

图5

 

3.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 1111\r\n")));

      return 1;

 

    case CPL_GETCOUNT:

      // The number of actions supported by this Control

      // Panel application.

       //RETAILMSG(1, (TEXT("kandi helloworld test 2222\r\n")));

      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 1111\r\n")));

     // RETAILMSG(1, (TEXT("kandi helloworld test 3333\r\n")));

     if (lpNewCplInfo)

      {

         lpNewCplInfo->dwSize = sizeof(NEWCPLINFO);

         lpNewCplInfo->dwFlags = 0;

         lpNewCplInfo->dwHelpContext = 0;

         lpNewCplInfo->lData = IDI_HELLO_CPL;

           //RETAILMSG(1, (TEXT("kandi helloworld test 44444\r\n")));

         // 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 5555\r\n")));

      PROCESS_INFORMATION pi = {0};

      if (CreateProcess(_T("\\Windows\\HelloWorld.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 66666\r\n")));

    case CPL_EXIT:

      // Called only once for the application. Used for cleanup.

       //RETAILMSG(1, (TEXT("kandi helloworld test 77777\r\n")));

    default:

      return 0;

  }

 

  return 1;  // CPlApplet failed.

}  // CPlApple

 

3.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，见下图

图7

3.5   为rc资源文件添加ICO图标和字符串

右击图7的HelloCPL.rc，选择Add Resource，弹出下面的对话框。

图8

具体就不描述了。

3.6   修改HelloCPL工程配置

1)    把HelloCPL.bib文件的内容修改为

MODULES

HelloCPL.cpl  $(_FLATRELEASEDIR)\HelloCPL.cpl               NK

 

2)    右击HelloCPL工程，选择Properities，选择General页面，在Custom Variable

项中添加变量，变量名字为CPL，值为1，这样做的目的就是强制生成HelloCPL应用程序的扩展名为.cpl，而不是dll。然后选择C/C++页面，确认Additional Macro Definitions的值为$(CDEFINES) -DHelloCPL_EXPORTS。设置DLL Entry Point项为DllMain，因为HelloCPL.cpl的入口函数就是DllMain。在Include Directories项中添加路径$(_PROJECTROOT)/cesysgen/oak/inc。

 

3)    在HelloCPL.def文件中添加下面的内容

LIBRARY       HelloCPL

 

EXPORTS

    CPlApplet

目的是到处接口函数CPlApplet，加入没有添加这些内容，将无法有效加载HelloCPL.cpl。

 

3.7   分别单独编译HelloWorld工程和HelloCPL工程，分别生成HelloWorld.exe和

HelloCPL.cpl，然后会生成新的NK.bin，把NK.bin烧录到WINCE设备中，双击控制面板后可以看到下图：

图9

双击HelloCPL.cpl对应的图标，可以看到下图：

图10

这就是HelloWorld.exe应用程序显示的界面，是由HelloCPL.cpl的CPlApplet函数在处理双击消息的时候调用的。

 

转载于:https://www.cnblogs.com/LoongEmbedded/archive/2011/08/25/5298766.html