LispWorks CAPI Reference Manual > 1 CAPI Reference Entries

NextPrevUpTopContentsIndex

choice-selected-items

Generic Function
Summary

The function choice-selected-items returns the currently selected items in a choice as a list of the items.

Package

capi

Signature

choice-selected-items choice

Signature

(setf choice-selected-items) items choice

Description

The function choice-selected-items returns the currently selected items in a choice as a list of the items. A setf method is provided as a means of setting the currently selected items. Note that the items are compared by choice 's test-function - see collection for details.

In the case of :single-selection choices, it is usually easier to use the complementary function choice-selected-item, which returns the selected item as its result.

Example

First we set up a :multiple-selection choice -- in this case, a list panel.

(setq list (capi:contain
            (make-instance 
             'capi:list-panel 
             :items '(a b c d e)
             :visible-min-height '(:character 5)
             :interaction :multiple-selection
             :selection '(1 3))))

The following code line returns the selections of the list.

(capi:choice-selected-items list)

The selections of the list panel can be changed and redisplayed using the following code.

(capi:apply-in-pane-process
 list #'(setf capi:choice-selected-items) 
 '(a c e) list)
(capi:choice-selected-items list)
See also

choice
choice-selected-item
collection


LispWorks CAPI Reference Manual - 21 Dec 2009

NextPrevUpTopContentsIndex