MenubarSetItem()

Makes the specified menu option sensitive or insensitive. The menu option is identified by the prompts shown in the interface.

Use the MenubarSetItem() method only for incidental changes to menu sensitivity. Menu option sensitivity in general can be set in USoft Definer for each menu option. There are separate settings for a number of application states, such as Query Mode. For this reason, the effect of MenubarSetItem() only lasts until the application state changes.

This method can only be used for menu options that:

•Are located in submenus of the main menu shown in the menubar.

•Do not lead to a further submenu.

Syntax

MenubarSetItem( menu-page-prompt, menu-item-prompt, sensitivity )

sensitivity  :=  { 'On' | 'Off' }

Menu-page-prompt is the name of the menu page as found in the user interface.

Menu-item-prompt is the name of the menu item as found in the user interface.

Sensitivity specifies whether the menu option must be set to sensitive or to insensitive.

Example

MenubarSetItem( 'Record', 'Refresh', 'Off' )

CAUTION: menu-item-prompt can NOT be used to identify a menu item uniquely. You are therefore advised to use this method only on menu items that have unique prompts.