Function

Summary

Updates an item in a choice.

Package

capi

Signature

choice-update-item choice item

Arguments

choice

A choice.

item

An item.

Description

The function choice-update-item updates the display of the item item in the choice choice . It should be called if the display of item (that is, the string returned by the print-function ) changes.

Examples

Create a list panel that displays the status of something

(defun my-print-an-item (item)

        (format nil "~a: ~a" 

                (substitute-if-not #\space 

                                   'alphanumericp 

                                   (symbol-name item))

                (symbol-value item)))

(defvar *status-one* :on)

(defvar *status-two* :off)

(setq list 

      (capi:contain 

       (make-instance 

        'capi:list-panel

        :items '(*status-one* *status-two*)

        :print-function 'my-print-an-item

        :visible-min-height :text-height

        :visible-min-width :text-width)))

Setting the status variables does not change the display:

(setq *status-one* :error)

Update the item to change the display:

(capi:choice-update-item list '*status-one*)

This example also demonstrates choice-update-item:

(example-edit-file "capi/choice/alternative-action-callback")

See also

choice