View source for Enable.item

The '''enable.item''' command enables a menu item that has been previously disabled.

== Syntax ==

enable.item([[controllers|ctl]] cA);

== Remarks ==

This command will enable all [[menu]] items that match [[controllers|controller]] '''cA'''. Enabled items can be selected by the player. Use the '''[[disable.item]]''' command to disable menu items.

If the item is already enabled, or the controller is not assigned to a menu item, this command has no effect.

If multiple controllers use [[controller]] cA, all of them will be enabled when using the '''enable.item''' command.

All menu items are re-enabled whenever a game is [[restarted]].
== Possible Errors ==

Do not use the '''enable.item''' command unless a [[menu]] has already been created. AGI will attempt to read invalid data, which at best will have no effect, but could potentially crash AGI.

== Example ==

<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="agi">
[ build a simple menu system
set.menu("Info");
set.menu.item("About   ", c0);
set.menu.item("Help    ", c1);
set.menu("File");
set.menu.item("Save Game      <F5>", c2);
set.menu.item("Restore Game   <F7>", c3);
set.menu.item("-------------------", c20);
set.menu.item("Restart Game   <F9>", c4);
set.menu.item("-------------------", c20);
set.menu.item("Quit        <Alt Z>", c5);

[ disable the save command
disable.item(c2);

[ submit menu to agi
submit.menu()
...
enable.item(c2); [ player is now allowed to save games
</syntaxhighlight>

== Technical Information ==

{| border="1" cellpadding="2"
| style="background-color: #efefef" width="200" | '''Required Interpreter Version:'''
| width="175" | Available in version 2.272 and above. 
|-
| style="background-color: #efefef" | '''Byte-Code Value:'''
| 159 (0x9F hex)
|}
The menu commands were actually added in [[version 2.272]], but the commands did not do anything - they were all null functions. Code to support menus was not added to the commands until version 2.411.

== See Also ==

[[disable.item]]<br />
[[Category:Commands]]<br />