SAMPLE: Customizing the MDI Window Menu

• Microsoft Windows Software Development Kit (SDK) for Windows versions 3.0 and 3.1

SUMMARY

The MDIWINMN sample in the Microsoft Software Library demonstrates how to customize the Window menu of a multiple document interface (MDI) frame window. MDIWINMN shows how to limit the number of listed MDI children in the Window menu to any number and how to bring up a customized dialog box when the More Windows menu item is selected. This sample also shows how to list all the MDI children in the Window menu without using a More Windows menu item.

Download MDIWINMN.EXE, a self-extracting file, from the Microsoft Software Library (MSL) on the following services:

• Microsoft Download Service (MSDL)

        Dial (206) 936-6735 to connect to MSDL
        Download MDIWINMN.EXE (size: 26251 bytes) 
  

• Internet (anonymous FTP)

        ftp ftp.microsoft.com
        Change to the \SOFTLIB\MSLFILES directory
        Get MDIWINMN.EXE (size: 26251 bytes) 
  

MORE INFORMATION

To compile, type NMAKE to build the sample; this sample limits the number of MDI child windows listed in the Window menu and brings up the customized dialog box when the More Windows menu item is selected. Type NMAKE MENU=NOLIMIT to build the sample that lists all the the MDI children in the Window menu without using a More Windows menu item.

The following code changes must be made in the window procedure of the MDI frame window to customize the Window menu:

1. Specify NULL as the Window menu handle when creating the MDI client, because the application handles all the processing of the Window menu:

         CLIENTCREATESTRUCT ccs;
         ccs.hWindowMenu  = NULL;
         ccs.idFirstChild = IDM_FIRSTCHILD;
   

2. Update the Window menu using ChangeWindowMenu() when the frame window receives WM_INITMENUPOPUP. ChangeWindowMenu() is implemented in the sample code:

        case WM_INITMENUPOPUP:
             if ((HMENU)wParam == hMenuWindow)
                ChangeWindowMenu(hMenuWindow);
             break;
   
   

3. Call ProcessWindowMenu() in the default processing of WM_COMMAND received by the frame window. ProcessWindowMenu() is implemented in the sample code:

        case WM_COMMAND:
         {
             switch (wParam)
             {
                 :
                 :
              default:
                 if (ProcessWindowMenu(wParam))
                       return 0L;
                 else return DefFrameProc(hwnd, g_hwndMDIClient,
                                         msg, wParam, lParam);
              }
         }
   
   

ProcessWindowMenu() processes WM_COMMAND messages that result from menu selections of MDI children in the Window menu. It also brings up a customized dialog box when the More Windows menu item is selected.