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