(octave.info)Application-defined Data

---

Next: Object Groups Prev: Callbacks Up: Advanced Plotting

---

Enter node , (file) or (file)node

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.

     See also: Note: getappdata, *note isappdata:
     XREFisappdata, Note: rmappdata, *note guidata:
     XREFguidata, Note: get, Note: set, *note getpref:
     XREFgetpref, Note: 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: Note: setappdata, *note isappdata:
     XREFisappdata, Note: rmappdata, *note guidata:
     XREFguidata, Note: get, Note: set, *note getpref:
     XREFgetpref, Note: 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: Note: setappdata, *note getappdata:
     XREFgetappdata, Note: 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: Note: getappdata, *note setappdata:
     XREFsetappdata, Note: rmappdata, *note guidata:
     XREFguidata, Note: get, Note: set, *note getpref:
     XREFgetpref, Note: setpref.