windows_programming_notes.nbk: Home | Index | Next Page: win32 msgs: WM_MDIDESTROY | Previous Page: win32 msgs: WM_MDICASCADE

 win32 msgs: WM_MDICREATE

An application sends the WM_MDICREATE message to a multiple document interface (MDI) client window to create an MDI child window.

To send this message, call the SendMessage function with the following parameters.

    SendMessage( 
      (HWND) hWnd,          // handle to destination window 
      WM_MDICREATE,         // message to send
      (WPARAM) wParam,      // not used; must be zero
      (LPARAM) lParam       // creation data (LPMDICREATESTRUCT)
    );

Parameters

• wParam This parameter is not used.
• lParam Pointer to an MDICREATESTRUCT structure containing information that the system uses to create the MDI child window.

Return Values

If the message succeeds, the return value is the handle to the new child window.

If the message fails, the return value is NULL.

Remarks

The MDI child window is created with the style bits WS_CHILD, WS_CLIPSIBLINGS, WS_CLIPCHILDREN, WS_SYSMENU, WS_CAPTION, WS_THICKFRAME, WS_MINIMIZEBOX, and WS_MAXIMIZEBOX, plus additional style bits specified in the MDICREATESTRUCT structure. The system adds the title of the new child window to the window menu of the frame window. An application should use this message to create all child windows of the client window.

If an MDI client window receives any message that changes the activation of its child windows while the active child window is maximized, the system restores the active child window and maximizes the newly activated child window.

When an MDI child window is created, the system sends the WM_CREATE message to the window. The lParam parameter of the WM_CREATE message contains a pointer to a CREATESTRUCT structure. The lpCreateParams member of this structure contains a pointer to the MDICREATESTRUCT structure passed with the WM_MDICREATE message that created the MDI child window.

An application should not send a second WM_MDICREATE message while a WM_MDICREATE message is still being processed. For example, it should not send a WM_MDICREATE message while an MDI child window is processing its WM_MDICREATE message.

Requirements

  Windows NT/2000 or later: Requires Windows NT 3.1 or later.
  Windows 95/98/Me: Requires Windows 95 or later.
  Header: Declared in Winuser.h; include Windows.h.

windows_programming_notes.nbk: Home | Index | Next Page: win32 msgs: WM_MDIDESTROY | Previous Page: win32 msgs: WM_MDICASCADE

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time