---

15.4.5 应用程序定义的数据¶

Octave 提供了一种将应用程序定义的数据附加到图形句柄的机制。这些数据可以是任何对应用程序有意义的内容，Octave 将完全忽略它们。

 

setappdata (h, name, value) ¶

setappdata (h, name1, value1, name2, value2, …) ¶

setappdata (h, {name1, name2, …}, {value1, value2, …}) ¶

为图形句柄 h 对应的图形对象设置应用程序数据 name 的值为 value。

h 也可以是图形句柄的向量。如果指定名称 name 的应用程序数据不存在，则会创建它。

可以指定多个 name/value 对。或者，可以指定一个元胞数组 names 以及相应的元胞数组 values。有关获取有效应用程序数据属性列表的详细信息，请参阅 getappdata。

另请参阅：getappdata、isappdata、rmappdata、guidata、get、set、getpref、setpref。

 

value = getappdata (h, name) ¶

appdata = getappdata (h) ¶

返回图形句柄 h 对应的图形对象中应用程序数据 name 的值。

h 也可以是图形句柄的向量。如果未指定第二个参数 name，则 getappdata 将返回一个结构体 appdata，其字段对应于 appdata 属性。

另请参阅：setappdata、isappdata、rmappdata、guidata、get、set、getpref、setpref。

 

rmappdata (h, name) ¶

rmappdata (h, name1, name2, …) ¶

从图形句柄 h 对应的图形对象中删除应用程序数据 name。

h 也可以是图形句柄的向量。可以同时指定多个应用程序数据名称以一次性删除多个属性。

另请参阅：setappdata、getappdata、isappdata。

 

valid = isappdata (h, name) ¶

如果图形句柄 h 对应的图形对象中存在名称为 name 的应用程序数据，则返回真。

h 也可以是图形句柄的向量。

另请参阅：getappdata、setappdata、rmappdata、guidata、get、set、getpref、setpref。