*menulegalvalue()

Modifies an attribute field so that a selection must be made from a list.

Syntax

*menulegalvalue (string)

Type

HyperMesh Card Previewer Command

Inputs

string
The string that is added to the list you can select from for this *menufield(). The length of string in characters should be less than or equal to the width specified in the *menufield() command.

Example

Below is an example of the *menulegalvalue() command modifying each of the three attribute types:

*menufield("INT FIELD",integer,$INT_ATTRIBUTE,10)
*menulegalvalue(1)
*menulegalvalue(2)
*menulegalvalue(4)
*menulegalvalue(8)
*menufield("REAL FIELD",real,$REAL_ATTRIBUTE,10)
*menulegalvalue(1.1)
*menulegalvalue(1.2)
*menulegalvalue(3.0)
*menufield("STRING FIELD",string,$STRING_ATTRIBUTE,10)
*menulegalvalue("String 1")
*menulegalvalue("String 2")
*menulegalvalue("Last String")

If the *menufield() attribute is of type integer, the string specified in the *menulegalvalue() command is converted to an integer and stored in the attribute.

If the *menufield() attribute is of type real, the string specified in the *menulegalvalue() command is converted to a real number and stored in the attribute.

If the *menufield() attribute is of type string, the string specified in the *menulegalvalue() command is copied to the attribute.

The *menulegalvalue() cannot modify a *menufield() along with a *menuenum()command or a *menurestrictedvalue() command.

Multiple *menulegalvalue() commands may be applied to the same *menufield() command.