TGUI  1.3-dev
Loading...
Searching...
No Matches
ToggleButton.hpp
1
2//
3// TGUI - Texus' Graphical User Interface
4// Copyright (C) 2012-2024 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_TOGGLE_BUTTON_HPP
27#define TGUI_TOGGLE_BUTTON_HPP
28
29
30#include <TGUI/Widgets/ButtonBase.hpp>
31
33
34TGUI_MODULE_EXPORT namespace tgui
35{
39 class TGUI_API ToggleButton : public ButtonBase
40 {
41 public:
42
43 using Ptr = std::shared_ptr<ToggleButton>;
44 using ConstPtr = std::shared_ptr<const ToggleButton>;
45
46 static constexpr const char StaticWidgetType[] = "ToggleButton";
47
48
56 ToggleButton(const char* typeName = StaticWidgetType, bool initRenderer = true);
57
58
67 TGUI_NODISCARD static ToggleButton::Ptr create(const String& text = "", bool down = false);
68
69
77 TGUI_NODISCARD static ToggleButton::Ptr copy(const ToggleButton::ConstPtr& button);
78
79
85 void setDown(bool down);
86
87
93 TGUI_NODISCARD bool isDown() const;
94
95
99 void leftMouseReleased(Vector2f pos) override;
100
104 void keyPressed(const Event::KeyEvent& event) override;
105
115 bool canHandleKeyPress(const Event::KeyEvent& event) override;
116
117
119 protected:
120
130 TGUI_NODISCARD Signal& getSignal(String signalName) override;
131
132
136 TGUI_NODISCARD std::unique_ptr<DataIO::Node> save(SavingRenderersMap& renderers) const override;
137
138
142 void load(const std::unique_ptr<DataIO::Node>& node, const LoadingRenderersMap& renderers) override;
143
144
146 // Makes a copy of the widget
148 TGUI_NODISCARD Widget::Ptr clone() const override;
149
150
152 public:
153
154 SignalBool onToggle = {"Toggled"};
155 };
156
158}
159
161
162#endif // TGUI_TOGGLE_BUTTON_HPP
163
Base class for button widgets.
Definition ButtonBase.hpp:42
Signal to which the user can subscribe to get callbacks from.
Definition Signal.hpp:62
Wrapper class to store strings.
Definition String.hpp:101
ToggleButton widget.
Definition ToggleButton.hpp:40
bool canHandleKeyPress(const Event::KeyEvent &event) override
Called by the parent of the widget to check if keyPressed would process the event.
TGUI_NODISCARD Widget::Ptr clone() const override
Makes a copy of the widget if you don't know its exact type.
void setDown(bool down)
Sets whether the button is in down or up state.
static TGUI_NODISCARD ToggleButton::Ptr create(const String &text="", bool down=false)
Creates a new toggle button widget.
std::shared_ptr< const ToggleButton > ConstPtr
Shared constant widget pointer.
Definition ToggleButton.hpp:44
std::shared_ptr< ToggleButton > Ptr
Shared widget pointer.
Definition ToggleButton.hpp:43
TGUI_NODISCARD bool isDown() const
Returns whether the button is in down or up state.
void load(const std::unique_ptr< DataIO::Node > &node, const LoadingRenderersMap &renderers) override
Loads the widget from a tree of nodes.
static TGUI_NODISCARD ToggleButton::Ptr copy(const ToggleButton::ConstPtr &button)
Makes a copy of another toggle button.
TGUI_NODISCARD std::unique_ptr< DataIO::Node > save(SavingRenderersMap &renderers) const override
Saves the widget as a tree node in order to save it to a file.
TGUI_NODISCARD Signal & getSignal(String signalName) override
Retrieves a signal based on its name.
std::shared_ptr< Widget > Ptr
Shared widget pointer.
Definition Widget.hpp:87
Namespace that contains all TGUI functions and classes.
Definition AbsoluteOrRelativeValue.hpp:39
KeyPressed event parameters.
Definition Event.hpp:169