All Manuals > CAPI User Guide and Reference Manual > 21 CAPI Reference Entries

interpret-description Generic Function


Converts an abstract description of a layout's children into a list of objects.




interpret-description layout description interface => result

A layout.
A list, or other Lisp object accepted for some layout class.
A list, each element being a simple-pane, a pinboard-object or a geometry object.

The generic function interpret-description is used by the layout mechanism to translate an abstract description of layout's children (supplied by the initarg :description or (setf layout-description)) into a list of objects to actually use. Each object must be either an element (an object of type simple-pane or of type pinboard-object) or a geometry object (the result of the default method of parse-layout-descriptor). interface is the interface of layout.

The default method specialized on layout expects description to be a list, and returns a list of the values returned by parse-layout-descriptor for each element. Some built-in subclasses of layout have their own methods, which allow different values of description. In these cases the manual page for the layout class describes what description can be.

For example, column-layout expects as its description a list of items where each item in the list is either the slot-name of the child or a string which should be turned into a title pane. This is the default handling of a layout's description, which is done by calling the generic function parse-layout-descriptor to do the translation for each item.

You can define a method for your own layout class. The elements in the returned list must not be returned more than once for layouts that are displayed at the same time.

See also

6 Laying Out CAPI Panes

CAPI User Guide and Reference Manual (Macintosh version) - 01 Dec 2021 19:31:27