hgload

从文件中加载图形对象层次结构

语法

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

说明

注意

不推荐使用 hgload。请改用 openfig。

警告

安全注意事项：hgload 函数在加载图形对象时可能会执行 FIG 文件中包含的代码。避免对不受信任的 FIG 文件调用 hgload。

h = hgload(filename) 从由 filename 指定的 Fig 文件中加载图形对象层次结构并返回顶层对象的句柄。以字符向量或字符串形式指定 filename。如果 filename 未包含扩展名，则 MATLAB^® 将添加 .fig 扩展名。

[h,old_prop_values] = hgload(...,property_structure) 使用 property_structure 中的值覆盖 FIG 文件中存储的顶层对象的属性，并在 old_prop_values 中返回这些属性以前的值。

property_structure 必须是一个结构体，具有与属性名称对应的字段名称和新属性值。

old_prop_values 是一个长度等于 h 的元胞数组，包含每个对象的已覆盖属性的旧值。每个元胞包含一个结构体，该结构体具有作为属性名称的字段名称，每个字段名称都包含已更改的每个属性的原始值。property_structure 中指定的任何属性，若其不是 FIG 文件中顶层对象的属性，则其不会包含在 old_prop_values 中。

不可序列化对象（例如默认工具栏和默认菜单）不会被保存，因为它们是在创建图窗时创建的。这样，便可修订默认菜单和工具栏，而不会影响现有的 FIG 文件。