state-image-list

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-items of the list-view have non-nil values for the state-icon-index property.

See list-view.

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