| Allegro CL version 6.2 Unrevised from 6.1 | |||||||||
The class of the list-view 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.
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.
Two notes about the list-view control: (1) icons cannot dragged to new positions by the end user. (2) A list-view should not be modified by a process other than the process that created the list-view, since that appears to confuse this particular control, which is supplied by the operating system. Setting the range or layout-style, for example, in another process can cause temporary hangs and the loss of all items from the control.
See About how to get sample code for creating controls in cgide.htm, which explains how to use the IDE to create such code.
Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page was not revised from the 6.1 page.
Created 2002.2.26.
| Allegro CL version 6.2 Unrevised from 6.1 | |||||||||