Main Content


Load graphics object hierarchy from file


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



hgload is not recommended. Use openfig instead.


Security Considerations: The hgload function might execute code contained in a FIG-file as it loads the graphics objects. Avoid calling hgload on untrusted FIG-files.

h = hgload(filename) loads graphics object hierarchy from the FIG-file specified by filename and returns handles to the top-level objects. Specify filename as a character vector or string. 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.

Version History

Introduced before R2006a

See Also