15.4.5 Application-defined Data

Octave has a provision for attaching application-defined data to a graphics handle. The data can be anything which is meaningful to the application, and will be completely ignored by Octave.

setappdata (h, name, value)

setappdata (h, name1, value1, name2, value3, …)

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

Set the application data name to value for the graphics object with handle h.

h may also be a vector of graphics handles. If the application data with the specified name does not exist, it is created.

Multiple name/value pairs can be specified. Alternatively, a cell array of names and a corresponding cell array of values can be specified. Details on obtaining a list of valid application data properties can be found in getappdata.

See also: getappdata, isappdata, rmappdata, guidata, get, set, getpref, setpref.

value = getappdata (h, name)

appdata = getappdata (h)

Return the value of the application data name for the graphics object with handle h.

h may also be a vector of graphics handles. If no second argument name is given then getappdata returns a structure, appdata, whose fields correspond to the appdata properties.

See also: setappdata, isappdata, rmappdata, guidata, get, set, getpref, setpref.

rmappdata (h, name)

rmappdata (h, name1, name2, …)

Delete the application data name from the graphics object with handle h.

h may also be a vector of graphics handles. Multiple application data names may be supplied to delete several properties at once.

See also: setappdata, getappdata, isappdata.

valid = isappdata (h, name)

Return true if the named application data, name, exists for the graphics object with handle h.

h may also be a vector of graphics handles.

See also: getappdata, setappdata, rmappdata, guidata, get, set, getpref, setpref.