BansheeEngine/Source/EditorCore/GUI/BsGUITabbedTitleBar.h

//********************************** Banshee Engine (www.banshee3d.com) **************************************************//
//**************** Copyright (c) 2016 Marko Pintera ([email protected]). All rights reserved. **********************//
#pragma once

#include "BsEditorPrerequisites.h"
#include "GUI/BsGUIElementContainer.h"
#include "Math/BsRect2I.h"
#include "Utility/BsEvent.h"

namespace bs
{
	/** @addtogroup GUI-Editor-Internal
	 *  @{
	 */

	/**
	 * Tabbed title bar to be used in editor windows. Displays tabs that can be activated, reordered by dragging, or
	 * dragged off and on to/on other title bars.
	 */
	class GUITabbedTitleBar : public GUIElementContainer
	{
	public:
		/** Returns type name of the GUI element used for finding GUI element styles. */
		static const String& getGUITypeName();

		/**
		 * Creates a new GUI foldout element.
		 *
		 * @param[in]	backgroundStyle		GUI style to display the background in. Keep as blank for default.
		 * @param[in]	tabBtnStyle			GUI style to display the tab buttons in. Keep as blank for default.
		 * @param[in]	maxBtnStyle			GUI style to display the maximize button in. Keep as blank for default.
		 * @param[in]	closeBtnStyle		GUI style to display the close button in. Keep as blank for default.
		 */
		static GUITabbedTitleBar* create(const String& backgroundStyle = StringUtil::BLANK, const String& tabBtnStyle = StringUtil::BLANK, 
			const String& maxBtnStyle = StringUtil::BLANK, const String& closeBtnStyle = StringUtil::BLANK);

		/**
		 * Creates a new GUI foldout element.
		 *
		 *
		 * @param[in]	options				Options that allow you to control how is the element positioned and sized.
		 *									This will override any similar options set by style.
		 * @param[in]	backgroundStyle		GUI style to display the background in. Keep as blank for default.
		 * @param[in]	tabBtnStyle			GUI style to display the tab buttons in. Keep as blank for default.
		 * @param[in]	maxBtnStyle			GUI style to display the maximize button in. Keep as blank for default.
		 * @param[in]	closeBtnStyle		GUI style to display the close button in. Keep as blank for default.
		 */
		static GUITabbedTitleBar* create(const GUIOptions& options,
			const String& backgroundStyle = StringUtil::BLANK, const String& tabBtnStyle = StringUtil::BLANK, 
			const String& maxBtnStyle = StringUtil::BLANK, const String& closeBtnStyle = StringUtil::BLANK);

		/**
		 * Adds a new tab to the end of the tab list.
		 *
		 * @param[in]	name	Title to display on the tab button.
		 * @return				A unique index (not sequential) that you may use for later identifying the tab.
		 */
		UINT32 addTab(const HString& name);

		/**
		 * Inserts a new tab button at the specified position.
		 *
		 * @param[in]	position	Sequential index to insert the tab button in. This will be clamped to a valid range.
		 * @param[in]	name		Title to display on the tab button.
		 * @return					A unique index (not sequential) that you may use for later identifying the tab.
		 */
		UINT32 insertTab(UINT32 position, const HString& name);

		/**	Removes the tab button with the specified unique index. */
		void removeTab(UINT32 uniqueIdx);

		/**	Activates the tab button with the specified unique index. */
		void setActive(UINT32 uniqueIdx);

		/**	Finds the unique tab index from the provided sequential tab position. */
		UINT32 getTabIdx(UINT32 position) const;

		/**	Returns the total number of display tab buttons. */
		UINT32 getNumTabs() const { return (UINT32)mTabButtons.size(); }

		/**	Changes the displayed title for a tab with the specified index. */
		void updateTabName(UINT32 uniqueIdx, const HString& name);

		/**
		 * Calculates areas between the tab buttons and other GUI elements on the title bar. These areas are normally used
		 * for setting up valid areas the user can click on and drag the window the title bar belongs to.
		 */
		Vector<Rect2I> calcDraggableAreas(INT32 x, INT32 y, UINT32 width, UINT32 height) const;

		/** Triggered when the active tab changes. Provided parameter is the unique index of the activated tab. */
		Event<void(UINT32)> onTabActivated; 

		/**	Triggered when a tab is closed. Provided parameter is the unique index of the closed tab. */
		Event<void(UINT32)> onTabClosed;

		/**
		 * Triggered when a tab maximize button is clicked. Provided parameter is the unique index of the
		 * maximized/restored tab.
		 */
		Event<void(UINT32)> onTabMaximized;

		/**
		 * Triggered when a tab gets dragged off the title bar. Provided parameter is the unique index of the activated tab.
		 */
		Event<void(UINT32)> onTabDraggedOff;

		/**
		 * Triggered when a new tab gets dragged on the title bar. Provided parameter is the sequential index of the
		 * activated tab.
		 */
		Event<void(UINT32)> onTabDraggedOn;

	protected:
		GUITabbedTitleBar(const String& backgroundStyle, const String& tabBtnStyle, 
			const String& minBtnStyle, const String& closeBtnStyle, const GUIDimensions& dimensions);

		virtual ~GUITabbedTitleBar() = default;

		/** @copydoc GUIElementContainer::updateClippedBounds */
		void updateClippedBounds() override;

		/** @copydoc GUIElementContainer::_getOptimalSize */
		Vector2I _getOptimalSize() const override;

		/** @copydoc GUIElementContainer::_updateLayoutInternal */
		void _updateLayoutInternal(const GUILayoutData& data) override;

		/** @copydoc GUIElementContainer::_mouseEvent */
		virtual bool _mouseEvent(const GUIMouseEvent& ev) override;

		/**
		 * Starts the internal drag and drop operation.
		 *
		 * @param[in]	seqIdx			Sequential index of the dragged tab.
		 * @param[in]	startDragPos	Pointer position of where the drag originated, relative to parent widget.
		 */
		void startDrag(UINT32 seqIdx, const Vector2I& startDragPos);

		/**	Ends the internal drag and drop operation started with startDrag(). */
		void endDrag();

		/**
		 * Triggered when a tab button is toggled on or off.
		 *
		 * @param[in]	tabIdx		Unique index of the tab.
		 * @param[in]	toggledOn	Wether the tab was activated or deactivated.
		 */
		void tabToggled(UINT32 tabIdx, bool toggledOn);

		/**	Triggered when the close button is pressed. */
		void tabClosed();

		/**	Triggered when the maximize button is pressed. */
		void tabMaximize();

		/**
		 * Triggered every frame while a tab button is being dragged.
		 *
		 * @param[in]	tabIdx	Unique index of the dragged tab.
		 * @param[in]	dragPos	Position of the pointer, relative to parent widget.
		 */
		void tabDragged(UINT32 tabIdx, const Vector2I& dragPos);

		/**
		 * Triggered when a drag operation on a tab button ends.
		 *
		 * @param[in]	tabIdx	Unique index of the dragged tab.
		 * @param[in]	dragPos	Position of the pointer, relative to parent widget.
		 */
		void tabDragEnd(UINT32 tabIdx, const Vector2I& dragPos);

		/** Converts unique tab index to a sequential index corresponding to the tab's position in the title bar. */
		INT32 uniqueIdxToSeqIdx(UINT32 uniqueIdx) const;

		static const INT32 TAB_SPACING;
		static const INT32 FIRST_TAB_OFFSET;
		static const INT32 OPTION_BTN_SPACING;
		static const INT32 OPTION_BTN_RIGHT_OFFSET;

		Vector<GUITabButton*> mTabButtons;

		UINT32 mUniqueTabIdx;
		UINT32 mActiveTabIdx;
		GUITexture* mBackgroundImage;
		GUIButton* mMaxBtn;
		GUIButton* mCloseBtn;
		SPtr<GUIToggleGroup> mTabToggleGroup;

		EditorWidgetBase* mTempDraggedWidget;
		UINT32 mTempDraggedTabIdx;

		bool mDragInProgress;
		GUITabButton* mDraggedBtn;
		INT32 mDragBtnOffset;
		INT32 mInitialDragOffset;

		String mBackgroundStyle;
		String mCloseBtnStyle;
		String mMaximizeBtnStyle;
		String mTabBtnStyle;
	};

	/** @} */
}