All Manuals > CAPI User Guide and Reference Manual > 21 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 => items

Signature

(setf choice-selected-items) items choice => item

Arguments

choice

A choice.

Values

items

A list of items.

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)

Note that interaction :multiple-selection is not supported for lists on Mac OS X.

See also

choice
choice-selected-item
choice-selected-item-p
choice-selected-items
collection
Choices - panes with items


CAPI User Guide and Reference Manual (Windows version) - 25 Feb 2015

NextPrevUpTopContentsIndex