Share via

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 子窗口的 window 类。 类名必须已通过对 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 [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll

请参阅

概念性

CreateWindow

多文档接口

引用

RegisterClassEx

WM_MDICREATE