destroy-icon-handle

Arguments: handle

Destroys the icon indicated by the handle argument so that the icon can no longer be drawn, freeing the associated operating system resources. It is not normally necessary to call this function, since icon resources are always freed when Lisp is exited. But if an application creates many icons, then it is possible to run out of icon resources, in which case this function should be called on icons that are no longer being used.

It is safe to call this function on an icon if all of the following are true:

• The icon is no longer the icon property of any window.
• The icon is no longer the pixmap-icon property of any pixmap that may still get drawn.
• The application will no longer draw the icon explicitly by calling draw-icon.

handle should be an integer that was returned by a call to either extract-icon-from-file or create-icon-handle.

Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page is new in the 6.2 release.
Created 2002.2.26.