Changing the State of Menufields

PML Customisation User Guide

Menus : Editing Bars and Menus : Changing the State of Menufields

You can de-activate a menufield on a menu bar and a field in a menu with the SetFieldProperty() so that it cannot be selected. Similarly, you can make them invisible so you cannot see them.

You can also use SetFieldProperty() to hide a menu field and to select or unselect toggle-type fields.

!menu.SetFieldProperty (<FieldName>, <PropertyName>, Boolean)


Field	Description
<FieldName>	The name of the field you want to change.
<PropertyName>	The name of the property you want to change in the named field. The allowed values are: ‘ACTIVE’ - greyed in or out ‘VISIBLE’ ‑ visible or invisible ‘SELECTED’ - selected or unselected (toggle type fields, only. Specifically, this value cannot be used with bars).
Boolean	The value, TRUE or FALSE, for the property.

Note:

!bar = !!MyForm.bar

!menu = !!MyForm.Menu1

sets local variables !bar and !menu to be references to the bar gadget and Menu1 of form !!MyForm.

will grey-out the menufield on bar that has the field-name “Foo”. And

will activate the menufield on Menu1 that has the field-name “Bar”.

Boolean = !menu.FieldProperty (<FieldName>, <PropertyName>)


Field	Description
<FieldName>	is the name of the field you want to change.
<PropertyName>	is the name of the property you want to change in the named field. The allowed values are: ‘ACTIVE’ - greyed in or out ‘VISIBLE’ ‑ visible or invisible ‘SELECTED’ - selected or unselected (toggle type fields, only. Specifically, this value cannot be used with bars)

Note:

sets local variable !bar to be a reference to the bar gadget of form !!MyForm.