====== Menu Item GUI Class ======
[[https://github.com/LibreCAD/LibreCAD_3/blob/master/lcUI/widgets/guiAPI/menuitem.h|Github Link]]
<code cpp-qt> namespace lc::ui::api </code>
----

===== Menu Item Constructor =====

----

==== Description ====

Constructs a menu item gui object. Menu item after being constructed needs to be added to a menu for it to be visible in the application.

  * Menu Item Name - //string//
  * Menu Item Name - //string// , Lua Callback - //kaguya::LuaRef//

==== Examples ====

  * <code lua> local item1 = gui.MenuItem("Item1")</code>
  * <code lua> local item1 = gui.MenuItem("Item1", function() message("Item1 Clicked") end)</code>

----
===== Add Callback =====

----

==== Description ====

Add lua function callback to be called when the menu item is clicked. Multiple callbacks can be added. Callbacks can also be named callbacks i.e. associated with a name so that it can be later removed by use of the name.

  * Lua Callback - //kaguya::LuaRef//
  * Callback name - //string// , Lua Callback - //kaguya::LuaRef//

==== Examples ====

  * <code lua> item1:addCallback(function() run_command("LINE") end) </code>
  * <code lua> item1:addCallback("message_callback", function() message("Test") end) </code>

----

===== Remove Callback =====

----

==== Description ====

Remove lua function called associated with the given name. Only named callbacks can be removed.

  * Callback name - //string//

==== Examples ====

  * <code lua> item1:removeCallback("message_callback") </code>

----

===== Label =====

----

==== Description ====

Get and set label for the menu item.

==== Examples ====

  * <code lua> message(item1:label()) </code>
  * <code lua> item1:setLabel("New Label")</code>

----

===== Hide and Show =====

----

==== Description ====

Hide or show the menu item.

==== Examples ====

  * <code lua> item1:hide() </code>
  * <code lua> item1:show() </code>

----

===== Position =====

----

==== Description ====

Get the current menu item position or set the menu item position. Other items are rearranged accordingly.

  * New Position - //int//

==== Examples ====

  * <code lua> local pos = item1:position() </code>
  * <code lua> item1:setPosition(2) </code>

----

===== Remove =====

----

==== Description ====

Remove the current menu item from the parent menu.

==== Examples ====

  * <code lua> item1:remove() </code>

----