| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
Arguments: list-view
An image-list
instance that contains pixmaps to display in this list-view
alongside the main pixmap for
each item, or nil
to not display state icons
in this list-view. When the layout-style of the list-view is
either :list
or :report
, then a
non-nil
state-image-list will also cause an
extra column of space to be reserved to the left of the main icons for
displaying the state icons, even if none of the list-view-items
actually use any of the state-images. If the state-image-list property is left
as nil
, then no extra space is allotted for
state icons.
State icons are intended to show some temporary state of list-view-items, and may be switched frequently by changing the state-icon-index of individual list-view-items. The main (large and small) icons are intended as more permanent identifiers of various types of list-view-items; they may also be switched at will, though this is somewhat less efficient than switching state icons.
As with small-image-list, this property may alternately be specified as a list of names of cached pixmaps as a shortcut.
A state-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 the state-icon-index property.
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 |