| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
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.
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 Common Graphics 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-2012, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 8.2. This page was not revised from the 8.1 page.
Created 2010.1.21.
| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |