| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
Arguments: menu menu-item &key position after (at-end t)
Adds menu-item to menu at a
specified position among the current menu-items
or after a menu-item given as the value of
after. at-end is obsolete
(use :position :end
).
Returns the menu-item that was passed in after adding it to menu.
The arguments are:
menu-bar
,
pop-up-menu
, or pull-down-menu
.
menu-item
.
:start
, :end
, or a non-negative
integer. :start
adds the menu-item at the top of
the menu. :end
adds it at the bottom. An integer
indicates an index into the list of menu-items, where zero indicates
the top of the menu and any integer equal to or greater than the
number of menu-items presently in the menu indicates the bottom.
nil
or a menu-item that is presently in the menu or the name of such a menu-item. If
true and the menu-item is found in the menu, then
the new menu-item is placed just below the after menu-item.
The position of the menu-item is determined by the
after argument if it specifies a menu-item that
is present in menu, and otherwise by the position
argument. Note that a menu-item should only be added to one menu. If
a similar menu-item must appear in more than one menu, create copies
(by calling (make-instance 'menu-item)
with
identical arguments or with copy-menu-item) as necessary.
See also open-menu.
Backward compatibility note: All releases after 5.0 replace the at-end argument with the position and after arguments, but at-end will still work for backward compatibility. If at-end is true (and position and after are unspecified), then the menu-item is placed at the bottom of the menu, and otherwise at the top. at-end should not be specified simultaneously with either position or after; an error will be signaled if this is done.
Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.
| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |