手机软件开发入门 - 中国象棋（2）090311

认识 windows mobile 的窗口部件

 

为了查阅MSDN、沟通交流，我们先来认识一下windows mobile的UI部分。如下图，我们需要搞清楚几个基本的概念：

1. SIP - soft input panel, 软输入面板，就是输入法切换面板。
2. Task bar，任务条，用来显示程序名称标题，选择程序，退出程序。
3. Menu bar也叫Soft key bar或者Command bar，用来显示软按键菜单。

有了这些概念，以后再看文档就容易看懂了。比如要想知道如何隐藏输入法面板，就可以google一下“hide SIP windows mobile”来查找了。

全屏显示棋盘

手机屏幕很小，比如QVGA才有240x320像素，为了好看些，我们的象棋程序需要占用整个手机屏幕，也就是全屏显示。所以我们来研究一下windows mobile的全屏显示技术。

总体来说，要把一个窗口全屏显示，需要下面的步骤：

1. 调用SHFullScreen()隐藏SIP, Task bar。
2. 调用ShowWindow()隐藏Menu bar或者用MoveWindow()把window bar移出屏幕。用MoveWindow()的作用是保留soft key能接收消息。
3. 调用MoveWindow()修改窗口的位置和大小，以便全屏显示。

要把一个对话框全屏显示，需要下面的步骤：

1. 调用函数SHInitDialog()设置dwFlags为SHIDIF_FULLSCREENNOMENUBAR。
2. 调用MoveWindow()设置对话框大小为整个屏幕的大小。
3. 调用SetForegroundWindow()设置对话框为前景窗口。
4. 调用SHFullScreen()隐藏Task bar和SIP bar。

或者保留menu bar，只是把它移出到屏幕外，以便接收soft key消息：

1. 调用函数SHInitDialog()设置dwFlags为SHIDIF_SIZEDLGFULLSCREEN。
2. 调用SHFullScreen()隐藏Task bar和SIP bar。
3. 调用SetWindowPos()移出Menu bar。
4. 调用MoveWindow()设置全屏的对话框。

参考资料：

• http://support.microsoft.com/kb/266244/en-us/
• window mobile 6 sdk的sample "Full Screen".

（欢迎转载，转载请注明来源和作者：杨波）

代码：

// cchess_teacher.cpp : 定义应用程序的入口点。 // #include "stdafx.h" #include "cchess_teacher.h" #define MAX_LOADSTRING 100 // 全局变量: HINSTANCE g_hInst; // 当前实例 HWND g_hWndMenuBar; // 菜单栏句柄 HBITMAP g_hBoard; // 棋盘位图句柄 BOOL g_bFullScreen; int g_iMenuHeight; // 此代码模块中包含的函数的前向声明: ATOM MyRegisterClass(HINSTANCE, LPTSTR); BOOL InitInstance(HINSTANCE, int); LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM); INT_PTR CALLBACK About(HWND, UINT, WPARAM, LPARAM); void LoadImages(HINSTANCE hInst); void UnloadImages(); void DrawBoard(HDC hdc); void FullScreen ( HWND hWnd, // In: Window BOOL bFullScreen // In: TRUE = Size to full screen. FALSE = Undo ); int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPTSTR lpCmdLine, int nCmdShow) { MSG msg; LoadImages(hInstance); // 执行应用程序初始化: if (!InitInstance(hInstance, nCmdShow)) { return FALSE; } HACCEL hAccelTable; hAccelTable = LoadAccelerators(hInstance, MAKEINTRESOURCE(IDC_CCHESS_TEACHER)); // 主消息循环: while (GetMessage(&msg, NULL, 0, 0)) { if (!TranslateAccelerator(msg.hwnd, hAccelTable, &msg)) { TranslateMessage(&msg); DispatchMessage(&msg); } } UnloadImages(); return (int) msg.wParam; } // // 函数: MyRegisterClass() // // 目的: 注册窗口类。 // // 注释: // ATOM MyRegisterClass(HINSTANCE hInstance, LPTSTR szWindowClass) { WNDCLASS wc; wc.style = CS_HREDRAW | CS_VREDRAW; wc.lpfnWndProc = WndProc; wc.cbClsExtra = 0; wc.cbWndExtra = 0; wc.hInstance = hInstance; wc.hIcon = LoadIcon(hInstance, MAKEINTRESOURCE(IDI_CCHESS_TEACHER)); wc.hCursor = 0; wc.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH); wc.lpszMenuName = 0; wc.lpszClassName = szWindowClass; return RegisterClass(&wc); } // // 函数: InitInstance(HINSTANCE, int) // // 目的: 保存实例句柄并创建主窗口 // // 注释: // // 在此函数中，我们在全局变量中保存实例句柄并 // 创建和显示主程序窗口。 // BOOL InitInstance(HINSTANCE hInstance, int nCmdShow) { HWND hWnd; TCHAR szTitle[MAX_LOADSTRING]; // 标题栏文本 TCHAR szWindowClass[MAX_LOADSTRING]; // 主窗口类名 g_hInst = hInstance; // 将实例句柄存储在全局变量中 #if defined(WIN32_PLATFORM_PSPC) || defined(WIN32_PLATFORM_WFSP) // 在应用程序初始化期间，应调用一次 SHInitExtraControls 以初始化 // 所有设备特定控件，例如，CAPEDIT 和 SIPPREF。 SHInitExtraControls(); #endif // WIN32_PLATFORM_PSPC || WIN32_PLATFORM_WFSP LoadString(hInstance, IDS_APP_TITLE, szTitle, MAX_LOADSTRING); LoadString(hInstance, IDC_CCHESS_TEACHER, szWindowClass, MAX_LOADSTRING); #if defined(WIN32_PLATFORM_PSPC) || defined(WIN32_PLATFORM_WFSP) //如果它已经在运行，则将焦点置于窗口上，然后退出 hWnd = FindWindow(szWindowClass, szTitle); if (hWnd) { // 将焦点置于最前面的子窗口 // “| 0x00000001”用于将所有附属窗口置于前台并 // 激活这些窗口。 SetForegroundWindow((HWND)((ULONG) hWnd | 0x00000001)); return 0; } #endif // WIN32_PLATFORM_PSPC || WIN32_PLATFORM_WFSP if (!MyRegisterClass(hInstance, szWindowClass)) { return FALSE; } hWnd = CreateWindow(szWindowClass, szTitle, WS_VISIBLE, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, NULL, NULL, hInstance, NULL); if (!hWnd) { return FALSE; } #ifdef WIN32_PLATFORM_PSPC // 使用 CW_USEDEFAULT 创建主窗口时，将不会考虑菜单栏的高度(如果创建了一个 // 菜单栏)。因此，我们要在创建窗口后调整其大小 // 如果菜单栏存在 if (g_hWndMenuBar) { RECT rc; RECT rcMenuBar; GetWindowRect(hWnd, &rc); GetWindowRect(g_hWndMenuBar, &rcMenuBar); g_iMenuHeight = rcMenuBar.bottom - rcMenuBar.top; rc.bottom -= g_iMenuHeight; MoveWindow(hWnd, rc.left, rc.top, rc.right-rc.left, rc.bottom-rc.top, FALSE); } #endif // WIN32_PLATFORM_PSPC ShowWindow(hWnd, nCmdShow); UpdateWindow(hWnd); return TRUE; } // // 函数: WndProc(HWND, UINT, WPARAM, LPARAM) // // 目的: 处理主窗口的消息。 // // WM_COMMAND - 处理应用程序菜单 // WM_PAINT - 绘制主窗口 // WM_DESTROY - 发送退出消息并返回 // // LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam) { int wmId, wmEvent; PAINTSTRUCT ps; HDC hdc; SIZE size; TCHAR msg[256] = L""; RECT rect; static SHACTIVATEINFO s_sai; switch (message) { case WM_COMMAND: wmId = LOWORD(wParam); wmEvent = HIWORD(wParam); // 分析菜单选择: switch (wmId) { case IDM_HELP_ABOUT: DialogBox(g_hInst, (LPCTSTR)IDD_ABOUTBOX, hWnd, About); break; case IDM_FULLSCREEN: FullScreen(hWnd, true); break; #ifdef WIN32_PLATFORM_PSPC case IDM_OK: SendMessage (hWnd, WM_CLOSE, 0, 0); break; #endif // WIN32_PLATFORM_PSPC default: return DefWindowProc(hWnd, message, wParam, lParam); } break; case WM_CREATE: #ifdef SHELL_AYGSHELL SHMENUBARINFO mbi; memset(&mbi, 0, sizeof(SHMENUBARINFO)); mbi.cbSize = sizeof(SHMENUBARINFO); mbi.hwndParent = hWnd; mbi.nToolBarId = IDR_MENU; mbi.hInstRes = g_hInst; if (!SHCreateMenuBar(&mbi)) { g_hWndMenuBar = NULL; } else { g_hWndMenuBar = mbi.hwndMB; } // 初始化外壳程序激活信息结构 memset(&s_sai, 0, sizeof (s_sai)); s_sai.cbSize = sizeof (s_sai); #endif // SHELL_AYGSHELL break; case WM_PAINT: hdc = BeginPaint(hWnd, &ps); // TODO: 在此添加任意绘图代码... DrawBoard(hdc); EndPaint(hWnd, &ps); // debug GetWindowExtEx(hdc, &size); wsprintf(msg, L"win ext: x=%d, y=%d/n", size.cx, size.cy); OutputDebugString(msg); GetViewportExtEx(hdc, &size); wsprintf(msg, L"viewport ext: x=%d, y=%d/n", size.cx, size.cy); OutputDebugString(msg); wsprintf(msg, L"screen: cx=%d, cy=%d/n", GetSystemMetrics(SM_CXSCREEN), GetSystemMetrics(SM_CYSCREEN)); OutputDebugString(msg); GetWindowRect(hWnd, &rect); wsprintf(msg, L"win rect: left=%d, top=%d, right=%d, bottom=%d/n", rect.left, rect.top, rect.right, rect.bottom); OutputDebugString(msg); SystemParametersInfo(SPI_GETWORKAREA, 0, &rect, FALSE); wsprintf(msg, L"work area: left=%d, top=%d, right=%d, bottom=%d/n", rect.left, rect.top, rect.right, rect.bottom); OutputDebugString(msg); break; case WM_DESTROY: #ifdef SHELL_AYGSHELL CommandBar_Destroy(g_hWndMenuBar); #endif // SHELL_AYGSHELL PostQuitMessage(0); break; case WM_ACTIVATE: // 向外壳程序通知我们的激活消息 SHHandleWMActivate(hWnd, wParam, lParam, &s_sai, FALSE); break; case WM_SETTINGCHANGE: SHHandleWMSettingChange(hWnd, wParam, lParam, &s_sai); break; case WM_HOTKEY: switch(HIWORD(lParam)) { case VK_TSOFT1: case VK_TSOFT2: { // if we are in full screen mode we want to exit // when the user presses a softkey. if (g_bFullScreen) { //SendMessage(GetDlgItem(hWnd,IDC_EDIT), WM_SETTEXT, 0, (LPARAM)L"[Softkey] Exiting Full Screen"); FullScreen(hWnd, FALSE); } } break; } break; default: return DefWindowProc(hWnd, message, wParam, lParam); } return 0; } // “关于”框的消息处理程序。 INT_PTR CALLBACK About(HWND hDlg, UINT message, WPARAM wParam, LPARAM lParam) { switch (message) { case WM_INITDIALOG: #ifdef SHELL_AYGSHELL { // 创建一个“完成”按钮并调整其大小。 SHINITDLGINFO shidi; shidi.dwMask = SHIDIM_FLAGS; shidi.dwFlags = SHIDIF_DONEBUTTON | SHIDIF_SIPDOWN | SHIDIF_SIZEDLGFULLSCREEN | SHIDIF_EMPTYMENU; shidi.hDlg = hDlg; SHInitDialog(&shidi); } #endif // SHELL_AYGSHELL return (INT_PTR)TRUE; case WM_COMMAND: #ifdef SHELL_AYGSHELL if (LOWORD(wParam) == IDOK) #endif { EndDialog(hDlg, LOWORD(wParam)); return (INT_PTR)TRUE; } break; case WM_CLOSE: EndDialog(hDlg, message); return (INT_PTR)TRUE; } return (INT_PTR)FALSE; } ////////////////////////////// yangbo ////////////////////// void LoadImages(HINSTANCE hInst) { g_hBoard = LoadBitmap(hInst, (LPCWSTR) IDB_BOARD); } void UnloadImages() { if(g_hBoard != NULL) { DeleteObject(g_hBoard); } } void DrawBoard(HDC hdc) { HDC hMemDC; hMemDC = CreateCompatibleDC(hdc); SelectObject(hMemDC, g_hBoard); BitBlt(hdc, 0, 0, 240, 320, hMemDC, 0, 0, SRCCOPY); DeleteDC(hMemDC); } // full screen: ms-help://MS.WindowsMobile.6/WindowsMobile6SDK/html/d4cb5890-0d2c-4c6d-adbb-672c7acf3680.htm // 获取工作区域大小：SystemParametersInfo(SPI_GETWORKAREA, 0, &rc, FALSE); //screen: cx=240, cy=320 //win rect: left=0, top=26, right=240, bottom=294 //work area: left=0, top=26, right=240, bottom=320 // // FUNCTION: SizeFullScreen // // PURPOSE: Change the specified window size to full screen // void SizeFullScreen ( HWND hWnd, // In: Window BOOL bFullScreen // In: TRUE = Size to full screen. FALSE = Undo ) { RECT rc; if (bFullScreen) { // Full screen size SetRect(&rc, 0, 0, GetSystemMetrics(SM_CXSCREEN), GetSystemMetrics(SM_CYSCREEN)); } else { // Normal size SystemParametersInfo(SPI_GETWORKAREA, 0, &rc, FALSE); rc.bottom -= g_iMenuHeight; } MoveWindow( hWnd, rc.left, rc.top, rc.right, rc.bottom, FALSE); } // // FUNCTION: HideShellUI // // PURPOSE: Hide Shell UI components // void HideShellUI ( HWND hWnd, // In: Window BOOL bHide // In: FALSE to show. TRUE to hide. ) { DWORD dwState; dwState = bHide ? (SHFS_HIDETASKBAR | SHFS_HIDESIPBUTTON) : (SHFS_SHOWTASKBAR | SHFS_SHOWSIPBUTTON); // Show/Hide Shell UI SHFullScreen(hWnd, dwState); // We need to hide the tray manually for 2003 SE // and earlier versions of Smartphone. /*if (IsSmartphone2003SEOrOlder()) { HWND hwndTray = FindWindow(L"Tray", NULL); if (hwndTray) { HWND pos = bHide ? HWND_BOTTOM : HWND_TOP; SetWindowPos(hwndTray, pos, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_NOACTIVATE); } } */ } // // FUNCTION: SetSoftkeyBarForFullScreen // // PURPOSE: Setup the softkey for full screen/non full screen mode // void SetSoftkeyBarForFullScreen ( HWND hwndSoftKeyBar, // In: Softkeybar BOOL bFullScreen // In: TRUE = set for full screen. FALSE = undo ) { if (bFullScreen) { // Move softkey bar off-screen. Don't hide it because // a hidden softkey bar will not receive key override // messages. SetWindowPos(hwndSoftKeyBar, NULL, -1, -1, 0, 0, SWP_NOZORDER | SWP_NOACTIVATE ); } else { // Move softkey bar on-screen. int iSoftkeysHeight = g_iMenuHeight; SetWindowPos(hwndSoftKeyBar, NULL, 0, GetSystemMetrics(SM_CYSCREEN) - iSoftkeysHeight, GetSystemMetrics(SM_CXSCREEN), iSoftkeysHeight, SWP_NOZORDER | SWP_NOACTIVATE ); } // Override/Undo softkeys for key press notifications, so we can // display taskbar & softkeys on SK1/SK2 press in full screen. DWORD dwBits; dwBits = bFullScreen ? SHMBOF_NODEFAULT | SHMBOF_NOTIFY : 0; SendMessage(hwndSoftKeyBar, SHCMBM_OVERRIDEKEY, VK_TSOFT1, MAKELPARAM(SHMBOF_NODEFAULT | SHMBOF_NOTIFY, dwBits)); SendMessage(hwndSoftKeyBar, SHCMBM_OVERRIDEKEY, VK_TSOFT2, MAKELPARAM(SHMBOF_NODEFAULT | SHMBOF_NOTIFY, dwBits)); } // // FUNCTION: FullScreen // // PURPOSE: Change the specified window to full screen // void FullScreen ( HWND hWnd, // In: Window BOOL bFullScreen // In: TRUE = Size to full screen. FALSE = Undo ) { g_bFullScreen = bFullScreen; HideShellUI(hWnd, g_bFullScreen); SetSoftkeyBarForFullScreen(g_hWndMenuBar, g_bFullScreen); SizeFullScreen(hWnd, g_bFullScreen); }