CreateMDIWindowA function (winuser.h)

Creates a multiple-document interface (MDI) child window.

Syntax

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
);

Parameters

[in] lpClassName

Type: LPCTSTR

The window class of the MDI child window. The class name must have been registered by a call to the RegisterClassEx function.

[in] lpWindowName

Type: LPCTSTR

The window name. The system displays the name in the title bar of the child window.

[in] dwStyle

Type: DWORD

The style of the MDI child window. If the MDI client window is created with the MDIS_ALLCHILDSTYLES window style, this parameter can be any combination of the window styles listed in the Window Styles page. Otherwise, this parameter is limited to one or more of the following values.

[in] X

Type: int

The initial horizontal position, in client coordinates, of the MDI child window. If this parameter is CW_USEDEFAULT ((int)0x80000000), the MDI child window is assigned the default horizontal position.

[in] Y

Type: int

The initial vertical position, in client coordinates, of the MDI child window. If this parameter is CW_USEDEFAULT, the MDI child window is assigned the default vertical position.

[in] nWidth

Type: int

The initial width, in device units, of the MDI child window. If this parameter is CW_USEDEFAULT, the MDI child window is assigned the default width.

[in] nHeight

Type: int

The initial height, in device units, of the MDI child window. If this parameter is set to CW_USEDEFAULT, the MDI child window is assigned the default height.

[in, optional] hWndParent

Type: HWND

A handle to the MDI client window that will be the parent of the new MDI child window.

[in, optional] hInstance

Type: HINSTANCE

A handle to the instance of the application creating the MDI child window.

[in] lParam

Type: LPARAM

An application-defined value.

Return value

Type: HWND

If the function succeeds, the return value is the handle to the created window.

If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

Requirements

See also

Conceptual

CreateWindow

Multiple Document Interface

Reference

RegisterClassEx

WM_MDICREATE