windows_programming_notes.nbk: Home | Index | Next Page: win32 msgs: WM_MDIGETACTIVE | Previous Page: win32 msgs: WM_MDICREATE

 win32 msgs: WM_MDIDESTROY

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

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

    SendMessage( 
      (HWND) hWnd,              // handle to destination window 
      WM_MDIDESTROY,            // message to send
      (WPARAM) wParam,          // handle to child window (HWND)
      (LPARAM) lParam           // not used; must be zero
    );

Parameters

• wParam Handle to the MDI child window to be closed.
• lParam This parameter is not used.

Return Values

This message always returns zero.

Remarks

This message removes the title of the MDI child window from the MDI frame window and deactivates the child window. An application should use this message to close all MDI child windows.

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

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_MDIGETACTIVE | Previous Page: win32 msgs: WM_MDICREATE

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