lmgrAddMenuItems

lmgrAddMenuItems( 
t_menuName 
t_popupSet 
l_names 
) 
=> t / nil 

Description

Appends the named objects to the specified menu. An item can be another menu. Each menu item or menu can be added to only one menu. Likewise, any menu item can appear at most once in every pop-up menu. Menus cannot be added to a pop-up. Pop-ups must remain a flat structure only. Pop-ups cannot be added to menus.

You can add only menus to the main pull-down menu bar. Do this by specifying an empty string "", or the reserved name menuBar for the t_menuName argument. It is also legal to specify the t_menuName argument as popup or nil when the sole purpose is to add an already added object to an indicated pop-up set.

If radio items are added to a particular menu, then only radio items can be added to that menu. The pull-down menu or submenu cannot 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 items are added.
t_popupSet	A string of characters indicating which pop-ups this item is also 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

Adding myMenuItem1 to the MyPulldown menu and then adding MyPulldown menu to menuBar.

; Add into the new pull-down menu and into
; the Library and Cell popups
lmgrAddMenuItems ( "MyPulldown" "LC" '( "myMenuItem1" ) )

=> t
; Add the new pull-down menu into the menu banner
lmgrAddMenuItems ( "menuBar" "" '( "MyPulldown" ) )

=> t

Related Topics

lmgrCreateMenu

lmgrCreateMenuItem

lmgrDeleteMenuItems

Return to top