REFERENCE GUIDE

Oestroylconshould not be used to destroy any icon that was not created with theCreatelcon function.Parameters hlcon HICON Identifies the icon to be destroyed. The icon mustnot be in current use.Return valueThe return value is nonzero if the function was successful. It is zero if thefunction failed.DestroyMenuSyntaxBOOL DestroyMenu(hMenu)function DestroyMenu(Menu: HMenu): Bool;This function destroys the menu specified by the hMenu parameter andfrees any memory that the menu occupied.Parameters hMenu HMENU Identifies the menu to be destroyed.Return valueThe return value specifies whether or not the specified menu is destroyed.It is nonzero if the menu is destroyed. Otherwise, it is zero.DestroyWindowSyntaxBOOL DestroyWindow(h Wnd)function DestroyWindow(Wnd: HWnd): Bool;This function destroys the specified window. The DestroyWindowfunction hides or permanently closes the window, sending theappropriate messages to the window to deactivate it and remove theinput focus. It also destroys the window menu, flushes the applicationqueue, destroys outstanding timers, removes clipboard ownership, andbreaks the clipboard-viewer chain, if the window is at the top of theviewer chain. It sends WM_DESTROY and WM_NCDESTROY messagesto the window.If the given window is the parent of any windows, these child windowsare automatically destroyed when the parent window is destroyed.DestroyWindow destroys child windows first, and then the window itself.DestroyWindow also destroys modeless dialog boxes created by theCreateDialog function.Parameters h Wnd HWND Identifies the window to be destroyed.Chapter 4, Functions directory 231