Windows SDK笔记(七)：创建MDI窗口

Windows SDK笔记(七)：创建MDI窗口
作者：

一、概述
MDI窗口包含一个框架窗口和若干子窗口。
实际上，框架窗口本身是一个普通主窗口，不过它的客户去被一个特殊窗口覆盖。
这个特殊窗口是系统预定义的“窗口类”，类名称为："MDICLIENT"。它负责各个MDI子窗口的管理。

二、窗口建立
1.注册一个MDI框架窗口类，提供MDI框架窗口消息处理函数
MDI框架窗口消息处理函数中，将未处理消息交由DefFrameProc处理

//MDI框架窗口消息处理函数
LRESULT CALLBACK MDIFrameWndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
	//...
	
	//其他消息交给由系统提供的缺省框架处理函数DefFrameProc
	//其中，第二个参数是客户区窗口句柄
	return ::DefFrameProc (hwnd,hwndClient, message, wParam, lParam) ;
}

2.注册多个MDI子窗口类、对应提供各MDI子窗口的消息处理函数
子窗口消息处理函数中，将未处理消息交由MDIDefMDIChildProc处理

//MDI子窗口消息处理函数
LRESULT CALLBACK MDIChildWndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
	//...
	//...
	
	//其他消息交给由系统提供的缺省MDI子窗口处理函数
	return ::DefMDIChildProc (hwnd, message, wParam, lParam) ;
}

3.在框架窗口的客户区建立MDI管理子窗口
MDI子窗口的管理实际上是由框架窗口客户区的"MDILIENT"窗口完成的。
这是一个系统预定义的窗口。

在主窗口收到WM_CREATE消息后:

case WM_CREATE:
{
	hinst=((LPCREATESTRUCT) lParam)->hInstance;
			
	//填充CLIENTCREATESTRUCT结构
	CLIENTCREATESTRUCT clientcreate ;
	clientcreate.hWindowMenu  = hMenuInitWindow ;   //用于添加窗口列表的菜单句柄
	clientcreate.idFirstChild = 50000 ;	//起始ID

	hwndClient =CreateWindowEx(0,
		"MDICLIENT",	//类名称为"MDICLIENT"
		NULL,
		WS_CHILD |WS_CLIPCHILDREN| WS_VISIBLE,
		0,
		0,
		0,
		0,
		hwnd,
		(HMENU)1,//ID
		hinst,	//实例句柄
		&clientcreate);	//参数
}
return 0;

窗口的大小没有关系，缺省的框架窗口消息处理函数为让它覆盖整个客户区。
MDI客户区窗口建立后，通过向它发送消息管理子窗口的建立、销毁、排列等等。

4.MDI子窗口的建立
可以在菜单中添加命令项，以建立子窗口。
框架窗口的消息处理函数收到命令后，向MDI客户区窗口发建立命令。

case ID_NEW:
{
	MDICREATESTRUCT mdicreate;
	mdicreate.szClass = szMDIChildName ;	//MDI子窗口的类名称
	mdicreate.szTitle = TEXT ("Hello") ;
	mdicreate.hOwner  = hinst ;
	mdicreate.x       = CW_USEDEFAULT ;
	mdicreate.y       = CW_USEDEFAULT ;
	mdicreate.cx      = CW_USEDEFAULT ;
	mdicreate.cy      = CW_USEDEFAULT ;
	mdicreate.style   = 0 ;
	mdicreate.lParam  = 0 ;
	SendMessage (
		hwndClient, //MDI客户区窗口句柄
		WM_MDICREATE, //创建MDI子窗口
		0,
		(LPARAM) (LPMDICREATESTRUCT) &mdicreate //创建参数
		) ;

}
break;

三、消息循环中处理针对MDI的热键
在消息循环中，用TranslateMDISysAccel处理针对MDI的热键。

while (GetMessage (&msg, NULL, 0, 0))
{
     if (!TranslateMDISysAccel (hwndClient, &msg) &&
         !TranslateAccelerator (hwndFrame, hAccel, &msg))
     {
          TranslateMessage (&msg) ;
          DispatchMessage (&msg) ;
     }
}

四、命令的流向
框架窗口在收到WM_COMMAND等通知消息后，应该给当前激活的MDI窗口提供处理机会。

case WM_COMMAND:
switch (LOWORD (wParam))
{
	//针对框架的命令
	case ID_ONE:		
		//...
		return 0;
	//针对MDI子窗口管理的命令		
	case IDM_WINDOW_TILE: 
		SendMessage (hwndClient, WM_MDITILE, 0, 0) ;
		return 0 ;
 
	//针对子窗口的命令又子窗口去处理	              
	default:
		hwndChild = (HWND) SendMessage (hwndClient,
                                               WM_MDIGETACTIVE, 0, 0) ;
		if (IsWindow (hwndChild))
			SendMessage (hwndChild, WM_COMMAND, wParam, lParam) ;
               
               break ;        //..and then to DefFrameProc
}
break ;  //跳出针对WM_COMMAND的case分支，又DefFrameProc处理剩下的命令

五、子窗口的管理
1.概述
给MDI客户区窗口发控制消息即可
如:

case WM_COMMAND:
switch (LOWORD (wParam))
{
	case IDM_WINDOW_TILE:
		SendMessage (hwndClient, WM_MDITILE, 0, 0) ;
		return 0 ;
               
	case IDM_WINDOW_CASCADE:
		SendMessage (hwndClient, WM_MDICASCADE, 0, 0) ;
		return 0 ;
               
	case IDM_WINDOW_ARRANGE:
		SendMessage (hwndClient, WM_MDIICONARRANGE, 0, 0) ;			
		return 0;
               
        //...
        //...
}
break;

2.当前子窗口的关闭
关闭当前激活窗口时，先向该窗口发送查询消息:WM_QUERYENDSESSION。
子窗口的消息处理循环中响应此消息，作关闭前的一些处理，若能关闭，返回真
否则返回假。
框架窗口中根据此返回值决定是否关闭窗口。

如果用户直接按下子窗口的关闭按钮，则WM_CLOSE消息直接发送到了子窗口消息处理函数。

例如:
框架窗口命令处理中:

case IDM_FILE_CLOSE:          
//获得当前激活窗口
hwndChild = (HWND) SendMessage (hwndClient, WM_MDIGETACTIVE, 0, 0);
//询问通过后，销毁窗口
if (SendMessage (hwndChild, WM_QUERYENDSESSION, 0, 0))
     SendMessage (hwndClient, WM_MDIDESTROY, (WPARAM) hwndChild, 0);
return 0;

子窗口的消息处理函数中:

LRESULT CALLBACK HelloWndProc (HWND hwnd, UINT message, 
                               WPARAM wParam, LPARAM lParam)
{
     switch (message)
     {
	//...
	//...

     case WM_QUERYENDSESSION:
     case WM_CLOSE:
          if (IDOK != MessageBox (hwnd, TEXT ("OK to close window?"),
                                  TEXT ("Hello"), 
                                  MB_ICONQUESTION | MB_OKCANCEL))
               return 0 ;
               
          break ;   // i.e., call DefMDIChildProc
     }
     return DefMDIChildProc (hwnd, message, wParam, lParam) ;
}

3.关闭所有子窗口
当使用命令方式关闭所有子窗口时，需要枚举所有子窗口进行关闭。
例:
框架窗口响应命令:

case IDM_WINDOW_CLOSEALL:    
	//针对所有子窗口执行CloseEnumProc
	EnumChildWindows (hwndClient, CloseEnumProc, 0) ;
	return 0 ;

枚举函数:

BOOL CALLBACK CloseEnumProc (HWND hwnd, LPARAM lParam)
{
     if (GetWindow (hwnd, GW_OWNER))         // Check for icon title
          return TRUE ;
     
     SendMessage (GetParent (hwnd), WM_MDIRESTORE, (WPARAM) hwnd, 0) ;
     
     if (!SendMessage (hwnd, WM_QUERYENDSESSION, 0, 0))
          return TRUE ;
     
     SendMessage (GetParent (hwnd), WM_MDIDESTROY, (WPARAM) hwnd, 0) ;
     return TRUE ;
}

六、菜单控制
在MDI程序中，可以根据激活的子窗口而切换框架窗口的菜单。
并且，可以将窗口列表添加到菜单中去。所添加的菜单项命令是又框架对应的缺省消息处理函数完成的。
1.为每种窗口类准备一套菜单资源
2.装载菜单，得到菜单句柄
3.框架在建立时，使用框架菜单的句柄作为参数。
4.子窗口在激活时，加载自己菜单到框架窗口
失去焦点时，还原框架菜单。
使用向MDI客户区窗口发送WM_MDISETMENU或WM_MDISETMENU消息。
wParam为菜单句柄,lParam为欲添加窗口列表的子菜单句柄

case WM_MDIACTIVATE:
         //激活时，设置框架菜单
         if (lParam == (LPARAM) hwnd)
               SendMessage (hwndClient, WM_MDISETMENU,
                            (WPARAM) hMenuHello, (LPARAM) hMenuHelloWindow) ;
               
               
          //失去焦点时，将框架菜单还原
         if (lParam != (LPARAM) hwnd)
               SendMessage (hwndClient, WM_MDISETMENU, (WPARAM) hMenuInit,
                            (LPARAM) hMenuInitWindow) ;
               
          DrawMenuBar (hwndFrame) ;
          
          //注: hwndFrame的得到方法:
          //hwndClient = GetParent (hwnd) ;
          //hwndFrame  = GetParent (hwndClient) ;
          
          return 0 ;

(全文完)
--------------------next---------------------