BansheeEngine/BansheeEditor/Include/BsGUIMenuBar.h

#pragma once

#include "BsEditorPrerequisites.h"
#include "BsShortcutKey.h"

namespace BansheeEngine
{
	/**
	 * @brief	A menu bar GUI element that contains a horizontal list of elements that can each be expanded into a 
	 * 			hierarchical sub-menus, as well as a list of tool bar buttons.
	 * 			
	 *			Contents of the menu and tool bar are customizable.
	 *
	 *			The menu bar also displays the minimize, maximize and close buttons for the window.
	 */
	class BS_ED_EXPORT GUIMenuBar
	{
		/**
		 * @brief	Contains data about the top level menu elements.
		 */
		struct GUIMenuBarData
		{
			WString name;
			GUIMenu* menu;
			GUIButton* button;
			GUIFixedSpace* space;
			INT32 priority;
		};

		/**
		 * @brief	Contains data about a single tool bar element.
		 */
		struct GUIToolBarData
		{
			String name;
			INT32 priority;
			GUIButton* button;
			GUITexture* separator;
			GUIFixedSpace* space;
		};

	public:
		/**
		 * @brief	Returns the style type for the menu bar background.
		 */
		static const String& getBackgroundStyleType();

		/**
		 * @brief	Returns the style type for the menu bar line draw under the menu items.
		 */
		static const String& getLineStyleType();

		/**
		 * @brief	Returns the style type for the menu bar logo.
		 */
		static const String& getLogoStyleType();

		/**
		 * @brief	Returns the style type for the menu bar menu item buttons.
		 */
		static const String& getMenuItemButtonStyleType();

		/**
		 * @brief	Returns the style type for tool bar buttons.
		 */
		static const String& getToolBarButtonStyleType();

		/**
		 * @brief	Returns the style type for the tool bar button separator.
		 */
		static const String& getToolBarSeparatorStyleType();

		/**
		 * @brief	Constructs a new menu bar.
		 *
		 * @param	parent			Parent GUI widget the menu bar will be docked in.
		 * @param	parentWindow	Window to trigger the min/max/close events on.
		 */
		GUIMenuBar(CGUIWidget* parent, RenderWindow* parentWindow);
		virtual ~GUIMenuBar();

		/**
		 * @brief	Sets the area of the menu bar, in pixels relative
		 *			to the parent GUI widget.
		 */
		void setArea(INT32 x, INT32 y, UINT32 width, UINT32 height);

		/**
		 * @brief	Adds a new menu item to the menu bar. 
		 *
		 * @param	path		Path to the menu item. Each element of the path must be separated using "/". 
		 *						First element of the path will create the top level menu, and any further element
		 *						will create a new sub-menu. Last element will be the interactable element.
		 * @param	callback	Callback to trigger when user click on the interactable element (last element in the provided path).
		 *						Can be null.
		 * @param	priority	Determines where is the element positioned compared to other elements in the same sub-menu.
		 *						Higher priority elements get placed higher up in the sub-menu. This only applies to the last
		 *						element. If you need to customize its parent element priority call this method with
		 *						with their specific paths.
		 * @param	shortcut	Keyboard shortcut key to display next to the interactable element, and register with the
		 *						global shortcut manager.
		 */
		GUIMenuItem* addMenuItem(const WString& path, std::function<void()> callback, INT32 priority = 0, const ShortcutKey& shortcut = ShortcutKey::NONE);

		/**
		 * @brief	Adds a menu item separator element at the specified path. The separator is added as a child of the path.
		 *
		 * @param	path		Parent path of the sub-menu to add the separator.
		 * @param	priority	Determines where is the separator positioned compared to other elements in the same sub-menu.
		 *						Higher priority elements get placed higher up in the sub-menu.
		 */
		GUIMenuItem* addMenuItemSeparator(const WString& path, INT32 priority = 0);

		/**
		 * @brief	Returns an existing menu item at the specified path, or null if one cannot be found.
		 */
		GUIMenuItem* getMenuItem(const WString& path);

		/**
		 * @brief	Removes a menu item from the specified path. If this path points to a sub-menu entire sub-menu will be removed.
		 */
		void removeMenuItem(const WString& path);

		/**
		 * @brief	Removes the specified menu item.
		 */
		void removeMenuItem(GUIMenuItem* item);

		/**
		 * @brief	Adds a new button to the tool bar.
		 *
		 * @param	name		Unique name of the button that can be used for identifiying it.
		 * @param	content 	Content to display on the button.
		 * @param	callback	Callback to trigger when the button is pressed.
		 * @param	priority	Determines where is the button positioned compared to other elements on the tool bar.
		 * 						Higher priority elements get placed before lower priority ones.
		 */
		void addToolBarButton(const String& name, const GUIContent& content, std::function<void()> callback, INT32 priority = 0);

		/**
		 * @brief	Toggles an existing toolbar button into an on or off state which changes the visuals of the button.
		 *
		 * @param	name	Name of the existing button to toggle.
		 * @param	on		True to toggle on, false to toggle off (default).
		 */
		void toggleToolbarButton(const String& name, bool on);

		/**
		 * @brief	Adds a new separator element to the tool bar.
		 *
		 * @param	name		Unique name of the separator that can be used for identifiying it.
		 * @param	priority	Determines where is the separator positioned compared to other elements on the tool bar.
		 * 						Higher priority elements get placed before lower priority ones.
		 */
		void addToolBarSeparator(const String& name, INT32 priority = 0);

		/**
		 * @brief	Removes an element from the tool bar.
		 *
		 * @param	name	Unique name of the element to remove.
		 */
		void removeToolBarButton(const String& name);
	private:
		/**
		 * @brief	Finds a top level sub-menu with the specified name.
		 */
		const GUIMenuBarData* getSubMenu(const WString& name) const;

		/**
		 * @brief	Adds a new top level sub-menu button.
		 */
		GUIMenuBarData* addNewButton(const WString& name, INT32 priority);

		/**
		 * @brief	Attempts to remove the first element from the specified path. First element
		 * 			returned in specified in "pathRoot", and original "path" parameter is modified so
		 * 			it no longer includes the first element.
		 *
		 * @return	False if first element doesn't exist, true otherwise.
		 */
		bool stripPath(WString& path, WString& pathRoot) const;

		/**
		 * @brief	Registers a shortcut with the global shortcut manager. Pressing the shortcut will trigger
		 *			the provided callback.
		 */
		void registerShortcut(const WString& path, const ShortcutKey& shortcut, std::function<void()> callback);

		/**
		 * @brief	Unregisters a shortcut assigned to the provided path from the global shortcut manager.
		 */
		void unregisterShortcut(const WString& path);

		/**
		 * @brief	Opens a top level sub-menu with the provided name.
		 */
		void openSubMenu(const WString& name);

		/**
		 * @brief	Closes any currently active sub-menu.
		 */
		void closeSubMenu();

		/**
		 * @brief	Triggered when a sub-menu is open and a user hovers over another
		 *			top level sub-menu button
		 *
		 * @param	name	Name of the sub-menu the user is hovering over.
		 */
		void onSubMenuHover(const WString& name);

		/**
		 * @brief	Triggered when a sub-menu is closed.
		 */
		void onSubMenuClosed();

		/**
		 * @brief	Triggered when the minimize button is clicked.
		 *			Minimizes the attached window.
		 */
		void onMinimizeClicked();

		/**
		 * @brief	Triggered when the maximize button is clicked.
		 *			Maximizes the attached window.
		 */
		void onMaximizeClicked();

		/**
		 * @brief	Triggered when the close button is clicked.
		 *			Closes the attached window.
		 */
		void onCloseClicked();

		/**
		 * @brief	Refreshes the OS client area that allow the window to be dragged
		 *			by dragging the empty areas on the menu bar. Should be called when top
		 *			level button configuration changes or menu bar area changes.
		 */
		void refreshNonClientAreas();

		static const UINT32 NUM_ELEMENTS_AFTER_CONTENT;
		static const UINT32 ELEMENT_SPACING;

		RenderWindow* mParentWindow;
		CGUIWidget* mParentWidget;
		GUIPanel* mMainPanel;
		GUIPanel* mBgPanel;
		GUILayout* mMenuItemLayout;
		GUILayout* mToolBarLayout;
		GUITexture* mBgTexture;
		GUITexture* mLogoTexture;
		GUITexture* mSplitterLine;

		GUIButton* mMinBtn;
		GUIButton* mMaxBtn;
		GUIButton* mCloseBtn;

		Vector<GUIMenuBarData> mChildMenus;
		UnorderedMap<WString, ShortcutKey> mEntryShortcuts;
		Vector<GUIToolBarData> mToolbarElements;

		GUIButton* mSubMenuButton;
		bool mSubMenuOpen;
	};
}