MenuInfo ()

Usage

menuVal = MenuInfo( name = None, tooltip = None,
                             whatsthis = None, helpURL = None,
                             value = None, settings= None,
                             dbAccess = None, show = None )

Parameters

name (string)

Label of the menu. This is displayed on the left.

tooltip (string)

Tooltip help information, also known as bubble. The content of this argument is displayed in a small dynamic box placed opened above the menu, when the cursor remains at the menu for short time. This is typically a short phrase.

whatsthis (string)

Whatsthis help information. When you click on the whatsthis icon followed by clicking on this menu, a small box is opened above the menu and the content of this argument is displayed in it. This is typically a short sentence or two, which provides more information than that given by the tooltip argument. The whatsthis argument is a rich text format, which means you can embed many of the HTML tags, such as <br> for line separator and <b> for bold.

helpURL (string)

This is the HTML-URL address containing detail help on the menu item. When you press the F1 key while the cursor is on top of this menu, the assistance help system opens and displays this page.

value (string)

The default value which is shown as the information in this menu.

settings (string)

The setting name which is used for storing the menu value in the settings.

dbAccess (list)

The data base information which is used for storing the menu value in the data base. It is a list that includes data base name, node and unique par (parameter name) used for this menu value.

show (string)

The conditional show statement which will be evaluated to determine if this menu should be shown or not.

Return Value

menuVal (list)

A list filled with all the information about this menu including type of the menu, name, tooltip, whatsthis, helpURL, value, settings, dbAccess and show.

Errors

Only one of the dbAccess or settings could be specified and passed to menu function.

The show statement should be a logical correct conditional expression.

The value should be string.

Description

This routine places an information menu in the AcuDialog window. The menu contains a label given by the name. The menu information is given by tooltip, whatsthis and helpURL. The displayed value is extracted from the dbAccess or settings. Upon change, the value is deposited back onto the data base or settings. The show statement is a conditional expression which starts with values word and evaluates any member in the values list. The values is a list that includes all the previous menu's values. For example, if the current menu is the fourth menu in the dialog, the values include values of the first three menus.

mnuInfo = AcuDialog.MenuInfo( name = 'Problem info',
                                       tooltip = 'problem info',
                                       whatsthis = 'problem info',
                                       helpURL = 'problem_info.htm',
                                       value = 'Some Information',
                                       show = 'values[5] != False',
                                       settings = None )

This menu is shown only if the value of the sixth menu in AcuDialog is not False.