MenuStr ()

Display a string menu in the AcuDialog window.


menuVal = MenuStr( name = None, tooltip = None,
                            whatsthis = None, helpURL = None,
                            default = None, settings= None,
                            dbAccess = None, show = None )


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.
default (string)
Default value. If the data base or settings does not contain the parameter given by the dbAccess or settings arguments respectively, it is first initialized to this value.
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, default, tooltip, whatsthis, helpURL, settings, dbAccess and show.


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 default should be in accordance with menu type.


This routine places a string 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 includes values of the first three menus.

For example,
mnuVolAttrStr = AcuDialog.MenuStr(name = 'Volume attribute string',
                                            tooltip = 'attribute string to be used',
                                            whatsthis = 'attribute string',
                                            helpURL = 'vAttrStr.htm',
                                            show = 'values[6] == "group_by_attributes"',
                                            default = 'ACUSIM_TAG' )

This menu is shown only if the value of the seventh menu in AcuDialog is equal to group_by_attributes.