The list view pane is a choice that displays its items as icons and text in a number of formats.
Specifies which view the list view pane shows. The default is
A plist of keywords and image-list objects.
Defines the columns used in report view
The list view inherits its functionality from choice. In many ways it may be regarded as a kind of enhanced list panel, although its behavior is not identical. It supports single selection and extended selection interactions.
The list view displays its items in one of four ways, determined by the value in the
slot. An application may use the list view pane in just a single view, or may change the view between all four available views using
In this view, multiple columns are displayed. A small icon and the item's label is displayed in the first column. Additional pieces of information, known as subitems, are displayed in subsequent columns.
The column heading
The width of the column in pixels. If this keyword is omitted or has the value
, the width of the column is automatically calculated, based on the widest item to be displayed in that column.
to indicate how items should be aligned in this column. The default is
. Only left alignment is available for the first column.
The subitem-function is called on the item to return subitem objects that represent the additional information to be displayed in the subsequent columns. Hence, subitem-function should normally return a list, whose length is one less than the number of columns specified. Each subitem is then printed in its column using the appropriate subitem print function. subitem-print-function may be either a single print function, to be used for all subitems, or a list of functions: one for each subitem column.
This specifies the filename of a file suitable for loading with load-image. Currently this must be a bitmap file.
The symbol must have been previously registered by means of a call to register-image-translation.
As returned by load-image.
Allowing a single bitmap to be created which contains several button images side by side. See make-image-locator for more information. On Microsoft Windows, this also allows access to bitmaps stored as resources in a DLL.
This is a zero-based index into the list view's image list. This is generally only useful if the image list is created explicitly. See image-list for more details.
is called on an item to determine the state image, an additional optional image used to indicate the state of an item. It can return one of the above, or
to indicate that there is no state image. State images may be used in any view, but are typically used in the report and list views.
If image-lists is supplied, it should be a plist containing the following keywords as keys. The corresponding values should be image-list objects.
Specifies an image-list object that contains the large item images. The image-function should return a numeric index into this image-list.
Specifies an image-list object that contains the small item images. The image-function should return a numeric index into this image-list.
Specifies an image-list object that contains the state images. The state-image-function should return a numeric index into this image-list
The image lists must be created explicitly, using the
initarg, and the
must return an integer. Care must be taken to ensure that corresponding images in the
image lists have the same numeric index.
Returning pathnames, strings or image-locators from the image function cause the CAPI to create the image-lists automatically; however, if large and small icon views are mixed, this will lead to incorrect icons (or no icons) being displayed in one or other view.
Note: for some applications multi-column-list-panel will suffice instead of