MATLAB Function Reference

hgload

Loads Handle Graphics object hierarchy from a file

Syntax

• h = hgload('filename')
  [h,old_props] = hgload(...,property_structure)
  h = hgload(...,'all')
  

Description

h = hgload('filename') loads handle graphics objects and its children if any 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 pervious 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.

hgload(...,'all') overrides the default behavior, which does not reload non-serializable objects saved in the file. These objects include the default toolbars and default menus.

Non-serializable objects (such as the default toolbars and the default menus) are normally not reloaded because they are loaded from different files at figure creation time. This allows revisions of the default menus and toolbars to occur without affecting existing FIG-files. Passing the string all to hgload insures that any non-serializable objects contained in the file are also reloaded.

Note that by default, hgsave excludes non- serializable objects from the fig-file unless you use the all flag.

See Also

hgsave, open

Figure Windows for related functions

hex2num

hgsave