====== Main Window Menu GUI API Functions ======
[[https://github.com/LibreCAD/LibreCAD_3/blob/master/lcUI/mainwindow.h|Github Link]]
<code lua> namespace lc::ui::api </code>
----

===== Add Menu =====

----

==== Description ====

Add a menu to the MenuBar of the Main Window. Menu is an instance of the Menu GUI class.
Will not add if another menu of the same label already exists in the menu bar.
\\ Note :- Menu of same label may exist in a menu inside a menu of the menu bar i.e. more than one level away from the menu bar.

  * Menu Name - //string//
  * Pointer to Menu GUI object - //menu gui object//

==== Examples ====

  * <code lua> local menu1 = mainWindow:addMenu("Test") </code>
  * <code lua> local menu1 = gui.Menu("Test")
 mainWindow:addMenu(menu1)</code>

----
===== Get Menu =====

----

==== Description ====

Return pointer to menu of the given **name** or **position** present in the menu bar. Returns nullptr if not present.

  * Menu Label - //string//
  * Menu Position - //int// (Starting from 0 on the left most menu)

==== Examples ====

  * <code lua> local menu1 = mainWindow:menuByName("Test") </code>
  * <code lua> local menu2 = mainWindow:menuByPosition(2) </code>

----

===== Remove Menu =====

----

==== Description ====

Remove menu of the given **name** or at the given **position** from the menu bar. Does nothing if menu does not exist in the menu bar.

  * Menu Label - //string//
  * Menu Position - //int// (Starting from 0 as the left most menu)

==== Examples ====

  * <code lua> mainWindow:removeMenu("Test") </code>
  * <code lua> mainWindow:removeMenu(2) </code>

----

===== Find Menu Item =====

----

==== Description ====

Find and return the first menu item found of the given **label**/**object name** present in any of the menus recursively (menu bar as well as menus inside other menus).

  * Menu Item Label - //string//
  * Menu Item Qt Object Name - //string//
==== Examples ====

  * <code lua> local item1 = mainWindow:findMenuItem("Ellipse") </code>
  * <code lua> local item2 = mainWindow:findMenuItemByObjectName("actionNew") </code>

----