WM6SDK例子学习笔记（一）(zhuan)

在WM6 SDK的通用例子中有一个basicapp的例子。运行的效果就是在WM上出现一个窗口，显示一幅图片，下面左软按键可以切换图片。例子的功能很简单，作为入门学习很好。
    下面，我按照自己的理解将这个例子详细分析。
    这个例子属于Native的方式，其含义是基本使用的是API编程，而不是基于其他框架开发。也可以叫做“原生态”开发方式。因此有自己的特殊宏定义：

1. #define WIN32_LEAN_AND_MEAN

    接下来就是包含的头文件声明：

1. #include <windows.h>
2. #include <aygshell.h>
3. #include "resource.h"

    第一个头文件很好理解，是为了处理基本类型及基本操作而用到，第三个头文件则包含的是一些资源相关的定义。第二个头文件需要好好了解一下用途。这里暂且跳过，不表。

    下面定义了一个用于处理计算数组元素个数的宏：

1. #define ARRAYSIZE(a) (UINT_PTR)(sizeof(a)/sizeof((a)[0]))

    紧接着是应用的名称说明：

1. static   const  TCHAR g_szClassName[] = TEXT( "ClassName" );

    后面是函数声明和全局变量：

1. // function declarations
2. int  WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPWSTR lpCmdLine,  int  nShowCmd);
3. HANDLE FindPrevInstance();
4. HWND CreateMainWindow( int  nShowCmd);
5. BOOL OnCreateMainWindow(HWND hwnd);
6. void  PaintMainWindow(HWND hwnd);
7. LRESULT CALLBACK MainWindowProc(HWND hwnd, UINT msg, WPARAM wp, LPARAM lp);
9. HBITMAP LoadPaintImage(LPTSTR pszLabel, UINT_PTR cchLabel);
10. HFONT LoadPaintFont();
11. void  FreePaintImage();
12. void  FreePaintFont();
14. // global variables
15. HINSTANCE g_hInstance;
16. HBITMAP   g_hBitmapPaint = NULL;
17. HFONT     g_hFontPaint = NULL;
18. DWORD     g_dwFontSize;
19. DWORD     g_dwCurrentImage = 0;
20. UINT      g_uMsgMetricChange = RegisterWindowMessage(SH_UIMETRIC_CHANGE);

    好戏要开始了。
    首先是程序的主函数，即程序的入口。如果是基于MFC、ATL或者是C#开发的话，一般是看不到这个冬冬的。这个是专门留给操作系统调用的。

1. int  WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPWSTR lpCmdLine,  int  nShowCmd)
2. {
3.     HANDLE hEvent;
4.     HWND   hwnd;
5.     MSG    msg;
7.      // Save the instance handle so we can access it later
8.     g_hInstance = hInstance;
10.      // Check to see if this application is already running
11.     hEvent = FindPrevInstance();
12.      if  (hEvent == NULL)
13.     {
14.          // We found another instance
15.          return  -1;
16.     }
18.      // Create our main application window
19.     hwnd = CreateMainWindow(nShowCmd);
20.      if  (hwnd == NULL)
21.     {
22.          // Failed to initialize
23.         CloseHandle(hEvent);
24.          return  GetLastError();
25.     }
27.      // Run the message loop (note that GetMessage() returns -1 for error)
28.      while  (GetMessage(&msg, NULL, 0, 0) > 0)
29.     {
30.         TranslateMessage(&msg);
31.         DispatchMessage(&msg);
32.     }
34.      // Clean up
35.     FreePaintImage();
36.     FreePaintFont();
38.      // This is the value we passed to PostQuitMessage()
39.     CloseHandle(hEvent);
40.      return  msg.wParam;
41. }

    代码本身的注释应该算比较详细了。简单说明一下。先是判断一下该程序是否已经有一个在运行，如果有，则不再运行。这是为了保证该应用在一台设备上一次只能 运行一个。如果你做的程序有需要可以同时运行多个的话，就不要加上这样的处理。个人建议，为了安全有效，还是做这样的限制吧。然后用CreateMainWindow(nShowCmd)来注册窗口，并创建该窗口。接下来的while循环用来处理消息。如果你看过windows SDK的资料应该不会陌生。 FreePaintImage()和 FreePaintFont()是用来施放已分配的资源。最后关闭句柄，返回消息参数。主流程就是这些，后面说明具体每个部分。
    先说明保证同时只有一个该应用运行的部分：

1. HANDLE FindPrevInstance()
2. {
3.     HANDLE hEvent;
4.     HWND   hwnd;
5.     UINT   cTries = 0;
7.      // Create a named event
8.     hEvent = CreateEvent(NULL, TRUE, FALSE, g_szClassName);
9.      if  (hEvent != NULL)
10.     {
11.          // If the event already existed, that means there's another copy of our app
12.          // already running
13.          if  (GetLastError() == ERROR_ALREADY_EXISTS)
14.         {
15.              do
16.             {
17.                  // Just in case the other window needs to finish initialization
18.                 Sleep(cTries ? 250 : 0);
20.                  // Try to find the other application window
21.                 hwnd = FindWindow(g_szClassName, NULL);
22.                  if  (hwnd != NULL)
23.                 {
24.                     SetForegroundWindow((HWND)((UINT_PTR)hwnd | 0x01));
25.                     CloseHandle(hEvent);
26.                      return  NULL;
27.                 }
28.             }
29.              while  (++cTries < 2);   // only try twice
31.              // If we didn't find the window, the other application was probably
32.              // shutting down, so we'll just continue
33.         }
34.     }
36.      // Done
37.      return  hEvent;
38. }

里面判断了两次，如果两次都找到该应用的另一个实例才退出。 SetForegroundWindow是为了将已经运行的该应用实例窗口切换到前台，并激活该窗口。

    后面注册并创建主窗口：

1. HWND CreateMainWindow( int  nShowCmd)
2. {
3.     WNDCLASS wc;
4.     ATOM     atm;
5.     TCHAR    szTitle[128];
6.     HWND     hwnd;
8.      // Set up the window class description
9.     ZeroMemory(&wc,  sizeof (wc));
10.     wc.lpfnWndProc = MainWindowProc;     // 设置该窗口的回调函数，用于处理消息
11.     wc.hInstance = g_hInstance;
12.     wc.hbrBackground = (HBRUSH)(COLOR_WINDOW + 1);
13.     wc.lpszClassName = g_szClassName;
15.      // We want to redraw the window contents anytime we get resized. That way
16.      // we'll respond appropriately when the user switches between portrait and
17.      // landscape. If we had any child windows or controls, we'd need to
18.      // reposition or resize them when we get a WM_SIZE message.
19.     wc.style = CS_HREDRAW | CS_VREDRAW;
21.      // Register the window class
22.     atm = RegisterClass(&wc);       // 注册窗口类
23.      if  (atm == 0)
24.     {
25.          // Failed!!
26.          return  NULL;
27.     }
29.      // Load the window title string resource
30.      if  (!LoadString(g_hInstance, IDS_APPTITLE, szTitle, ARRAYSIZE(szTitle)))
31.     {
32.          // Failed!!
33.          return  NULL;
34.     }
36.      // Create a window using the class we just registered. Note that the
37.      // initial size and position don't matter, because we're going to make it
38.      // fullscreen when we get WM_CREATE, before it's ever displayed.
39.     hwnd = CreateWindow((LPCTSTR)atm, szTitle, WS_OVERLAPPED | WS_SYSMENU,
40.         CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT,
41.         NULL, NULL, g_hInstance, NULL);
42.      if  (hwnd == NULL)
43.     {
44.          // Failed!!
45.          return  NULL;
46.     }
48.      // Make the window visible and paint before returning
49.     ShowWindow(hwnd, nShowCmd);
50.     UpdateWindow(hwnd);
51.      return  hwnd;
52. }

    下面设置窗口类型和风格：

1. BOOL OnCreateMainWindow(HWND hwnd)
2. {
3.     SHMENUBARINFO shmbi;
4.     SHINITDLGINFO shidi;
6.      // Create our softkey bar
7.     ZeroMemory(&shmbi,  sizeof (shmbi));
8.     shmbi.cbSize =  sizeof (shmbi);
9.     shmbi.hwndParent = hwnd;
10.     shmbi.dwFlags = SHCMBF_HMENU;
11.     shmbi.nToolBarId = IDM_MAIN;
12.     shmbi.hInstRes = g_hInstance;
13.      if  (!SHCreateMenuBar(&shmbi))
14.     {
15.          // Failed!!
16.          return  FALSE;
17.     }
19.      // Windows Mobile applications should always display their main window
20.      // full-screen. We're going to let the OS do this for us by calling
21.      // SHInitDialog, even though technically this window isn't a dialog window.
22.     shidi.dwMask = SHIDIM_FLAGS;
23.     shidi.hDlg = hwnd;
24.     shidi.dwFlags = SHIDIF_SIZEDLGFULLSCREEN | SHIDIF_SIPDOWN;
25.      if  (!SHInitDialog(&shidi))
26.     {
27.          // Failed!!
28.          return  FALSE;
29.     }
31.      // Get the current user preference for text size
32.     SHGetUIMetrics(SHUIM_FONTSIZE_PIXEL,
33.         &g_dwFontSize,  sizeof (g_dwFontSize), NULL);
35.      // Success
36.      return  TRUE;
37. }

    接着绘制该窗口（设置字体，加载图片等）：

1. void  PaintMainWindow(HWND hwnd)
2. {
3.     PAINTSTRUCT ps;
4.      int          nSavedDC;
5.     HBITMAP     hBitmap, hOldBitmap;
6.     TCHAR       szLabel[64];
7.     HFONT       hFont;
8.     RECT        rect;
9.     BITMAP      bm;
10.      int          cy;
11.     HDC         hMemDC;
13.      // Start the paint operation
14.      if  (!GetUpdateRect(hwnd, NULL, FALSE) ||
15.         BeginPaint(hwnd, &ps) == NULL)
16.     {
17.          return ;
18.     }
20.      // Load the correct image and get its label
21.     hBitmap = LoadPaintImage(szLabel, ARRAYSIZE(szLabel));
22.      if  (hBitmap != NULL)
23.     {
24.          // Load the display font
25.         hFont = LoadPaintFont();
26.          if  (hFont != NULL)
27.         {
28.              // Save the device context state
29.             nSavedDC = SaveDC(ps.hdc);
31.              // Calculate the height of our display image and text
32.             GetObject(hBitmap,  sizeof (bm), &bm);
33.             cy = bm.bmHeight;
35.             SelectObject(ps.hdc, hFont);
36.             GetClientRect(hwnd, &rect);
37.             cy += DrawText(ps.hdc, szLabel, -1, &rect,
38.                 DT_CALCRECT | DT_CENTER | DT_NOPREFIX | DT_WORDBREAK);
40.              // Draw the image
41.             GetClientRect(hwnd, &rect);
42.             hMemDC = CreateCompatibleDC(ps.hdc);
43.              if  (hMemDC != NULL)
44.             {
45.                 hOldBitmap = (HBITMAP)SelectObject(hMemDC, hBitmap);
46.                 BitBlt(ps.hdc, (rect.right - bm.bmWidth) / 2,
47.                     (rect.bottom - cy) / 2, bm.bmWidth, bm.bmHeight,
48.                     hMemDC, 0, 0, SRCCOPY);
49.                 SelectObject(hMemDC, hOldBitmap);
50.                 DeleteDC(hMemDC);
51.             }
53.              // Draw the text
54.             rect.top = (rect.bottom - cy) / 2 + bm.bmHeight;
55.             DrawText(ps.hdc, szLabel, -1, &rect,
56.                 DT_CENTER | DT_NOPREFIX | DT_WORDBREAK);
58.              // Restore the device context
59.             RestoreDC(ps.hdc, nSavedDC);
60.         }
61.     }
63.      // Always need to finish!!
64.     EndPaint(hwnd, &ps);
65. }

        消息处理的回调函数：

1. LRESULT CALLBACK MainWindowProc(HWND hwnd, UINT msg, WPARAM wp, LPARAM lp)
2. {
3.      static  SHACTIVATEINFO sai;
5.      switch  (msg)
6.     {
7.      case  WM_CREATE:
8.          // Initialize the static window state information. The shell helper functions
9.          // will use this buffer to store their state.
10.         ZeroMemory(&sai,  sizeof (sai));
11.         sai.cbSize =  sizeof (sai);
13.          // Initialize the window (if we fail, return -1)
14.          return  (OnCreateMainWindow(hwnd) ? 0 : -1);
16.      case  WM_ACTIVATE:
17.          // Calling this function when we get WM_ACTIVATE ensures that our
18.          // application will handle the SIP properly. This function does
19.          // nothing when we're running on Smartphone.
20.         SHHandleWMActivate(hwnd, wp, lp, &sai, 0);
21.          break ;
23.      case  WM_SETTINGCHANGE:
24.          // This helper function will resize our main application window when the SIP
25.          // goes up and down. Try commenting out this function and see how it affects
26.          // our drawing code. This function is optional, so choose whichever behavior
27.          // you prefer. Again, this function does nothing on Smartphone.
28.         SHHandleWMSettingChange(hwnd, wp, lp, &sai);
29.          break ;
31.      case  WM_HIBERNATE:
32.          // We get this message when the device is running low on memory. All
33.          // applications should free any memory and resources that they can. We'll
34.          // free our cached bitmap and font, since we can just re-create them the next
35.          // time we need them.
36.         FreePaintImage();
37.         FreePaintFont();
38.          return  TRUE;
40.      case  WM_COMMAND:
41.          if  (LOWORD(wp) == ID_SWITCH)
42.         {
43.              // Switch to our next image
44.             g_dwCurrentImage = !g_dwCurrentImage;
45.             FreePaintImage();
46.             InvalidateRect(hwnd, NULL, TRUE);
47.         }
48.          break ;
50.      case  WM_KEYDOWN:
51.          // Allow Ctrl+Q to quit the application. Most users won't ever see
52.          // this, but it's handy for debugging.
53.          if  (wp ==  'Q'  &&
54.             GetKeyState(VK_CONTROL) < 0)
55.         {
56.             SendMessage(hwnd, WM_CLOSE, 0, 0);
57.         }
58.          break ;
60.      case  WM_PAINT:
61.         PaintMainWindow(hwnd);
62.          return  0;
64.      case  WM_DESTROY:
65.          // When this window is destroyed, it's time to quit the application
66.         PostQuitMessage(0);
67.          break ;
68.     }
70.      if  (msg == g_uMsgMetricChange)
71.     {
72.         DWORD dwFontSize;
74.          // The UI metrics have changed. This is how we get notified when the
75.          // user changes their preferred font size (PPC only). We free our
76.          // cached font and save the new size for the next time we paint.
77.          if  (SUCCEEDED(SHGetUIMetrics(SHUIM_FONTSIZE_PIXEL,
78.             &dwFontSize,  sizeof (dwFontSize), NULL)) &&
79.             dwFontSize != g_dwFontSize)
80.         {
81.             g_dwFontSize = dwFontSize;
82.             FreePaintFont();
83.             InvalidateRect(hwnd, NULL, TRUE);
84.         }
85.     }
87.      return  DefWindowProc(hwnd, msg, wp, lp);
88. }

    加载图片的函数：

2. HBITMAP LoadPaintImage(LPTSTR pszLabel, UINT_PTR cchLabel)
3. {
4.      // Load the current label string
5.     pszLabel[0] = 0;
6.     LoadString(g_hInstance, IDS_LABEL1 + g_dwCurrentImage,
7.         pszLabel, cchLabel);
9.      // Load the current image
10.      if  (g_hBitmapPaint == NULL)
11.     {
12.          // Note that the resource type must be "GIF", but actually the resource
13.          // data can contain a BMP, GIF, JPG, or PNG image. This enables us to
14.          // pick the best image format for our purposes (quality, size, etc).
15.         g_hBitmapPaint = SHLoadImageResource(g_hInstance,
16.             IDR_IMAGE1 + g_dwCurrentImage);
17.     }
19.      // Return the cached image handle
20.      return  g_hBitmapPaint;
21. }

    加载字体的函数：

1. HFONT LoadPaintFont()
2. {
3.     LOGFONT lf;
5.      if  (g_hFontPaint == NULL)
6.     {
7.          // Create the font handle
8.         ZeroMemory(&lf,  sizeof (lf));
9.         lf.lfHeight = -(LONG)g_dwFontSize;
10.         lf.lfWeight = FW_NORMAL;
11.         lf.lfCharSet = DEFAULT_CHARSET;
12.         lf.lfPitchAndFamily = VARIABLE_PITCH | FF_SWISS;
13.         g_hFontPaint = CreateFontIndirect(&lf);
14.     }
16.      // Return the cached font handle
17.      return  g_hFontPaint;
18. }

    最后别忘了，释放图片和释放字体资源：

1. void  FreePaintImage()
2. {
3.      if  (g_hBitmapPaint != NULL)
4.     {
5.         DeleteObject(g_hBitmapPaint);
6.         g_hBitmapPaint = NULL;
7.     }
8. }
10. void  FreePaintFont()
11. {
12.      if  (g_hFontPaint != NULL)
13.     {
14.         DeleteObject(g_hFontPaint);
15.         g_hFontPaint = NULL;
16.     }
17. }