TGUI  1.6.1
Loading...
Searching...
No Matches
Button.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#ifndef TGUI_BUTTON_HPP
26#define TGUI_BUTTON_HPP
27
28#include <TGUI/Widgets/ButtonBase.hpp>
29
31
32TGUI_MODULE_EXPORT namespace tgui
33{
37 class TGUI_API Button : public ButtonBase
38 {
39 public:
40
41 using Ptr = std::shared_ptr<Button>;
42 using ConstPtr = std::shared_ptr<const Button>;
43
44 static constexpr const char StaticWidgetType[] = "Button";
45
53 Button(const char* typeName = StaticWidgetType, bool initRenderer = true);
54
62 TGUI_NODISCARD static Button::Ptr create(const String& text = "");
63
71 TGUI_NODISCARD static Button::Ptr copy(const Button::ConstPtr& button);
72
76 bool leftMousePressed(Vector2f pos) override;
77
81 void leftMouseReleased(Vector2f pos) override;
82
86 void leftMouseButtonNoLongerDown() override;
87
91 void keyPressed(const Event::KeyEvent& event) override;
92
102 bool canHandleKeyPress(const Event::KeyEvent& event) override;
103
105 protected:
106
108 // This function is called when the mouse enters the widget. If requested, a callback will be send.
110 void mouseEnteredWidget() override;
111
113 // This function is called when the mouse leaves the widget. If requested, a callback will be send.
115 void mouseLeftWidget() override;
116
126 TGUI_NODISCARD Signal& getSignal(String signalName) override;
127
129 // Makes a copy of the widget
131 TGUI_NODISCARD Widget::Ptr clone() const override;
132
134 public:
135
136 SignalString onPress = {"Pressed"};
137 };
138
140}
141
143
144#endif // TGUI_BUTTON_HPP
145
Base class for button widgets.
Definition ButtonBase.hpp:40
Button widget.
Definition Button.hpp:38
void mouseLeftWidget() override
This function is called when the mouse leaves the widget.
bool leftMousePressed(Vector2f pos) override
Called by the parent when the left mouse button goes down on top of the widget.
static Button::Ptr create(const String &text="")
Creates a new button widget.
static Button::Ptr copy(const Button::ConstPtr &button)
Makes a copy of another button.
std::shared_ptr< const Button > ConstPtr
Shared constant widget pointer.
Definition Button.hpp:42
void mouseEnteredWidget() override
This function is called when the mouse enters the widget.
std::shared_ptr< Button > Ptr
Shared widget pointer.
Definition Button.hpp:41
bool canHandleKeyPress(const Event::KeyEvent &event) override
Called by the parent of the widget to check if keyPressed would process the event.
Signal & getSignal(String signalName) override
Retrieves a signal based on its name.
Widget::Ptr clone() const override
Makes a copy of the widget if you don't know its exact type.
Signal to which the user can subscribe to get callbacks from.
Definition Signal.hpp:61
Wrapper class to store strings.
Definition String.hpp:96
std::shared_ptr< Widget > Ptr
Shared widget pointer.
Definition Widget.hpp:86
Namespace that contains all TGUI functions and classes.
Definition AbsoluteOrRelativeValue.hpp:38
KeyPressed event parameters.
Definition Event.hpp:168