Class Menu : insertMenu Method

Menu insertMenu( String menuName, [ String insertBeforeCommand ] )

Summary

Insert or append a new menu

Parameters

Parameter	Description
String menuName	Name (text) to be used for the menu
String insertBeforeCommand [optional]	The command name of the item you wish to insert before. If you don't provide this parameter then the menu is appended to the menu.

Returns

The newly created Menu object, or null.

Examples

Insert a new menu, Test, before the "customise" item on the Tools menu:

	var menuMain = app.getMainMenu();
	var menuTools = menuMain.getMenu( "&Tools" );

	var menuTest = menuTools.insertMenu( "Test", "SwitchCustomiseSettings" );
	menuTools.insertSeparator( "ShowBrowerVersion" );

	//	add a separator
	menuTest.insertSeparator();

	menuTest.insertItem( "Quick Test", "QuickTest" );

	menuTest.insertSeparator();

Append a menu, Test, to the Tools menu:

	var menuMain = app.getMainMenu();
	var menuTools = menuMain.getMenu( "&Tools" );

	var menuTest = menuTools.insertMenu( "Test" );
	menuTools.insertSeparator( "ShowBrowerVersion" );

	//	add a separator
	menuTest.insertSeparator();

	menuTest.insertItem( "Quick Test", "QuickTest" );

	menuTest.insertSeparator();

Requirements

build 1065