DOCUMENT:Q266244 09-MAY-2001 [visualc] TITLE :HOWTO: Create Full-Screen Applications for the PocketPC PRODUCT :Microsoft C Compiler PROD/VER:WINDOWS:3.0 OPER/SYS: KEYWORDS:kbDSupport kbGrpDSETK ====================================================================== ------------------------------------------------------------------------------- The information in this article applies to: - Microsoft eMbedded Visual C++ version 3.0, used with: - Microsoft Windows CE Platform SDK for Pocket PC ------------------------------------------------------------------------------- SUMMARY ======= The documentation clearly describes how to use the SHFullScreen API in a non-Microsoft Foundation Class (MFC) Win32 application to create full-screen windows on the PocketPC. However, the documentation does not describe the same procedure for MFC-based applications. This article describes how to make full-screened applications for the PocketPC by using either the Win32 API or MFC. MORE INFORMATION ================ For applications that target Windows CE, it has become popular to use as much of the screen of the smaller Palm-sized devices as possible. The new user interface (UI) of the PocketPC platform requires additional work for an application to use the entire screen area. To understand the comments in the code examples in the article, the new PocketPC UI terms are described: - The taskbar is located at the top of the screen, displays application captions, and gives the user access to start applications. - The command bar, also known as the menu bar, is located at the bottom of the screen. - The soft input panel (SIP) button is located on the command bar, to the lower-right corner of the screen. To achieve a window that uses as much screen as possible, the application calls SHFullScreen to hide these elements. NOTE: To make dialog boxes full-screen, if the dialog box has any controls with the WS_TABSTOP style set, SHFullScreen will not hide the SIP button. If you notice that the SIP button unexpectedly cannot be hidden, see the dialog box resources in the resource editor and view the properties dialog box for each of the controls. Verify that the Tab Stop check box is not selected for all controls. For a plain Win32 application that uses the CreateWindow or CreateWindowEx function for its main UI, call SHFullScreen to hide the imposing UI elements to enable complete full-screen coverage, call the ShowWindow function to hide the application's command bar, and then adjust the window's size by using the MoveWindow function. The sample code below illustrates this method. This code has been adapted from the SHAPI Win32 Pocket PC SDK sample. #define MENU_HEIGHT 26 RECT rc; //get window size GetWindowRect(hWnd, &rc); SHFullScreen(hWnd, SHFS_HIDETASKBAR | SHFS_HIDESIPBUTTON); ShowWindow(hwndCB, SW_HIDE); MoveWindow(hWnd, rc.left, rc.top-MENU_HEIGHT, rc.right, rc.bottom+MENU_HEIGHT, TRUE); NOTE: If you want to restore the original size of the application, use SHFS_SHOWTASKBAR and SHFS_SHOWSIPBUTTON. However, MoveWindow is called with the bottom parameter decreased by two times the MENU_HEIGHT. For example: // Code to revert back to not full-screen: RECT rc; GetWindowRect(hWnd, &rc); SHFullScreen(hWnd, SHFS_SHOWTASKBAR | SHFS_SHOWSIPBUTTON); ShowWindow(hwndCB, SW_SHOW); MoveWindow(hWnd, rc.left, rc.top+MENU_HEIGHT, rc.right, rc.bottom-(2*MENU_HEIGHT), TRUE); For a Win32 application dialog box, the SHInitDialog function is used in the handler for WM_INITDIALOG. SHInitDialog is used in conjunction with the SHFullScreen function to hide the UI elements and achieve a full-screen dialog box: case WM_INITDIALOG: #define MENU_HEIGHT 26 SHINITDLGINFO shidi; RECT rc; shidi.hDlg = hDlg; shidi.dwMask = SHIDIM_FLAGS; shidi.dwFlags = SHIDIF_FULLSCREENNOMENUBAR; SHInitDialog(&shidi); GetWindowRect(hDlg, &rc); MoveWindow(hDlg, rc.left, rc.top-MENU_HEIGHT, rc.right, rc.bottom, TRUE); SetForegroundWindow(hDlg); SHFullScreen(hDlg, SHFS_HIDETASKBAR | SHFS_HIDESIPBUTTON); The following discusses how to perform similar tasks from within MFC applications. There are two main types of MFC applications for Windows CE, dialog-based and SDI or Document/View support applications. To accomplish what the SHAPI Win32 sample demonstrates, you must access data members of MFC classes. The following illustrates the process for a Document/View type of application. This code is for a command handler that will put the application in full-screen mode: void CMainFrame::OnFullscreen() { #define MENU_HEIGHT 26 RECT rc; //get window size GetWindowRect(&rc); ::SHFullScreen(m_hWnd, SHFS_HIDETASKBAR | SHFS_HIDESIPBUTTON); ::ShowWindow(this->m_hCommandBar, SW_HIDE); MoveWindow(rc.left, rc.top-MENU_HEIGHT, rc.right, rc.bottom+MENU_HEIGHT, TRUE); } If a dialog box is to be displayed to cover the entire screen, similar code is placed in the OnInitDialog handler. One difference is that the MFC framework for PocketPC creates an empty command bar in CDialog that must be hidden: BOOL CMfctest2Dlg::OnInitDialog() { m_bFullScreen = FALSE; CDialog::OnInitDialog(); // Call SHInitDialog with flags for full screen. SHINITDLGINFO shidi; shidi.dwMask = SHIDIM_FLAGS; shidi.dwFlags = SHIDIF_FULLSCREENNOMENUBAR; shidi.hDlg = m_hWnd; SHInitDialog(&shidi); // Set the icon for this dialog box. The framework does this automatically // when the application's main window is not a dialog box. SetIcon(m_hIcon, TRUE); // Set big icon. SetIcon(m_hIcon, FALSE); // Set small icon. // TODO: Add extra initialization here. ::CommandBar_Show(m_pWndEmptyCB->m_hWnd, FALSE); // SHFullScreen fails if dialog box is not foreground. SetForegroundWindow(); SHFullScreen(m_hWnd, SHFS_HIDETASKBAR | SHFS_HIDESIPBUTTON); // Resize the window over the taskbar area. #define MENU_HEIGHT 26 RECT rect; GetWindowRect(&rect); rect.top -= MENU_HEIGHT; MoveWindow(&rect, TRUE); return TRUE; } Additional query words: ====================================================================== Keywords : kbDSupport kbGrpDSETK Technology : kbVCsearch kbAudDeveloper kbWinCEETKSearch Version : WINDOWS:3.0 Issue type : kbhowto ============================================================================= THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY. Copyright Microsoft Corporation 2001.