Grid.hpp

 
//
// TGUI - Texus' Graphical User Interface
// Copyright (C) 2012-2022 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_GRID_HPP
#define TGUI_GRID_HPP
 
 
#include <TGUI/Container.hpp>
#include <unordered_map>
 
 
namespace tgui
{
 
    class TGUI_API Grid : public Container
    {
    public:
 
        typedef std::shared_ptr<Grid> Ptr; 
        typedef std::shared_ptr<const Grid> ConstPtr; 
 
 
        enum class Alignment
        {
            Center,      
            UpperLeft,   
            Up,          
            UpperRight,  
            Right,       
            BottomRight, 
            Bottom,      
            BottomLeft,  
            Left         
        };
 
 
        Grid(const char* typeName = "Grid", bool initRenderer = true);
 
 
        static Grid::Ptr create();
 
 
        Grid(const Grid& copy);
 
 
        Grid(Grid&& copy);
 
 
        Grid& operator= (const Grid& right);
 
 
        Grid& operator= (Grid&& right);
 
 
        static Grid::Ptr copy(Grid::ConstPtr grid);
 
 
        void setSize(const Layout2d& size) override;
        using Widget::setSize;
 
 
        void setAutoSize(bool autoSize);
 
 
        bool getAutoSize() const;
 
 
        bool remove(const Widget::Ptr& widget) override;
 
 
        void removeAllWidgets() override;
 
 
        void addWidget(const Widget::Ptr& widget,
                       std::size_t        row,
                       std::size_t        column,
                       Alignment          alignment = Alignment::Center,
                       const Padding&     padding   = Padding{0});
 
 
        Widget::Ptr getWidget(std::size_t row, std::size_t column) const;
 
 
        std::map<Widget::Ptr, std::pair<std::size_t, std::size_t>> getWidgetLocations() const;
 
 
        void setWidgetPadding(const Widget::Ptr& widget, const Padding& padding = Padding(0, 0, 0, 0));
 
 
        void setWidgetPadding(std::size_t row, std::size_t column, const Padding& padding = Padding(0, 0, 0, 0));
 
 
        Padding getWidgetPadding(const Widget::Ptr& widget) const;
 
 
        Padding getWidgetPadding(std::size_t row, std::size_t column) const;
 
 
        void setWidgetAlignment(const Widget::Ptr& widget, Alignment alignment = Alignment::Center);
 
 
        void setWidgetAlignment(std::size_t row, std::size_t column, Alignment alignment = Alignment::Center);
 
 
        Alignment getWidgetAlignment(const Widget::Ptr& widget) const;
 
 
        Alignment getWidgetAlignment(std::size_t row, std::size_t column) const;
 
 
        const std::vector<std::vector<Widget::Ptr>>& getGridWidgets() const;
 
 
        bool isMouseOnWidget(Vector2f pos) const override;
 
 
    protected:
 
        std::unique_ptr<DataIO::Node> save(SavingRenderersMap& renderers) const override;
 
 
        void load(const std::unique_ptr<DataIO::Node>& node, const LoadingRenderersMap& renderers) override;
 
 
        // Returns the minimum size required by the grid to display correctly all widgets.
        Vector2f getMinimumSize() const;
 
 
        // Reposition all the widgets.
        void updatePositionsOfAllWidgets();
 
 
        // Updates the position and size of the widget
        void updateWidgets();
 
 
        // Makes a copy of the widget
        Widget::Ptr clone() const override;
 
 
    protected:
 
        bool m_autoSize = true;
 
        std::vector<std::vector<Widget::Ptr>> m_gridWidgets;
        std::vector<std::vector<Padding>>     m_objPadding;
        std::vector<std::vector<Alignment>>   m_objAlignment;
 
        std::vector<float> m_rowHeight;
        std::vector<float> m_columnWidth;
 
        std::unordered_map<Widget::Ptr, unsigned int> m_connectedSizeCallbacks;
 
    };
 
}
 
 
#endif // TGUI_GRID_HPP