DisableItem()

Summary

Disables a dialog box item or menu item.

 

Syntax

DisableItem(string item_name)

 

Argument	Contents
item_name	The name of the dialog box item or menu item to disable.

 

Notes

• When called with a dialog box item, the item must be in the current dialog box.

• When called with a menu item, the item must be in the current menu system.

• DisableItem() can be called in the Init macro of a dialog box to disable an item in that dialog box.

Example

if number_of_maps = 0 then

     DisableItem("Close Map menu item")

else

     EnableItem("Close Map menu item")

 

Error Codes

Error Type	Meaning
NotFound	The specified item does not exist or is not part of the current dialog box or menu system.

 

See Also

Function	Summary
EnableItem()	Enables a dialog box item or menu item
HideItem()	Hides an item in a dialog box
ShowItem()	Shows a previously hidden dialog box item