small-image-list

Arguments: list-view

An image-list instance that contains the pixmaps to display in this 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.

Here are three alternative ways of specifying the cached pixmaps named :default-opened and :default-closed as the small icons of a list-view control:

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

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

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

See list-view.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.