Sets the recent items in a text-input-pane.
A text-input-pane with recent items.
A list of strings.
One of the keywords
:end, or a non-negative integer.
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
argument must be a list of strings.
The strings replace the recent items in the text-input-pane.
Delete from the recent items any item that matches any of the string (using cl:string-equal).
Insert the strings at the beginning of the recent items.
Insert the strings at the end of the recent items.
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.
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.
CAPI User Guide and Reference Manual (Macintosh version) - 25 Feb 2015