LispWorks CAPI Reference Manual > 1 CAPI Reference Entries

NextPrevUpTopContentsIndex

destroy

Generic Function
Summary

Closes a window and calls the destroy-callback .

Package

capi

Signature

destroy interface

Description

The generic function destroy closes the window associated with interface , and then calls the interface's destroy-callback if it has one.

There is a complementary function quit-interface which calls the interface's confirm-destroy-function to confirm that the destroy should be done, and it is advisable to always use this unless you want to make sure that the interface's confirm-destroy-function is ignored.

Note: destroy must only be called in the process of interface . Menu callbacks on interface will be called in that process, but otherwise you probably need to use execute-with-interface or apply-in-pane-process.

Example
(setq interface
      (capi:display (make-instance
                     'capi:interface
                     :title "Test Interface"
                     :destroy-callback
                       #'(lambda (interface)
                           (capi:display-message
                             "Quitting ~S"
                              interface)))))
(capi:apply-in-pane-process 
 interface 'capi:destroy interface)
See also

interface
quit-interface
*update-screen-interfaces-hooks*


LispWorks CAPI Reference Manual - 21 Dec 2009

NextPrevUpTopContentsIndex