DestroyIcon.md

Home

Function name : DestroyIcon

Group: Icon - Library: user32

---

Destroys an icon and frees any memory the icon occupied.

---

Code examples:

How to view icons stored in executable files (Icon Viewer) - II
System Image List Viewer
How to view icons stored in executable files (Icon Viewer)
Storing screen shot of a form to bitmap file
Retrieving information about the specified icon
Displaying icons in the system tray (VFP9)
Using FoxTray ActiveX control: System Tray Icon and menu attached to VFP form
GDI+: Storing DLL icon resources in image files
Converting image file to .ICO file
Displaying the associated icons and descriptions for files and folders
Detecting changes in connections to removable drives (VFP9)
Windows Shell Icons displayed and exported to ICO files (Vista)
Browsing Windows Known Folders (Special Folders)
GDI+: custom Clock Control

Declaration:

BOOL DestroyIcon(
  HICON hIcon   // handle to icon
);  

---

FoxPro declaration:

DECLARE SHORT DestroyIcon IN user32 INTEGER hIcon  

---

Parameters:

hIcon [in] Handle to the icon to be destroyed. The icon must not be in use.

---

Return value:

If the function fails, the return value is zero.

---

Comments:

It is only necessary to call DestroyIcon for icons and cursors created with the CreateIconIndirect and the CopyIcon functions.

Do not use this function to destroy a shared icon. A shared icon is valid as long as the module from which it was loaded remains in memory. The following functions obtain a shared icon:
- LoadIcon
- LoadImage (if you use the LR_SHARED flag)
- CopyImage (if you use the LR_COPYRETURNORG flag and the hImage parameter is a shared icon)

---