popuplink Parameter

Add menu items already defined on the menu bar to the pop-up menu in the Editor window.

Note: This parameter is valid only in an Editor window.

Scope: Document

Syntax

set popuplink.Id [Item][.SubItem ][...] [Ordinal] 

Options

Id 
Either the predefined Editor name for an Editor-defined pop-up menu item, or a numeric value for a user-added item. The numeric value can be obtained by querying the popupmenuid parameter.
Item 
Pop-up menu item to which the new menu item should be linked.
SubItem 
Pop-up sub-menu item to which the new menu item should be linked.
Ordinal 
Integer value of zero or greater, defining the position in which the new item is placed in the specified pop-up menu or sub -menu.

Description

The popuplink parameter lets you link, to the pop-up menu, items already defined in the menu bar and its sub-menus. You can place a linked menu item on the main pop-up menu, or in any pop-up sub- menu.

If the menu or sub-menu location specified does not exist, it is created.

If no menu or sub-menu is specified, the linked menu item is placed on the main pop-up menu.

Example

To add the Open new view choice from the File pull-down menu to the third position in the pop-up menu (in the Editor window), type:

set popuplink.LP_NEWVIEW 2 

API Return Code

-1 
Incorrect parameter specified.

popupinit Parameter
popupmenu Parameter
popupmenuid Parameter
popupmenulist Parameter