hgload
Load graphics object hierarchy from file
Syntax
h = hgload(filename)
[h,old_prop_values] = hgload(...,property_structure)
Description
Note
hgload is not recommended. Use openfig instead.
Warning
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.
Alternatives
Use the File > Open on the figure window menu to access figure files with the Open dialog.
Version History
Introduced before R2006a
