MATLAB Function Reference Previous page   Next Page
openfig

Open new copy or raise existing copy of saved figure

Syntax

Description

openfig is designed for use with GUI figures. Use this function to:

openfig('filename.fig','new') opens the figure contained in the FIG-file, filename.fig, and ensures it is visible and positioned completely on screen. You do not have to specify the full path to the FIG-file as long as it is on your MATLAB path. The .fig extension is optional.

openfig('filename.fig','new','invisible') or openfig('filename.fig','reuse','invisible') opens the figure as in the preceding example, while forcing the figure to be invisible.

openfig('filename.fig','new','visible') or openfig('filename.fig','new','visible') opens the figure, while forcing the figure to be visible.

openfig('filename.fig','reuse') opens the figure contained in the FIG-file only if a copy is not currently open; otherwise openfig brings the existing copy forward, making sure it is still visible and completely on screen.

openfig('filename.fig') is the same as openfig('filename.fig','new').

openfig(...,'PropertyName',PropertyValue,...) opens the FIG-file setting the specified figure properties before displaying the figure.

figure_handle = openfig(...) returns the handle to the figure.

Remarks

If the FIG-file contains an invisible figure, openfig returns its handle and leaves it invisible. The caller should make the figure visible when appropriate.

See Also

guide, guihandles, movegui, open, hgload, save

See Deploying User Interfaces in the MATLAB documentation for related functions

See Understanding the Application M-File in the MATLAB documentation for information on how to use openfig.


Previous page  open opengl Next page

© 1994-2005 The MathWorks, Inc.