为了说明这些任务,本部分包括多板中的示例,这是典型的多文档界面 (MDI) 应用程序。
注册子窗口和框架窗口类
典型的 MDI 应用程序必须注册两个窗口类:一个用于其框架窗口,一个用于其子窗口。 例如,如果应用程序支持多个类型的文档 (,电子表格和图表) ,则必须为每个类型注册一个窗口类。
框架窗口的类结构类似于非 MDI 应用程序中主窗口的类结构。 MDI 子窗口的类结构与非 MDI 应用程序中子窗口的结构略有不同,如下所示:
类结构应具有图标,因为用户可以将 MDI 子窗口最小化,就像它是普通应用程序窗口一样。
菜单名称应为
NULL
,因为 MDI 子窗口不能有自己的菜单。
类结构应保留窗口结构中的额外空间。 使用此空间,应用程序可以将数据(如文件名)与特定的子窗口相关联。
以下示例演示 Multipad 如何注册其框架和子窗口类。
BOOL WINAPI InitializeApplication()
WNDCLASS wc;
// Register the frame window class.
wc.style = 0;
wc.lpfnWndProc = (WNDPROC) MPFrameWndProc;
wc.cbClsExtra = 0;
wc.cbWndExtra = 0;
wc.hInstance = hInst;
wc.hIcon = LoadIcon(hInst, IDMULTIPAD);
wc.hCursor = LoadCursor((HANDLE) NULL, IDC_ARROW);
wc.hbrBackground = (HBRUSH) (COLOR_APPWORKSPACE + 1);
wc.lpszMenuName = IDMULTIPAD;
wc.lpszClassName = szFrame;
if (!RegisterClass (&wc) )
return FALSE;
// Register the MDI child window class.
wc.lpfnWndProc = (WNDPROC) MPMDIChildWndProc;
wc.hIcon = LoadIcon(hInst, IDNOTE);
wc.lpszMenuName = (LPCTSTR) NULL;
wc.cbWndExtra = CBWNDEXTRA;
wc.lpszClassName = szChild;
if (!RegisterClass(&wc))
return FALSE;
return TRUE;
创建帧和子Windows
注册其窗口类后,MDI 应用程序可以创建其窗口。 首先,它使用 CreateWindow 或 CreateWindowEx 函数创建其框架窗口。 创建框架窗口后,应用程序会再次使用 CreateWindow 或 CreateWindowEx 创建其客户端窗口。 应用程序应将 MDICLIENT 指定为客户端窗口的类名称; MDICLIENT 是由系统定义的预注册窗口类。 CreateWindow 或 CreateWindowEx 的 lpvParam 参数应指向 CLIENTCREATESTRUCT 结构。 此结构包含下表中所述的成员:
hWindowMenu
用于控制 MDI 子窗口的窗口菜单的句柄。 创建子窗口时,应用程序将其标题作为菜单项添加到窗口菜单中。 然后,用户可以通过单击窗口菜单上的标题来激活子窗口。
idFirstChild
指定第一个 MDI 子窗口的标识符。 创建的第一个 MDI 子窗口分配此标识符。 使用递增的窗口标识符创建其他窗口。 销毁子窗口时,系统会立即重新分配窗口标识符,以保持其范围连续。
将子窗口的标题添加到窗口菜单中时,系统会向子窗口分配标识符。 当用户单击子窗口的标题时,框架窗口将收到一条 WM_COMMAND 消息,其中包含 wParam 参数中的标识符。 应为 idFirstChild 成员指定一个值,该成员与框架窗口菜单中的菜单项标识符不冲突。
多板的框架窗口过程在处理 WM_CREATE 消息时创建 MDI 客户端窗口。 以下示例演示如何创建客户端窗口。
case WM_CREATE:
CLIENTCREATESTRUCT ccs;
// Retrieve the handle to the window menu and assign the
// first child window identifier.
ccs.hWindowMenu = GetSubMenu(GetMenu(hwnd), WINDOWMENU);
ccs.idFirstChild = IDM_WINDOWCHILD;
// Create the MDI client window.
hwndMDIClient = CreateWindow( "MDICLIENT", (LPCTSTR) NULL,
WS_CHILD | WS_CLIPCHILDREN | WS_VSCROLL | WS_HSCROLL,
0, 0, 0, 0, hwnd, (HMENU) 0xCAC, hInst, (LPSTR) &ccs);
ShowWindow(hwndMDIClient, SW_SHOW);
break;
子窗口的标题将添加到窗口菜单底部。 如果应用程序使用 AppendMenu 函数将字符串添加到窗口菜单中,则每当创建或) 销毁子窗口时,每当创建或销毁子窗口 (时,子窗口的标题都可以覆盖这些字符串。 向窗口菜单添加字符串的 MDI 应用程序应使用 InsertMenu 函数,并验证子窗口的标题是否未覆盖这些新字符串。
使用 WS_CLIPCHILDREN 样式创建 MDI 客户端窗口,以防止窗口在其子窗口上绘制。
编写主消息Loop
MDI 应用程序的主要消息循环类似于处理加速键的非 MDI 应用程序循环。 区别在于,MDI 消息循环在检查应用程序定义的快捷键或调度消息之前调用 TranslateMDISysAccel 函数。
以下示例演示典型 MDI 应用程序的消息循环。 请注意,如果出现错误, GetMessage 可能会返回 -1。
MSG msg;
BOOL bRet;
while ((bRet = GetMessage(&msg, (HWND) NULL, 0, 0)) != 0)
if (bRet == -1)
// handle the error and possibly exit
if (!TranslateMDISysAccel(hwndMDIClient, &msg) &&
!TranslateAccelerator(hwndFrame, hAccel, &msg))
TranslateMessage(&msg);
DispatchMessage(&msg);
TranslateMDISysAccel 函数将WM_KEYDOWN消息转换为WM_SYSCOMMAND消息,并将其发送到活动的 MDI 子窗口。 如果消息不是 MDI 加速器消息,则函数返回 FALSE,在这种情况下,应用程序使用 TranslateAccelerator 函数来确定是否按下了任何应用程序定义的快捷键。 否则,循环会将消息调度到相应的窗口过程。
编写框架窗口过程
MDI 框架窗口的窗口过程类似于非 MDI 应用程序主窗口的窗口过程。 区别在于,框架窗口过程将它未处理的所有消息传递给 DefFrameProc 函数,而不是传递给 DefWindowProc 函数。 此外,框架窗口过程还必须传递它处理的某些消息,包括下表中列出的消息。
WM_COMMAND
激活用户选择的 MDI 子窗口。 当用户从 MDI 框架窗口的窗口菜单中选择 MDI 子窗口时,将发送此消息。 此消息附带的窗口标识符标识要激活的 MDI 子窗口。
WM_MENUCHAR
当用户按 Alt+ 时打开活动 MDI 子窗口的窗口菜单 – (减去) 键组合。
WM_SETFOCUS
将键盘焦点传递到 MDI 客户端窗口,后者又将其传递给活动的 MDI 子窗口。
WM_SIZE
调整 MDI 客户端窗口的大小以适应新框架窗口的工作区。 如果框架窗口过程将 MDI 客户端窗口的大小调整为不同的大小,则它不应将消息传递给 DefWindowProc 函数。
Multipad 中的帧窗口过程称为 MPFrameWndProc。 MPFrameWndProc 处理其他消息与非 MDI 应用程序类似。 多 板中的WM_COMMAND消息由本地定义的 CommandHandler 函数处理。 对于多板无法处理的命令消息,CommandHandler 调用 DefFrameProc 函数。 如果 Multipad 默认不使用 DefFrameProc ,则用户无法从窗口菜单中激活子窗口,因为单击窗口菜单项发送的 WM_COMMAND 消息将丢失。
编写子窗口过程
与框架窗口过程一样,MDI 子窗口过程默认使用特殊函数来处理消息。 子窗口过程不能处理的所有消息都必须传递给 DefMDIChildProc 函数,而不是传递给 DefWindowProc 函数。 此外,某些窗口管理消息必须传递给 DefMDIChildProc,即使应用程序处理消息,以便 MDI 正常工作。 下面是应用程序必须传递给 DefMDIChildProc 的消息。
创建子窗口
若要创建 MDI 子窗口,应用程序可以调用 CreateMDIWindow 函数或将 WM_MDICREATE 消息发送到 MDI 客户端窗口。 (应用程序可以使用具有WS_EX_MDICHILD样式的 CreateWindowEx 函数来创建 MDI 子窗口。) 单线程 MDI 应用程序可以使用任一方法创建子窗口。 多线程 MDI 应用程序中的线程必须使用 CreateMDIWindow 或 CreateWindowEx 函数在不同的线程中创建子窗口。
WM_MDICREATE消息的 lParam 参数是指向 MDICREATESTRUCT 结构的远指针。 该结构包括四个维度成员: x 和 y,指示窗口的水平和垂直位置, 以及 cx 和 cy,指示窗口的水平和垂直盘区。 这些成员中的任何一个都可以由应用程序显式分配,或者它们可能设置为 CW_USEDEFAULT,在这种情况下,系统根据级联算法选择一个位置、大小或两者。 在任何情况下,都必须初始化所有四个成员。 多板对所有维度使用 CW_USEDEFAULT 。
MDICREATESTRUCT 结构的最后一个成员是样式成员,该成员可能包含窗口的样式位。 若要创建可以具有任意窗口样式组合的 MDI 子窗口,请指定 MDIS_ALLCHILDSTYLES 窗口样式。 如果未指定此样式,则 MDI 子窗口将 WS_MINIMIZE、 WS_MAXIMIZE、 WS_HSCROLL和 WS_VSCROLL 样式作为默认设置。
多板使用本地定义的 AddFile 函数 (位于源文件 MPFILE 中的 MDI 子窗口来创建其 MDI 子窗口。C) 。 AddFile 函数通过将窗口 MDICREATESTRUCT 结构的 szTitle 成员分配给正在编辑的文件的名称或“未命名”来设置子窗口的标题。szClass 成员设置为 Multipad InitializeApplication 函数中注册的 MDI 子窗口类的名称。 hOwner 成员设置为应用程序的实例句柄。
以下示例演示 Multipad 中的 AddFile 函数。
HWND APIENTRY AddFile(pName)
TCHAR * pName;
HWND hwnd;
TCHAR sz[160];
MDICREATESTRUCT mcs;
if (!pName)
// If the pName parameter is NULL, load the "Untitled"
// string from the STRINGTABLE resource and set the szTitle
// member of MDICREATESTRUCT.
LoadString(hInst, IDS_UNTITLED, sz, sizeof(sz)/sizeof(TCHAR));
mcs.szTitle = (LPCTSTR) sz;
// Title the window with the full path and filename,
// obtained by calling the OpenFile function with the
// OF_PARSE flag, which is called before AddFile().
mcs.szTitle = of.szPathName;
mcs.szClass = szChild;
mcs.hOwner = hInst;
// Use the default size for the child window.
mcs.x = mcs.cx = CW_USEDEFAULT;
mcs.y = mcs.cy = CW_USEDEFAULT;
// Give the child window the default style. The styleDefault
// variable is defined in MULTIPAD.C.
mcs.style = styleDefault;
// Tell the MDI client window to create the child window.
hwnd = (HWND) SendMessage (hwndMDIClient, WM_MDICREATE, 0,
(LONG) (LPMDICREATESTRUCT) &mcs);
// If the file is found, read its contents into the child
// window's client area.
if (pName)
if (!LoadFile(hwnd, pName))
// Cannot load the file; close the window.
SendMessage(hwndMDIClient, WM_MDIDESTROY,
(DWORD) hwnd, 0L);
return hwnd;
传入WM_MDICREATE消息的 lParam 参数中的指针将传递给 CreateWindow 函数,并显示为 CREATESTRUCT 结构中的第一个成员,在WM_CREATE消息中传递。 在 Multipad 中,子窗口在 WM_CREATE 消息处理期间初始化自身,方法是在其额外数据中初始化文档变量,并通过创建编辑控件的子窗口。