This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.


Load graphics object hierarchy from file


h = hgload('filename')
[h,old_prop_values] = hgload(...,property_structure)



hgload is not recommended. Use openfig instead.

h = hgload('filename') loads graphics object hierarchy from the FIG-file specified by filename and returns handles to the top-level objects. If filename contains no extension, then MATLAB® adds the .fig extension.

[h,old_prop_values] = hgload(...,property_structure) overrides the properties on the top-level objects stored in the FIG-file with the values in property_structure, and returns their previous values in old_prop_values.

property_structure must be a structure having field names that correspond to property names and values that are the new property values.

old_prop_values is a cell array equal in length to h, containing the old values of the overridden properties for each object. Each cell contains a structure having field names that are property names, each of which contains the original value of each property that has been changed. Any property specified in property_structure that is not a property of a top-level object in the FIG-file is not included in old_prop_values.

Nonserializable objects (such as the default toolbars and the default menus) are not saved because they are created when the figure is created. This allows revisions of the default menus and toolbars to occur without affecting existing FIG-files.


Use the File > Open on the figure window menu to access figure files with the Open dialog.

See Also


Introduced before R2006a

Was this topic helpful?