add_menu()

Adds an item, menuItemName, to the user-defined menu and associates the AEL function aelFuncName with the item. When you select the item, the function will be called. The user-defined menu appears in the menu bar of the current window and the menu name is set with set_user_menu_label(). Returns: none.

See also: add_separator(), set_user_menu_label(), check_user_menu(), clear_user_menu().

Syntax:

add_menu(menuItemName, aelFuncName, menuName);

where

menuItemName is the name to display as a selectable item in the menu.

aelFuncName is a string. AEL function to call when item is selected (should have no arguments).

menuName is one of these pre-defined internal names. "User", "User2", "User3", "User4", "User5". It is also the name displayed on the top of the menu if it hasn't been changed by a call to set_user_menu_label().

Example:

This example only adds a menu to the first user menu and does not check first to see whether a menu slot has been used. For a complete example, which checks first for an empty slot, refer to "Creating a Custom Menu" in the Customization and Configuration manual.

defun my_func_ael()
{
    fputs(stderr, "my menu");
}
add_menu("myfunc", "my_func_ael", "User");

Download Example File:

The following link(s) lead to the Agilent EEsof EDA Knowledge center website. You will need to register at this site with a valid support contract to download an example file.

Batch Simulation

Where Used:

Graphical user interface