small-image-list

Arguments: list-view

An image-list instance that contains the pixmaps to display in the argument list-view when its layout-style is either :small-icon, :list, or :report. May also be nil (the default) to display no icons in these layout styles.

As a shortcut, this property may alternately be specified as a list of pixmap names such as would be passed as the :pixmap-names initarg when calling make-instance on the image-list class. This requires that the pixmaps have been cached already, such as by calling load-pixmap followed by cache-pixmap. In this case, an image-list instance will be created with the specified pixmaps, and that image-list will then be the value of this property. This is handy when specifying an image-list interactively in the inspector while building a form for a dialog. On the other hand, specifying an actual image-list programmatically allows for a single image-list to be shared among multiple list-view controls to save memory or Windows resources.

A small-image-list typically contains pixmaps that are 16 by 16 pixels in size. They can be other sizes, but may get clipped if larger due to the limited space that is reserved for the icons.

The icons will appear only if one or more of the list-view-items of the list-view have non-nil values for their icon-index property.

Examples

Here are three alternate ways of specifying the pixmaps to use as the small icons of a list-view control:

(1) Create the image-list yourself, specifying arbitrary pixmaps:

(setf (small-image-list my-list-view)
      (make-instance 'image-list
        :pixmaps (list my-first-pixmap my-second-pixmap)))
(small-image-list my-list-view) 
  ==> #<image-list :image-list-1 ...>

(2) Create the image-list yourself, specifying the names of cached pixmaps:

(setf (small-image-list my-list-view)
      (make-instance 'image-list
        :pixmap-names '(:default-opened :default-closed)))
(small-image-list my-list-view) 
  ==> #<image-list :image-list-2 ...>

(3) Pass in a list of names of cached pixmaps, letting CG make the image-list internally:

(setf (small-image-list my-list-view)
      '(:default-opened :default-closed))
(small-image-list my-list-view) 
  ==> #<image-list :image-list-3 ...>

See the description of the list-view control.

Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page was not revised from the 6.1 page.
Created 2002.2.26.