All Manuals > CAPI User Guide and Reference Manual > 21 CAPI Reference Entries

NextPrevUpTopContentsIndex

text-input-pane-set-recent-items

Function
Summary

Sets the recent items in a text-input-pane.

Signature

text-input-pane-set-recent-items text-input-pane strings where

Arguments

text-input-pane

A text-input-pane with recent items.

strings

A list of strings.

where

One of the keywords :replace, :delete, :start and :end, or a non-negative integer.

Values

text-input-pane-set-recent-items does not return a meaningful value.

Description

The function text-input-pane-set-recent-items sets the recent items in a text-input-pane. The text-input-pane must have recent items, that is it must have been created with one of the keyword arguments :search-field, :recent-items or :recent-items-name. The strings argument must be a list of strings.

text-input-pane-set-recent-items modifies the recent items according to the argument where , which can one of:

:replace

The strings replace the recent items in the text-input-pane.

:delete

Delete from the recent items any item that matches any of the string (using cl:string-equal).

:start

Insert the strings at the beginning of the recent items.

:end

Insert the strings at the end of the recent items.

A non-negative integer

Insert the strings at the position indicated by the value. 0 means the same as :start. If the integer is greater than the length of the current recent items list, the strings are inserted in the end of the list.

In all cases, if any of the strings is already in the recent-items list (as compared by cl:string-equal), it is first deleted from the list. This means that passing strings that already exist just moves them around in the list.

Notes

text-input-pane-set-recent-items is a little more efficient than using text-input-pane-recent-items and (setf text-input-pane-recent-items) but the different is unlikely to be significant.

See also

text-input-pane
text-input-pane-replace-recent-items
text-input-pane-delete-recent-items
text-input-pane-append-recent-items
text-input-pane-prepend-recent-items


CAPI User Guide and Reference Manual (Macintosh version) - 3 Aug 2017

NextPrevUpTopContentsIndex