The class of the list-view control.
Control
The list-view control displays a table of textual information. It may include a row of buttons along the top that serve as column headers and which may be clicked in order to sort the rows of the list-view by the values that appear in any column. The column headers may also be stretched to change the width of individual columns.
Note that while the operating system provides for four alternate list-view "views" (as used by the Windows Explorer), Common Graphics presently implements only the "report" view since it does not yet implement the image-list required by the other three views that consist primarily of icons. And the report view may not yet have an icon at the left of each line.
The range
property of a list-view is a list of list-view-item instances, each of
which represents one row of data. The columns property contains a list of
list-view-column instances, each of which represents one column of
data and its header. Each list-view-item has a value-plist property
that contains a value for each column of that row --- this value-plist
is of the form (column-name value column-name value ...).
Starting in release 6.0, the list-view control in CG now supports
icons and alternate layout styles. In earlier releases, the control
did not have the ability to display a graphical icon beside each item,
and therefore also did not support 3 of the 4 layout styles because
they are dependent on the icons. Refer to the documentation for the
following symbols for more information: image-list, large-image-list, small-image-list, state-image-list, icon-index, state-icon-index, layout-style, alignment, auto-arrange, arrange-icons, list-view-item-position, open-image-list, close-image-list, image-list-open-p, and
share-image-lists.
One remaining incapacity of the list-view control is not allowing the icons to be dragged to new positions by the end user. This should work and it is mysterious why it does not.
See About how to get sample code for creating controls in cgide.htm, which explains how to use the IDE to create such code.
Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.
The documentation is described in introduction.htm and the index is in index.htm.
Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.
Created 2000.10.5.