lmgrSensitizeMenuItems

lmgrSensitizeMenuItems( 
l_names 
g_sensitive 
) 
=> t / nil

Description

Sensitizes the named objects (enabling the active state of named objects) inside their menu hierarchy and pop-up sets. Objects can be either a single item or an entire menu.

You can also specify items that have been predefined by Cadence.

This function has the same effect as specifying the sensitive attribute in lmgrSetObject().

Some Cadence predefined simple items can become sensitive or insensitive dynamically whenever a selection is made. For example, the Check In and Check Out menu items are only sensitive when over a library under design management. Consequently, you might want to permanently disable these menu items by making them unmanaged instead, to avoid your customization being overridden automatically by the Library Manager itself.

This SKILL API can be used in Virtuoso and cdsLibMgr.il.

Arguments

l_names	List of item names to be deleted.
g_sensitive	If `nil`, the menu or menu item is shown grayed-out so that it cannot be selected. Otherwise, it is drawn as normal and can be selected.

Value Returned

`t`	All arguments were processed without error because the named objects exist.
`nil`	An error occurred.

Examples

This example causes the View – Filter menu item to be grayed-out.

lmgrSensitizeMenuItems( list ( "viewFilterButton" ) nil ) => t

Cadence Application Infrastructure SKILL Reference
Product Version IC23.1, November 2023