addSubMenu

 

5.0

S

Adds a menu item with a submenu to the application.

See also the addMenuItem, execMenuItem, hideMenuItem, and listMenuItems methods.

Note: This method can only be executed during application initialization or console events. See the event object for a discussion of JavaScript events.

Parameters

 

cName	The language-independent name of the menu item. This language-independent name is used to access the menu item (for example, for hideMenuItem).
cUser	(optional) The user string (language-dependent name) to display as the menu item name. If cUser is not specified, cName is used.
cParent	The name of the parent menu item to receive the new submenu. Menu item names can be discovered with listMenuItems.
nPos	(optional) The position within the parent’s submenu to locate the new submenu. The default is to append to the end of the parent’s submenu. Specifying nPos as 0 adds the submenu to the top of the parent’s submenu. The nPos parameter is ignored in certain menus that are alphabetized. The alphabetized menus are • The first section of View > Navigational Panels. • The first section of View > Toolbars. • The first section of the Advanced submenu. Note: When nPos is a number, nPos is not obeyed in the Tools menu. A menu item introduced into the Tools menu comes in at the top of the menu. nPos is obeyed when nPos is a string referencing another user-defined menu item.

Example

See the newDoc method.

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/acrobat_sdk/9/Acrobat9_HTMLHelp/JS_API_AcroJS.88.133.html

Add Comment