MATLAB Function Reference (Volume 2: Graphics)

Figure Propertiesthat is a valid MATLAB expression or the name of an M-file. The expressionexecutes in the MATLAB workspace.Childrenvector of handlesChildren of the figure. A vector containing the handles of all axes, uicontrol,and uimenu objects displayed within the figure. You can change the order ofthe handles and thereby change the stacking of the objects on the display.Clipping{on} | offThis property has no effect on figures.CloseRequestFcn stringFunction executed on figure close. This property defines a function thatMATLAB executes whenever you issue the close command (either aclose(figure_handle) or a close all), when you close a figure window fromthe computer’s window manager menu, or when you quit MATLAB.The CloseRequestFcn provides a mechanism to intervene in the closing of afigure. It allows you to, for example, display a dialog box to ask a user toconfirm or cancel the close operation or to prevent users from closing a figurethat contains a GUI.The basic mechanism is:• A user issues the close command from the command line, by closing thewindow from the computer’s window manager menu, or by quiting MATLAB.• The close operation executes the function defined by the figureCloseRequestFcn. The default function is named closereq and is predefinedas:delete(get(0,'CurrentFigure'))This statement unconditionally deletes the current figure, destroying thewindow. closereq takes advantage of the fact that the close command makesall figures specified as arguments the current figure before calling therespective close request function.You can set CloseRequestFcn to any string that is a valid MATLAB statement,including the name of an M-file. For example,set(gcf,'CloseRequestFcn','disp(''This window is immortal'')')2-168