【转】WinCE控制面板添加应用程序

作者：ARM-WinCE

http://blog.csdn.net/nanjianhui/archive/2009/07/10/4336897.aspx 

 

WinCE 系统中的控制面板和 Windows 系统中的控制面板原理是一样的，里面就是包含了一些应用程序。 WinCE 系统的控制面板由 Ctlpnl.exe ， Control.exe 和一些 .cpl 文件组成，其中 Ctlpnl.exe 和 Control.exe 用于控制控制面板的文件夹显示和架构，而 .cpl 文件和控制面板中的实际应用程序相对应。

 

WinCE 的控制面板中的每个应用程序都由两部分组成：应用程序本身和所对应的 .cpl 文件。实际上 .cpl 文件就是一个 dll，在该 dll 中会导出 CPLApplet 函数，该函数会处理来自控制面板的消息 (CPL_INIT, CPL_DBCLK, CPL_STOP 等 ) ，然后根据相应的消息来调用应用程序。

 

先来看一下 CPlApplet 函数，如下：

LONG CPlApplet(HWND hwndCPl, UINT msg, LPARAM lParam1, LPARAM lParam2)

hwndCPl ：控制面板窗口的句柄

msg ：发给控制面应用程序的消息

lParam1 ：消息参数 1

lParam2 ：消息参数 2

 

该函数会根据 msg 参数传入的消息进行相应的处理， WinCE 中所支持的控制面板消息如下：

CPL_INIT ： 被首次加载的时候会收到该消息，也是第一个消息，用于初始化控制面板应用程序，比如内存分配等。

CPL_GETCOUNT ：第二个被收到的消息，该消息用于获得该控制面板应用程序中的组件数，因为 .cpl 文件中可能包含多个 Applet 程序。

CPL_NEWINQUIRE ：查询组件信息，如果该 .cpl 中包含多个组件，那么 lParam1 表示组件号， lParam2 是一个指向NEWCPLINFO 结构的指针，其中 NEWCPLINFO 结构用于描述组件信息。

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

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

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

 

在 CPlApplet 中收到 CPL_NEWINQUIRE 消息时，会初始化 NEWCPLINFO 结构来描述组件信息，该结构定义如下：

 1 typedef struct tagNEWCPLINFO {
 2 
 3   DWORD dwSize;
 4 
 5   DWORD dwFlags;
 6 
 7   DWORD dwHelpContext;
 8 
 9   LONG lData;
10 
11   HICON hIcon;
12 
13   TCHAR szName[32];
14 
15   TCHAR szInfo[64];
16 
17   TCHAR szHelpFile[128];
18 
19 } NEWCPLINFO;

dwSize ：该结构的信息

dwFlags ：忽略

dwHelpContext ：忽略

lData ：传给组建程序的数据

hIcon ：显示在控制面板中的图标的句柄

szName ：显示在控制面板中的组件的名字

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

szHelpFile ：忽略

  

前面介绍了控制面板的基础知识，下面就开始添加应用程序到 WinCE 控制面板中，步骤如下：

1. 创建一个 WinCE 的工程，然后添加一个应用程序：

首先要有一个 WinCE 的工程，然后点击 File->New->Subproject ，然后选择 WCE Application ，然后可以选择 Hello World应用程序。

 

2. 为应用程序创建 CPL 工程：

同样点击 File->New->Subproject ，然后选择 WCE Dynamic-Link Library ，工程名为 HelloCPL ，然后点击 Next ，在Auto-generated subproject files 页面中选择 A Dll that exports some symbols ，然后点击 Finish 完成。

 

3. 添加 CPlApplet 函数：

打开 HelloCPL 工程，并打开 HelloCPL.cpp 文件，添加如下头文件：

#include <tchar.h>

#include “cpl.h”

 

然后添加如下代码：

  1 #define lengthof(exp) ((sizeof((exp)))/sizeof((*(exp))))
  2 
  3  
  4 
  5 HMODULE g_hModule = NULL;   // Handle to the DLL.
  6 
  7  
  8 
  9  
 10 
 11 BOOL APIENTRY DllMain( HANDLE hModule,
 12 
 13 DWORD  ul_reason_for_call,
 14 
 15 LPVOID lpReserved
 16 
 17 )
 18 
 19 {
 20 
 21     switch (ul_reason_for_call)
 22 
 23     {
 24 
 25         case DLL_PROCESS_ATTACH:
 26 
 27                         {
 28 
 29                                     g_hModule = (HMODULE) hModule;
 30 
 31                         }
 32 
 33         case DLL_THREAD_ATTACH:
 34 
 35         case DLL_THREAD_DETACH:
 36 
 37         case DLL_PROCESS_DETACH:
 38 
 39              break;
 40 
 41     }
 42 
 43     return TRUE;
 44 
 45 }
 46 
 47  
 48 
 49 // =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 50 
 51 // The entry point to the Control Panel application.
 52 
 53 // =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
 54 
 55 extern "C" HelloCPL_API LONG CALLBACK CPlApplet(HWND hwndCPL,
 56 
 57                   UINT message, LPARAM lParam1, LPARAM lParam2)
 58 
 59 {
 60 
 61   switch (message)
 62 
 63   {
 64 
 65     case CPL_INIT:
 66 
 67       // Perform global initializations, especially memory
 68 
 69       // allocations, here.
 70 
 71       // Return 1 for success or 0 for failure.
 72 
 73       // Control Panel does not load if failure is returned.
 74 
 75       return 1;
 76 
 77  
 78 
 79     case CPL_GETCOUNT:
 80 
 81       // The number of actions supported by this Control
 82 
 83       // Panel application.
 84 
 85       return 1;
 86 
 87  
 88 
 89     case CPL_NEWINQUIRE:
 90 
 91       // This message is sent once for each dialog box, as
 92 
 93       // determined by the value returned from CPL_GETCOUNT.
 94 
 95       // lParam1 is the 0-based index of the dialog box.
 96 
 97       // lParam2 is a pointer to the NEWCPLINFO structure.
 98 
 99     {
100 
101       ASSERT(0 == lParam1);
102 
103       ASSERT(lParam2);
104 
105  
106 
107       NEWCPLINFO* lpNewCplInfo = (NEWCPLINFO *) lParam2;
108 
109       if (lpNewCplInfo)
110 
111       {
112 
113          lpNewCplInfo->dwSize = sizeof(NEWCPLINFO);
114 
115          lpNewCplInfo->dwFlags = 0;
116 
117          lpNewCplInfo->dwHelpContext = 0;
118 
119          lpNewCplInfo->lData = IDI_HELLO;
120 
121  
122 
123          // The large icon for this application. Do not free this
124 
125          // HICON; it is freed by the Control Panel infrastructure.
126 
127          lpNewCplInfo->hIcon = LoadIcon(g_hModule,
128 
129                                   MAKEINTRESOURCE(IDI_HELLO));
130 
131  
132 
133           LoadString(g_hModule, IDS_APP_TITLE, lpNewCplInfo->szName,
134 
135                      lengthof(lpNewCplInfo->szName));
136 
137           LoadString(g_hModule, IDC_Hello, lpNewCplInfo->szInfo,
138 
139                      lengthof(lpNewCplInfo->szInfo));
140 
141           _tcscpy(lpNewCplInfo->szHelpFile, _T(""));
142 
143           return 0;
144 
145       }
146 
147       return 1;  // Nonzero value means CPlApplet failed.
148 
149     }
150 
151  
152 
153     case CPL_DBLCLK:
154 
155     {
156 
157       // The user has double-clicked the icon for the
158 
159       // dialog box in lParam1 (zero-based).
160 
161       PROCESS_INFORMATION pi = {0};
162 
163       if (CreateProcess(_T("//Windows//Hello.exe"), NULL, NULL, NULL, FALSE, 0, NULL, NULL, NULL, &pi))
164 
165       {
166 
167         CloseHandle(pi.hThread);
168 
169         CloseHandle(pi.hProcess);
170 
171         return 0;
172 
173       }
174 
175       return 1;     // CPlApplet failed.
176 
177     }
178 
179  
180 
181     case CPL_STOP:
182 
183       // Called once for each dialog box. Used for cleanup.
184 
185     case CPL_EXIT:
186 
187       // Called only once for the application. Used for cleanup.
188 
189     default:
190 
191       return 0;
192 
193   }
194 
195  
196 
197   return 1;  // CPlApplet failed.
198 
199 }  // CPlApplet

 具体不做解释了，相信自己看一下都能看明白。在上面的代码中，处理消息 CPL_NEWINQUIRE 的时候，加载了IDI_HELLO ， IDS_APP_TITLE 和 IDC_Hello 三个资源，分别是一个图标和两个字符串。为工程添加 rc 资源文件和resource.h 头文件，导入图标资源和字符串资源。资源的导入和定义比较简单，所以不介绍具体步骤了。

 

4. 修改 HelloCPL 工程配置：

打开 HelloCPL.bib 文件，添加如下内容：

MODULES

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

 

右击 HelloCPL 工程，选择 Properities ，选择 General 页面，在 Custom Variables 项中添加变量，变量名字为 CPL ，值为1 。

 

再次右击 HelloCPL 工程，选择 Properities ，选择 C/C++ 页面，确认 Additional Macro Definitions 的值为 $(CDEFINES) -DHelloCPL_EXPORTS 。设置 DLL Entry Point 项为 DllMain 。在 Include Directories 项中添加路径$(_PROJECTROOT)/cesysgen/oak/inc 。

 

5. 编译 Hello 应用程序和 HelloCPL 工程：

编译开始创建的 Hello 应用程序和 HelloCPL 工程，在 WinCE6.0 中，编译完成后会自动 Makeimg 操作。

  

通过上面的步骤，可以把应用程序添加到 WinCE 系统的控制面板中，最后编译成功以后，就可以下载运行了，在此我添加了一个 Hello的应用程序，名字叫 Hello application

posted @ 2016-02-23 08:19  91program  阅读(853)  评论(0)  编辑  收藏  举报