| 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 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-item
s 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.
| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |