通过

CreateMDIWindowA 函数 （winuser.h）

  • 项目

创建多文档界面 （MDI） 子窗口。

语法

HWND CreateMDIWindowA(
  [in]           LPCSTR    lpClassName,
  [in]           LPCSTR    lpWindowName,
  [in]           DWORD     dwStyle,
  [in]           int       X,
  [in]           int       Y,
  [in]           int       nWidth,
  [in]           int       nHeight,
  [in, optional] HWND      hWndParent,
  [in, optional] HINSTANCE hInstance,
  [in]           LPARAM    lParam
);

参数

[in] lpClassName

类型：LPCTSTR

MDI 子窗口的窗口类。 类名必须由对 RegisterClassEx 函数的调用进行注册。

[in] lpWindowName

类型：LPCTSTR

窗口名称。 系统在子窗口的标题栏中显示名称。

[in] dwStyle

类型：DWORD

MDI 子窗口的样式。 如果使用 MDIS_ALLCHILDSTYLES 窗口样式创建 MDI 客户端窗口，此参数可以是 窗口样式 页中列出的窗口样式的任意组合。 否则，此参数限制为以下一个或多个值。

价值 意义
WS_MINIMIZE
0x20000000L
 创建最初最小化的 MDI 子窗口。
WS_MAXIMIZE
0x01000000L
 创建最初最大化的 MDI 子窗口。
WS_HSCROLL
0x00100000L
 创建具有水平滚动条的 MDI 子窗口。
WS_VSCROLL
0x00200000L
 创建具有垂直滚动条的 MDI 子窗口。

[in] X

类型：int

MDI 子窗口的初始水平位置（以客户端坐标为单位）。 如果此参数 CW_USEDEFAULT（int）0x80000000，则为 MDI 子窗口分配默认水平位置。

[in] Y

类型：int

MDI 子窗口的初始垂直位置（以客户端坐标为单位）。 如果此参数 CW_USEDEFAULT，则为 MDI 子窗口分配默认垂直位置。

[in] nWidth

类型：int

MDI 子窗口的初始宽度（以设备单位为单位）。 如果此参数 CW_USEDEFAULT，则为 MDI 子窗口分配默认宽度。

[in] nHeight

类型：int

MDI 子窗口的初始高度（以设备单位为单位）。 如果此参数设置为 CW_USEDEFAULT，则为 MDI 子窗口分配默认高度。

[in, optional] hWndParent

类型：HWND

作为新 MDI 子窗口的父窗口的 MDI 客户端窗口的句柄。

[in, optional] hInstance

类型：HINSTANCE

创建 MDI 子窗口的应用程序实例的句柄。

[in] lParam

类型：LPARAM

应用程序定义的值。

返回值

类型：HWND

如果函数成功，则返回值为创建的窗口的句柄。

如果函数失败，则返回值 NULL。 若要获取扩展的错误信息，请调用 GetLastError。

言论

注意

winuser.h 标头将 CreateMDIWindow 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 winuser.h （包括 Windows.h）
库 User32.lib
DLL User32.dll

另请参阅

概念

CreateWindow

多个文档界面

参考

RegisterClassEx

WM_MDICREATE