All Manuals > CAPI Reference Manual > 1 CAPI Reference Entries

NextPrevUpTopContentsIndex

list-panel-items-and-filter

Function
Summary

Accesses the unfiltered items and filter in a list-panel

Signature

list-panel-items-and-filter list-panel

(setf list-panel-items-and-filter ) (values items filter ) list-panel

The function list-panel-items-and-filter accesses the unfiltered items and the filter in the list panel list-panel simultanously. It is especially useful for setting the filter and the items without flickering.

list-panel-items-and-filter returns the items and filter in list-panel as multiple values. It is equivalent to

(values (list-panel-unfiltered-items list-panel
)
        (list-panel-filter-state list-panel
))

but is more efficient.

(setf list-panel-items-and-filter) takes the items and filters as two values and sets them in list-panel :

(setf (list-panel-items-and-filter list-panel
)
      (values new-items
 new-filter
))

ends up in the same state as

(progn
  (setf (list-panel-unfiltered-items list-panel
) new-items
)
  (setf (list-panel-filter-state list-panel
) new-filter
))

but the latter form will filter the new-items with the old filter and display the result, and then filter the new-items again with the new-filter , whereas (setf list-panel-items-and-filter) filters the new-items just once, with the new-filter .

See also

list-panel
list-panel-filter-state
list-panel-unfiltered-items


CAPI Reference Manual - 15 Dec 2011

NextPrevUpTopContentsIndex