4 3 3 Menu State

4.3.3 Menu State

The Menu State allows you to control when you want to show the menu item in the Menu component. For each item in the Menu component, you can choose to:

• Always show the item.
  Select the Always shown in the Menu component option.

• Only show the item if a particular field exists in your application, and the value of the field is not blank or not zero.
  Select the Only shown if the field condition is TRUE option. The name of the field used to determine the state of the item is specified in the Field to check field. For example, if you enter a field name and the field exists in your function (it must also be non blank or not zero), then the condition is considered TRUE and the menu item is displayed.
  
  In addition, you can choose to only show the item if the specified field contains a particular value. This means that even though the field exists in the LANSA function and it is non blank or not zero, the menu item will only be shown if the current field value matches the value you had specified in the Value to check field.

• Only show the item if a particular field does not exist in your application, or if it exists, the item is only shown if the current field value is blank or zero.
  Select the Only shown if the field condition is FALSE option. This option is the reverse of the option previously described. For example, if you enter a field name but the field does not exist in your function, then the condition is considered FALSE and the menu item is displayed.

Fields that are part of a list cannot be used to determine the menu state.

• System variables can be used as both the "value to check" and the "field to check". For example, *FUNCTION (field to check) equal WIZ02 (value to check).

• Any field referenced in the "field to check" must be available to evaluate. For example, if #FUNCTION is not referenced directly in your RDML use *FUNCTION to evaluate the current function name.