device-close

Generic Function

Package: common-graphics

Arguments: simple-stream abort

This function is called by close when simple-stream is closed, in order to perform clean-up as needed by particular types of windows or other streams. The value of abort is whatever value was passed to close. Additional device-close methods can be written to perform further side effects of windows closing.

If a window is closed by the Windows operating system for some reason other than a programmatic request to do so from Lisp, then close (and device-close) are called with abort set to the value of the constant win:wm_abort, indicating that the actual window is already gone and so device-close need only clean up any Lisp representation of the window and should not query the operating system about the already destroyed actual window. This may be of concern when adding device-close methods if they call Common Graphics functions that call Windows API rather than simply accessing information from the instance of the window.

See also user-close, which is called (prior to device-close) when a user makes a gesture (such as clicking the close box) to close a window. And see device-open.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.