lmgrInsertMenuItems

lmgrInsertMenuItems( 
t_menuItem 
t_popupSet 
l_names
) 
=> t / nil

Description

Inserts the named objects into the menu directly before the indicated menu item. An object can be an entire menu. Each menu item or menu can be inserted or added to only one menu. Likewise, any menu item can appear at most once in each pop-up menu. Menus can not be inserted (added) to a pop-up. Pop-ups must remain a flat structure only. You cannot insert or add pop-ups to menus. This function is similar to lmgrAddMenuItems(), except in the meaning of the first argument.

Only menus can be added to the main pull-down menubar. This is indicated by specifying an empty string "" or the reserved name menuBar for the t_menuName argument. It is also legal to specify the t_menuItem argument as pop-up or nil when the sole purpose is to add an already added user-defined object to an indicated pop-up set.

If radio items are added to a particular menu, then only radio items may be added to that menu. The pull-down menu or submenu may not contain both radio and non-radio items.

This SKILL API can be used in cdsLibMgr.il only.

Arguments

t_menuName	The name of the menu to which the items are added.
t_popupSet	A string of characters indicating which pop-ups this item is to be included in. The pop-up set is a string including 0 or more characters using the following mapping: L = included in library list C = included in cell list V = included in view list l = included in library file list c = included in cell file list v = included in view file list t = included in category list
l_names	List of item names that indicates items to be added.

Value Returned

t	All arguments were processed without error.
nil	An error occurred. You might have added a menu item to more than one menu or added a menu item that does not exist.

Examples

; Add into the Edit pull-down menu, before the Copy item
; and not into any popups
lmgrInsertMenuItems ( "copySimpleButton" "" '( "myMenuItem2" ) ) => t

Related Topics

lmgrCreateMenu

lmgrCreateMenuItem

lmgrDeleteMenuItems

Return to top