Signal.hpp

//
// TGUI - Texus' Graphical User Interface
// Copyright (C) 2012-2026 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_SIGNAL_HPP
#define TGUI_SIGNAL_HPP

 
#include <TGUI/Global.hpp>
 
#include <TGUI/Animation.hpp>
#include <TGUI/Color.hpp>
#include <TGUI/Filesystem.hpp>
#include <TGUI/String.hpp>
#include <TGUI/Vector2.hpp>
 
#include <deque>
#include <functional>
#include <memory>
#include <type_traits>
#include <unordered_map>
#include <vector>
 
#undef MessageBox // windows.h defines MessageBox when NOMB isn't defined before including windows.h

 
namespace tgui
{
    class Widget;
    class ChildWindow;
    class Panel;

    class TGUI_API Signal
    {
    public:
        virtual ~Signal() = default;

        Signal(String&& name, std::size_t extraParameters = 0) :
            m_name{std::move(name)}
        {
            if (1 + extraParameters > m_parameters.size())
                m_parameters.resize(1 + extraParameters);
        }

        Signal(const Signal& other);

        Signal(Signal&& other) noexcept = default;

        Signal& operator=(const Signal& other);

        Signal& operator=(Signal&& other) noexcept = default;

        template <typename Func, typename... BoundArgs>
        unsigned int operator()(const Func& func, const BoundArgs&... args)
        {
            return connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&...)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            const auto id = ++m_lastSignalId;
            if constexpr (sizeof...(BoundArgs) == 0)
                m_handlers[id] = func;
            else
            {
                m_handlers[id] = [=] { std::invoke(func, args...); };
            }
 
            return id;
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<
                      std::is_convertible_v<Func, std::function<void(const BoundArgs&..., const std::shared_ptr<Widget>&, const String&)>>>* = nullptr>
        unsigned int connectEx(const Func& func, const BoundArgs&... args)
        {
            // The name is copied so that the lambda does not depend on the 'this' pointer
            return connect([func, name = m_name, args...]() { std::invoke(func, args..., getWidget(), name); });
        }

        bool disconnect(unsigned int id);

        void disconnectAll();

        bool emit(const Widget* widget);

        [[nodiscard]] String getName() const
        {
            return m_name;
        }

        void setEnabled(bool enabled)
        {
            m_enabled = enabled;
        }

        [[nodiscard]] bool isEnabled() const
        {
            return m_enabled;
        }

 
    protected:
        static std::shared_ptr<Widget> getWidget();

        template <typename Type>
        [[nodiscard]] static const std::decay_t<Type>& dereferenceParam(std::size_t paramIndex)
        {
            return *static_cast<const std::decay_t<Type>*>(m_parameters[paramIndex]);
        }

 
    protected:
        bool m_enabled = true;
        String m_name;
        std::unordered_map<unsigned int, std::function<void()>> m_handlers;
 
        static unsigned int m_lastSignalId;
        static std::deque<const void*> m_parameters;
    };

    template <typename T>
    class SignalTyped : public Signal
    {
    public:
        SignalTyped(String&& name) :
            Signal{std::move(name), 1}
        {
        }

        template <typename Func, typename... BoundArgs>
        unsigned int operator()(const Func& func, const BoundArgs&... args)
        {
            return connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&...)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&..., T)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<T>(1)); });
        }

        bool emit(const Widget* widget, T param)
        {
            if (m_handlers.empty())
                return false;
 
            m_parameters[1] = static_cast<const void*>(&param);
            return Signal::emit(widget);
        }
    };

    template <typename T1, typename T2>
    class SignalTyped2 : public Signal
    {
    public:
        SignalTyped2(String&& name) :
            Signal{std::move(name), 2}
        {
        }

        template <typename Func, typename... BoundArgs>
        unsigned int operator()(const Func& func, const BoundArgs&... args)
        {
            return connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&...)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&..., T1, T2)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<T1>(1), dereferenceParam<T2>(2)); });
        }

        bool emit(const Widget* widget, T1 param1, T2 param2)
        {
            if (m_handlers.empty())
                return false;
 
            m_parameters[1] = static_cast<const void*>(&param1);
            m_parameters[2] = static_cast<const void*>(&param2);
            return Signal::emit(widget);
        }
    };
 
    using SignalInt = SignalTyped<int>;              
    using SignalUInt = SignalTyped<unsigned int>;    
    using SignalBool = SignalTyped<bool>;            
    using SignalFloat = SignalTyped<float>;          
    using SignalColor = SignalTyped<Color>;          
    using SignalString = SignalTyped<const String&>; 
    using SignalVector2f = SignalTyped<Vector2f>;    
    using SignalFloatRect = SignalTyped<FloatRect>;  
    using SignalRange = SignalTyped2<float, float>;  

    class TGUI_API SignalChildWindow : public Signal
    {
    public:
        SignalChildWindow(String&& name) :
            Signal{std::move(name), 1}
        {
        }

        template <typename Func, typename... BoundArgs>
        unsigned int operator()(const Func& func, const BoundArgs&... args)
        {
            return connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&...)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<
                      std::is_convertible_v<Func, std::function<void(const BoundArgs&..., const std::shared_ptr<ChildWindow>&)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceChildWindow()); });
        }

        bool emit(ChildWindow* childWindow);

 
    private:
        static std::shared_ptr<ChildWindow> dereferenceChildWindow();

    };

    class TGUI_API SignalItem : public Signal
    {
    public:
        SignalItem(String&& name) :
            Signal{std::move(name), 3}
        {
        }

        template <typename Func, typename... BoundArgs>
        unsigned int operator()(const Func& func, const BoundArgs&... args)
        {
            return connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&...)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&..., int)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<int>(1)); });
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&..., const String&)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<String>(2)); });
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<
                      std::is_convertible_v<Func, std::function<void(const BoundArgs&..., const String&, const String&)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<String>(2), dereferenceParam<String>(3)); });
        }

        bool emit(const Widget* widget, int index, const String& item, const String& id);

    };

    class TGUI_API SignalPanelListBoxItem : public Signal
    {
    public:
        SignalPanelListBoxItem(String&& name) :
            Signal{std::move(name), 3}
        {
        }

        template <typename Func, typename... BoundArgs>
        unsigned int operator()(const Func& func, const BoundArgs&... args)
        {
            return connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&...)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&..., int)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<int>(1)); });
        }

        template <typename Func,
                  typename... BoundArgs,
                  std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&..., const std::shared_ptr<Panel>&)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferencePanel()); });
        }

        template <typename Func,
                  typename... BoundArgs,
                  std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&..., const String&)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<String>(3)); });
        }

        template <typename Func,
                  typename... BoundArgs,
                  std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&..., int, const std::shared_ptr<Panel>&)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<int>(1), dereferencePanel()); });
        }

        template <typename Func,
                  typename... BoundArgs,
                  std::enable_if_t<
                      std::is_convertible_v<Func, std::function<void(const BoundArgs&..., const std::shared_ptr<Panel>&, const String&)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferencePanel(), dereferenceParam<String>(3)); });
        }

        template <typename Func,
                  typename... BoundArgs,
                  std::enable_if_t<
                      std::is_convertible_v<Func, std::function<void(const BoundArgs&..., int, const std::shared_ptr<Panel>&, const String&)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect(
                [=] { std::invoke(func, args..., dereferenceParam<int>(1), dereferencePanel(), dereferenceParam<String>(3)); });
        }

        bool emit(const Widget* widget, int index, const std::shared_ptr<Panel>& panel, const String& id);

 
    private:
        static std::shared_ptr<Panel> dereferencePanel();

    };

    class TGUI_API SignalFileDialogPaths : public Signal
    {
    public:
        SignalFileDialogPaths(String&& name) :
            Signal{std::move(name), 3}
        {
        }

        template <typename Func, typename... BoundArgs>
        unsigned int operator()(const Func& func, const BoundArgs&... args)
        {
            return connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&...)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&..., const String&)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<String>(1)); });
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&..., const Filesystem::Path&)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<Filesystem::Path>(2)); });
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<
                      std::is_convertible_v<Func, std::function<void(const BoundArgs&..., const std::vector<Filesystem::Path>&)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<std::vector<Filesystem::Path>>(3)); });
        }

        bool emit(const Widget* widget, const std::vector<Filesystem::Path>& paths);
    };

    class TGUI_API SignalShowEffect : public Signal
    {
    public:
        SignalShowEffect(String&& name) :
            Signal{std::move(name), 2}
        {
        }

        template <typename Func, typename... BoundArgs>
        unsigned int operator()(const Func& func, const BoundArgs&... args)
        {
            return connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&...)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&..., ShowEffectType)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<ShowEffectType>(1)); });
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&..., bool)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<bool>(2)); });
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&..., ShowEffectType, bool)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect(
                [=] { std::invoke(func, args..., dereferenceParam<ShowEffectType>(1), dereferenceParam<bool>(2)); });
        }

        bool emit(const Widget* widget, ShowEffectType type, bool visible);

    };

    class TGUI_API SignalAnimationType : public Signal
    {
    public:
        SignalAnimationType(String&& name) :
            Signal{std::move(name), 1}
        {
        }

        template <typename Func, typename... BoundArgs>
        unsigned int operator()(const Func& func, const BoundArgs&... args)
        {
            return connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&...)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&..., AnimationType)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<AnimationType>(1)); });
        }

        bool emit(const Widget* widget, AnimationType type);

    };

    class TGUI_API SignalItemHierarchy : public Signal
    {
    public:
        SignalItemHierarchy(String&& name) :
            Signal{std::move(name), 2}
        {
        }

        template <typename Func, typename... BoundArgs>
        unsigned int operator()(const Func& func, const BoundArgs&... args)
        {
            return connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&...)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect(func, args...);
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<std::is_convertible_v<Func, std::function<void(const BoundArgs&..., const String&)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<String>(1)); });
        }

        template <typename Func,
                  typename... BoundArgs,
                  typename std::enable_if_t<
                      std::is_convertible_v<Func, std::function<void(const BoundArgs&..., const std::vector<String>&)>>>* = nullptr>
        unsigned int connect(const Func& func, const BoundArgs&... args)
        {
            return Signal::connect([=] { std::invoke(func, args..., dereferenceParam<std::vector<String>>(2)); });
        }

        bool emit(const Widget* widget, const String& item, const std::vector<String>& fullItem);
    };
} // namespace tgui
 
#endif // TGUI_SIGNAL_HPP