现在的位置: 首页 > 综合 > 正文

WM6SDK例子学习笔记（一）

2013年04月18日 ⁄ 综合 ⁄ 共 12512字 ⁄ 字号 小 中 大 ⁄ 评论关闭
    在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. }

返回
【上篇】
【下篇】

作者:

抱歉!评论已关闭.

返回首页

Copyright © 2013-2018 学步园  保留所有权利.
软文销售 QQ客服：2265327166 点击这里给我发消息（其他合作也可洽谈）
必威体育
必威电竞