Layout.hpp

 
//
// TGUI - Texus' Graphical User Interface
// Copyright (C) 2012-2020 Bruno Van de Velde (vdv_b@tgui.eu)
//
// This software is provided 'as-is', without any express or implied warranty.
// In no event will the authors be held liable for any damages arising from the use of this software.
//
// Permission is granted to anyone to use this software for any purpose,
// including commercial applications, and to alter it and redistribute it freely,
// subject to the following restrictions:
//
// 1. The origin of this software must not be misrepresented;
// you must not claim that you wrote the original software.
// If you use this software in a product, an acknowledgment
// in the product documentation would be appreciated but is not required.
//
// 2. Altered source versions must be plainly marked as such,
// and must not be misrepresented as being the original software.
//
// 3. This notice may not be removed or altered from any source distribution.
//
 
 
#ifndef TGUI_LAYOUT_HPP
#define TGUI_LAYOUT_HPP
 
#include <TGUI/Config.hpp>
#include <TGUI/Vector2f.hpp>
#include <type_traits>
#include <functional>
#include <memory>
#include <string>
 
 
namespace tgui
{
 class Gui;
 class Widget;
 class Container;
 
 class TGUI_API Layout
 {
 public:
 
 enum class Operation
 {
 Value,
 Plus,
 Minus,
 Multiplies,
 Divides,
 Minimum,
 Maximum,
 BindingLeft,
 BindingTop,
 BindingWidth,
 BindingHeight,
 BindingInnerWidth,
 BindingInnerHeight,
 BindingString
 };
 
 
 public:
 
 Layout() = default;
 
 
 template <typename T, typename = typename std::enable_if<std::is_arithmetic<T>::value, T>::type>
 Layout(T constant) :
 m_value{static_cast<float>(constant)}
 {
 }
 
 
 Layout(const char* expression) :
 Layout{std::string{expression}}
 {
 }
 
 
 Layout(std::string expression);
 
 
 explicit Layout(Operation operation, Widget* boundWidget);
 
 
 explicit Layout(Operation operation, std::unique_ptr<Layout> leftOperand, std::unique_ptr<Layout> rightOperand);
 
 
 Layout(const Layout& other);
 
 Layout(Layout&& other);
 
 Layout& operator=(const Layout& other);
 
 Layout& operator=(Layout&& other);
 
 ~Layout();
 
 
 float getValue() const
 {
 return m_value;
 }
 
 
 bool isConstant() const
 {
 return m_operation == Operation::Value;
 }
 
 
 std::string toString() const;
 
 
 void connectWidget(Widget* widget, bool xAxis, std::function<void()> valueChangedCallbackHandler);
 
 
 void unbindWidget();
 
 
 void recalculateValue();
 
 
 private:
 
 
 // If a widget is bound, inform it that the layout no longer binds it
 void unbindLayout();
 
 
 // Resets the parent pointers of the left and right operands if they exist and tell the bound widget that this layout
 // requires information about changes to its position or size when the operation requires a widget to be bound.
 void resetPointers();
 
 
 // Check whether sublayouts contain a string that refers to a widget which should be bound.
 void parseBindingStringRecursive(Widget* widget, bool xAxis);
 
 
 // Find the widget corresponding to the given name and bind it if found
 void parseBindingString(const std::string& expression, Widget* widget, bool xAxis);
 
 
 private:
 
 float m_value = 0;
 Layout* m_parent = nullptr;
 Operation m_operation = Operation::Value;
 std::unique_ptr<Layout> m_leftOperand = nullptr; // The left operand of the operation in case the operation is a math operation
 std::unique_ptr<Layout> m_rightOperand = nullptr; // The left operand of the operation in case the operation is a math operation
 Widget* m_boundWidget = nullptr; // The widget on which this layout depends in case the operation is a binding
 std::string m_boundString; // String referring to a widget on which this layout depends in case the layout was created from a string and contains a binding operation
 std::function<void()> m_connectedWidgetCallback = nullptr; // Function to call when the value of the layout changes in case the layout and sublayouts are not all constants
 
 };
 
 
 class TGUI_API Layout2d
 {
 public:
 
 Layout2d(Vector2f constant = {0, 0}) :
 x{constant.x},
 y{constant.y}
 {
 }
 
 
 Layout2d(sf::Vector2f constant) :
 x{constant.x},
 y{constant.y}
 {
 }
 
 
 Layout2d(Layout layoutX, Layout layoutY) :
 x{std::move(layoutX)},
 y{std::move(layoutY)}
 {
 }
 
 
 Layout2d(const char* expression) :
 x{expression},
 y{expression}
 {
 }
 
 
 Layout2d(const std::string& expression) :
 x{expression},
 y{expression}
 {
 }
 
 
 Vector2f getValue() const
 {
 return {x.getValue(), y.getValue()};
 }
 
 
 std::string toString() const
 {
 return "(" + x.toString() + ", " + y.toString() + ")";
 }
 
 public:
 
 Layout x;
 Layout y;
 };
 
 
 TGUI_API Layout operator-(Layout right);
 
 TGUI_API Layout operator+(Layout left, Layout right);
 
 TGUI_API Layout operator-(Layout left, Layout right);
 
 TGUI_API Layout operator*(Layout left, Layout right);
 
 TGUI_API Layout operator/(Layout left, Layout right);
 
 TGUI_API Layout2d operator-(Layout2d right);
 
 TGUI_API Layout2d operator+(Layout2d left, Layout2d right);
 
 TGUI_API Layout2d operator-(Layout2d left, Layout2d right);
 
 TGUI_API Layout2d operator*(Layout2d left, const Layout& right);
 
 TGUI_API Layout2d operator*(const Layout& left, Layout2d right);
 
 TGUI_API Layout2d operator/(Layout2d left, const Layout& right);
 
 
 
 inline namespace bind_functions
 {
 TGUI_API Layout bindLeft(std::shared_ptr<Widget> widget);
 
 TGUI_API Layout bindTop(std::shared_ptr<Widget> widget);
 
 TGUI_API Layout bindWidth(std::shared_ptr<Widget> widget);
 
 TGUI_API Layout bindHeight(std::shared_ptr<Widget> widget);
 
 TGUI_API Layout bindInnerWidth(std::shared_ptr<Container> container);
 
 TGUI_API Layout bindInnerHeight(std::shared_ptr<Container> container);
 
 TGUI_API Layout bindRight(std::shared_ptr<Widget> widget);
 
 TGUI_API Layout bindBottom(std::shared_ptr<Widget> widget);
 
 TGUI_API Layout2d bindPosition(std::shared_ptr<Widget> widget);
 
 TGUI_API Layout2d bindSize(std::shared_ptr<Widget> widget);
 
 TGUI_API Layout2d bindInnerSize(std::shared_ptr<Container> container);
 
 TGUI_API Layout bindWidth(Gui& gui);
 
 TGUI_API Layout bindHeight(Gui& gui);
 
 TGUI_API Layout2d bindSize(Gui& gui);
 
 TGUI_API Layout bindMin(const Layout& value1, const Layout& value2);
 
 TGUI_API Layout bindMax(const Layout& value1, const Layout& value2);
 }
 
}
 
 
#endif // TGUI_LAYOUT_HPP