|MATLAB Function Reference|
Delete specified figure
close deletes the current figure or the specified figure(s). It optionally returns the status of the close operation.
deletes the current figure (equivalent to
deletes the figure identified by h. If h is a vector or matrix,
close deletes all figures identified by h.
deletes the figure with the specified name.
deletes all figures whose handles are not hidden.
close all hidden
deletes all figures including those with hidden handles.
status = close(...)
1 if the specified windows have been deleted and
close function works by evaluating the specified figure's
CloseRequestFcn property with the statement
CloseRequestFcn, closereq, deletes the current figure using delete(get(0,'CurrentFigure')). If you specify multiple figure handles,
close executes each figure's
CloseRequestFcn in turn. If MATLAB encounters an error that terminates the execution of a
CloseRequestFcn, the figure is not deleted. Note that using your computer's window manager (i.e., the Close menu item) also calls the figure's
If a figure's handle is hidden (i.e., the figure's
HandleVisibility property is set to
off and the root
ShowHiddenHandles property is set
on), you must specify the
hidden option when trying to access a figure using the
To delete all figures unconditionally, use the statements
The delete function does not execute the figure's
CloseRequestFcn; it simply deletes the specified figure.
CloseRequestFcn allows you to either delay or abort the closing of a figure once the
close function has been issued. For example, you can display a dialog box to see if the user really wants to delete the figure or save and clean up before closing.
Figure Windows for related functions
© 1994-2005 The MathWorks, Inc.