TGUI  1.0-beta
Loading...
Searching...
No Matches
SignalManager.hpp
1
2//
3// TGUI - Texus' Graphical User Interface
4// Copyright (C) 2012-2022 Bruno Van de Velde (vdv_b@tgui.eu)
5//
6// This software is provided 'as-is', without any express or implied warranty.
7// In no event will the authors be held liable for any damages arising from the use of this software.
8//
9// Permission is granted to anyone to use this software for any purpose,
10// including commercial applications, and to alter it and redistribute it freely,
11// subject to the following restrictions:
12//
13// 1. The origin of this software must not be misrepresented;
14// you must not claim that you wrote the original software.
15// If you use this software in a product, an acknowledgment
16// in the product documentation would be appreciated but is not required.
17//
18// 2. Altered source versions must be plainly marked as such,
19// and must not be misrepresented as being the original software.
20//
21// 3. This notice may not be removed or altered from any source distribution.
22//
24
25
26#ifndef TGUI_SIGNAL_MANAGER_HPP
27#define TGUI_SIGNAL_MANAGER_HPP
28
29
30#include <TGUI/Widget.hpp>
31#include <unordered_map>
32#include <memory>
33
35
36namespace tgui
37{
39
40 class TGUI_API SignalManager
41 {
42 public:
43
44 using Ptr = std::shared_ptr<SignalManager>;
45 using ConstPtr = std::shared_ptr<const SignalManager>;
46
47 using Delegate = std::function<void()>;
48 using DelegateEx = std::function<void(std::shared_ptr<Widget>, const String&)>;
49
50 using Weak = std::weak_ptr<Widget>;
51 using SignalID = unsigned int;
52
54 {
55 String widgetName;
56 String signalName;
57 std::pair<Delegate, DelegateEx> func;
58 };
59
61 {
62 SignalID signalId;
63 Weak widget;
64 unsigned int signalWidgetID;
65
66 ConnectedSignalTuple(SignalID sigId, Weak widgetPtr, unsigned int widgetId) :
67 signalId(sigId),
68 widget(std::move(widgetPtr)),
69 signalWidgetID(widgetId)
70 {
71 }
72 };
73
77 SignalManager() = default;
78
82 virtual ~SignalManager() = default;
83
89 static void setDefaultSignalManager(const SignalManager::Ptr& manager);
90
97
98#if defined(__cpp_if_constexpr) && (__cpp_if_constexpr >= 201606L)
109 template <typename Func, typename... BoundArgs>
110 unsigned int connect(String widgetName, String signalName, Func&& handler, const BoundArgs&... args);
111
112#else
123 template <typename Func, typename... Args, typename std::enable_if<std::is_convertible<Func, std::function<void(const Args&...)>>::value>::type* = nullptr>
124 unsigned int connect(String widgetName, String signalName, Func&& handler, const Args&... args);
125
126
138 template <typename Func, typename... BoundArgs, typename std::enable_if<!std::is_convertible<Func, std::function<void(const BoundArgs&...)>>::value // Ambigious otherwise when passing bind expression
139 && std::is_convertible<Func, std::function<void(const BoundArgs&..., std::shared_ptr<Widget>, const String&)>>::value>::type* = nullptr>
140 unsigned int connect(String widgetName, String signalName, Func&& handler, BoundArgs&&... args);
141#endif
142
150 virtual bool disconnect(unsigned int id);
151
152
156 virtual void disconnectAll();
157
158
162 virtual void add(const Widget::Ptr& widgetPtr);
163
164
168 virtual void remove(Widget* widget);
169
171 private:
175 unsigned int generateUniqueId();
176
177 unsigned int m_lastId = 0;
178
179
181 protected:
182
186 std::pair<Delegate, DelegateEx> makeSignal(const Delegate&);
187
188
192 std::pair<Delegate, DelegateEx> makeSignalEx(const DelegateEx&);
193
194
202 virtual void connect(SignalID id);
203
204
206
207 static SignalManager::Ptr m_manager;
208
209 std::vector<Weak> m_widgets;
210 std::unordered_map<SignalID, SignalTuple> m_signals;
211 std::vector<ConnectedSignalTuple> m_connectedSignals;
212 };
213
215
216#if defined(__cpp_if_constexpr) && (__cpp_if_constexpr >= 201606L)
217 template <typename Func, typename... BoundArgs>
218 unsigned int SignalManager::connect(String widgetName, String signalName, Func&& handler, const BoundArgs&... args)
219 {
220 const unsigned int id = generateUniqueId();
221
222 if constexpr (std::is_convertible_v<Func, std::function<void(const BoundArgs&...)>>
223 && std::is_invocable_v<decltype(&handler), BoundArgs...>
224 && !std::is_function_v<Func>)
225 {
226 // Reference to function
227 m_signals[id] = {widgetName, signalName, makeSignal([=, f=std::function<void(const BoundArgs&...)>(handler)]{ std::invoke(f, args...); })};
228 }
229 else if constexpr (std::is_convertible_v<Func, std::function<void(const BoundArgs&...)>>)
230 {
231 // Function pointer
232 m_signals[id] = {widgetName, signalName, makeSignal([=]{ std::invoke(handler, args...); })};
233 }
234 else if constexpr (std::is_convertible_v<Func, std::function<void(const BoundArgs&..., const std::shared_ptr<Widget>&, const String&)>>
235 && std::is_invocable_v<decltype(&handler), BoundArgs..., const std::shared_ptr<Widget>&, const String&>
236 && !std::is_function_v<Func>)
237 {
238 // Reference to function with caller arguments
239 m_signals[id] = {widgetName, signalName, makeSignalEx([=, f=std::function<void(const BoundArgs&..., const std::shared_ptr<Widget>& w, const String& s)>(handler)](const std::shared_ptr<Widget>& w, const String& s){ std::invoke(f, args..., w, s); })};
240 }
241 else
242 {
243 // Function pointer with caller arguments
244 m_signals[id] = {widgetName, signalName, makeSignalEx([=](const std::shared_ptr<Widget>& w, const String& s){ std::invoke(handler, args..., w, s); })};
245 }
246
247 connect(id);
248 return id;
249 }
250#else
251 template <typename Func, typename... Args, typename std::enable_if<std::is_convertible<Func, std::function<void(const Args&...)>>::value>::type*>
252 unsigned int SignalManager::connect(String widgetName, String signalName, Func&& handler, const Args&... args)
253 {
254 const unsigned int id = generateUniqueId();
255 m_signals[id] = {widgetName, signalName, makeSignal([f=std::function<void(const Args&...)>(handler),args...](){ f(args...); })};
256
257 connect(id);
258 return id;
259 }
260
261 template <typename Func, typename... BoundArgs, typename std::enable_if<!std::is_convertible<Func, std::function<void(const BoundArgs&...)>>::value // Ambigious otherwise when passing bind expression
262 && std::is_convertible<Func, std::function<void(const BoundArgs&..., std::shared_ptr<Widget>, const String&)>>::value>::type*>
263 unsigned int SignalManager::connect(String widgetName, String signalName, Func&& handler, BoundArgs&&... args)
264 {
265 const unsigned int id = generateUniqueId();
266 m_signals[id] = {widgetName, signalName, makeSignalEx(
267 [f=std::function<void(const BoundArgs&..., const std::shared_ptr<Widget>&, const String&)>(handler), args...]
268 (const std::shared_ptr<Widget>& w, const String& s)
269 { f(args..., w, s); }
270 )};
271
272 connect(id);
273 return id;
274 }
275#endif
276
278}
279
281
282#endif // TGUI_SIGNAL_MANAGER_HPP
Definition: SignalManager.hpp:41
virtual void connect(SignalID id)
Function that is called each time new signal is created with it id.
virtual bool disconnect(unsigned int id)
Disconnect a signal handler.
std::shared_ptr< const SignalManager > ConstPtr
Shared constant widget pointer.
Definition: SignalManager.hpp:45
virtual void disconnectAll()
Disconnect all signal handler.
unsigned int connect(String widgetName, String signalName, Func &&handler, const Args &... args)
Connects a signal handler that will be called when this signal is emitted.
Definition: SignalManager.hpp:252
SignalManager()=default
Default constructor.
virtual ~SignalManager()=default
Destructor.
static SignalManager::Ptr getSignalManager()
Retrieves Signal Manager that will be used to operate a signal.
static void setDefaultSignalManager(const SignalManager::Ptr &manager)
Sets Signal Manager that will be used to operate a signal.
std::shared_ptr< SignalManager > Ptr
Shared widget pointer.
Definition: SignalManager.hpp:44
Wrapper class to store strings.
Definition: String.hpp:79
The parent class for every widget.
Definition: Widget.hpp:70
std::shared_ptr< Widget > Ptr
Shared widget pointer.
Definition: Widget.hpp:73
Namespace that contains all TGUI functions and classes.
Definition: AbsoluteOrRelativeValue.hpp:36
Definition: SignalManager.hpp:61
Definition: SignalManager.hpp:54