image-list

Class

Package: common-graphics

An image-list object contains an ordered set of pixmaps, for use by certain kinds of widgets. Currently only the list-view widget uses image-lists, where the large-image-list, small-image-list, and state-image-list may each be an image-list object. (Alternately, these list-view properties may be simple lists of the names of cached pixmaps, in which case the list-view internally creates and manages its image-list objects, and so an application typically does not need to deal with image-lists directly itself.)

An image list can be create as simply as this:

(make-instance 'image-list
  :name :main-image-list
  :pixmaps (list butterfly-pixmap worm-pixmap))

where each item in the :pixmaps list is an existing pixmap object, as created (for example) by load-pixmap. If the desired pixmaps have been cached by calling cache-pixmap on them, then the pixmaps can alternately be specified by their names, as in:

(make-instance 'image-list
  :name :main-image-list
  :pixmap-names (list :butterfly :worm))

If the :name initarg is not passed, a unique default name such as :image-list-3 will be used.

Once an image-list has been created, it may be specified as the large-image-list, small-image-list, or state-image-list property of a list-view control.

All of the pixmaps in a single image-list must have the same width, height, and bits-per-pixel. It also must be the case that either all of the pixmaps have a mask or none of the pixmaps have a mask.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Created 2000.10.5.