Application-defined Data (GNU Octave (version 6.2.92))

Next: Object Groups, Previous: Callbacks, Up: Advanced Plotting [Contents][Index]

#### 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.

Next: Object Groups, Previous: Callbacks, Up: Advanced Plotting [Contents][Index]