26#ifndef TGUI_LIST_BOX_HPP
27#define TGUI_LIST_BOX_HPP
30#include <TGUI/CopiedSharedPtr.hpp>
31#include <TGUI/Widgets/Scrollbar.hpp>
32#include <TGUI/Renderers/ListBoxRenderer.hpp>
33#include <TGUI/Text.hpp>
37TGUI_MODULE_EXPORT
namespace tgui
46 using Ptr = std::shared_ptr<ListBox>;
47 using ConstPtr = std::shared_ptr<const ListBox>;
49 static constexpr const char StaticWidgetType[] =
"ListBox";
70 ListBox(
const char* typeName = StaticWidgetType,
bool initRenderer =
true);
98 TGUI_NODISCARD
const ListBoxRenderer* getSharedRenderer()
const override;
115 using Widget::setSize;
376 TGUI_NODISCARD std::vector<String>
getItems()
const;
411 template <
typename DataType>
414 if (index < m_items.size())
415 return AnyCast<DataType>(m_items[index].data);
417 throw std::bad_cast();
550 void leftMouseReleased(
Vector2f pos)
override;
555 void mouseMoved(
Vector2f pos)
override;
565 void mouseNoLongerOnWidget()
override;
570 void leftMouseButtonNoLongerDown()
override;
626 TGUI_NODISCARD std::unique_ptr<DataIO::Node>
save(SavingRenderersMap& renderers)
const override;
632 void load(
const std::unique_ptr<DataIO::Node>& node,
const LoadingRenderersMap& renderers)
override;
644 TGUI_NODISCARD
Vector2f getInnerSize()
const;
650 void updateItemPositions();
656 void updateSelectedAndHoveringItemColorsAndStyle();
662 void updateItemColorsAndStyle();
668 void updateHoveringItem(
int item);
674 void updateSelectedItem(
int item);
680 void triggerOnScroll();
686 bool updateTime(
Duration elapsedTime)
override;
715 std::vector<Item> m_items;
719 int m_selectedItem = -1;
721 int m_hoveringItem = -1;
723 unsigned int m_itemHeight = 0;
726 std::size_t m_maxItems = 0;
730 unsigned int m_lastScrollbarValue = 0;
733 bool m_possibleDoubleClick =
false;
735 bool m_autoScroll =
true;
738 Sprite m_spriteBackground;
743 Color m_borderColorCached;
744 Color m_backgroundColorCached;
745 Color m_backgroundColorHoverCached;
746 Color m_selectedBackgroundColorCached;
747 Color m_selectedBackgroundColorHoverCached;
748 Color m_textColorCached;
749 Color m_textColorHoverCached;
750 Color m_selectedTextColorCached;
751 Color m_selectedTextColorHoverCached;
Base class for render targets.
Definition BackendRenderTarget.hpp:48
Wrapper for colors.
Definition Color.hpp:72
Definition CopiedSharedPtr.hpp:45
Wrapper for durations.
Definition Duration.hpp:56
Class to store the position or size of a widget.
Definition Layout.hpp:305
Definition ListBoxRenderer.hpp:37
List box widget.
Definition ListBox.hpp:43
TGUI_NODISCARD String getItemById(const String &id) const
Returns the item name of the item with the given id.
bool changeItem(const String &originalValue, const String &newValue)
Changes an item with name originalValue to newValue.
void setItemHeight(unsigned int itemHeight)
Changes the height of the items in the list box.
bool changeItemByIndex(std::size_t index, const String &newValue)
Changes the name of an item at the given index to newValue.
TGUI_NODISCARD Signal & getSignal(String signalName) override
Retrieves a signal based on its name.
bool changeItemById(const String &id, const String &newValue)
Changes the name of an item with the given id to newValue.
TGUI_NODISCARD String getItemByIndex(std::size_t index) const
Returns the item name of the item at the given index.
TextAlignment
The horizontal text alignment.
Definition ListBox.hpp:56
void setItemData(std::size_t index, Any data)
Store some user data with the item.
TGUI_NODISCARD std::vector< String > getItems() const
Returns a copy of the items in the list box.
TGUI_NODISCARD bool contains(const String &item) const
Returns whether the list box contains the given item.
void updateTextSize() override
Called when the text size is changed (either by setTextSize or via the renderer)
void deselectItem()
Deselects the selected item.
TGUI_NODISCARD std::vector< String > getItemIds() const
Returns a copy of the item ids in the list box.
std::shared_ptr< const ListBox > ConstPtr
Shared constant widget pointer.
Definition ListBox.hpp:47
TGUI_NODISCARD bool getAutoScroll() const
Returns whether the list box scrolls to the bottom when a new item is added.
void setMaximumItems(std::size_t maximumItems=0)
Changes the maximum items that the list box can contain.
TGUI_NODISCARD ListBoxRenderer * getRenderer() override
Returns the renderer, which gives access to functions that determine how the widget is displayed.
TGUI_NODISCARD bool containsId(const String &id) const
Returns whether the list box contains an item with the given id.
void draw(BackendRenderTarget &target, RenderStates states) const override
Draw the widget to a render target.
bool leftMousePressed(Vector2f pos) override
Called by the parent when the left mouse button goes down on top of the widget.
bool canHandleKeyPress(const Event::KeyEvent &event) override
Called by the parent of the widget to check if keyPressed would process the event.
TGUI_NODISCARD String getSelectedItem() const
Returns the currently selected item.
void setTextAlignment(TextAlignment alignment)
Changes the horizontal text alignment.
TGUI_NODISCARD TextAlignment getTextAlignment() const
Gets the current horizontal text alignment.
void removeAllItems()
Removes all items from the list.
bool removeItemByIndex(std::size_t index)
Removes the item from the list box.
TGUI_NODISCARD String getIdByIndex(std::size_t index) const
Returns the id of the item at the given index.
void load(const std::unique_ptr< DataIO::Node > &node, const LoadingRenderersMap &renderers) override
Loads the widget from a tree of nodes.
static TGUI_NODISCARD ListBox::Ptr create()
Creates a new list box widget.
TGUI_NODISCARD unsigned int getItemHeight() const
Returns the height of the items in the list box.
bool removeItemById(const String &id)
Removes the item that were added with the given id.
bool scrolled(float delta, Vector2f pos, bool touch) override
Called by the parent on scroll event (either from mouse wheel of from two finger scrolling on a touch...
TGUI_NODISCARD int getIndexById(const String &id) const
Returns the index of the item with the given id.
bool setSelectedItemById(const String &id)
Selects an item in the list box.
bool setSelectedItem(const String &itemName)
Selects an item in the list box.
void setScrollbarValue(unsigned int value)
Changes the thumb position of the scrollbar.
bool removeItem(const String &itemName)
Removes the item from the list with the given name.
void setSize(const Layout2d &size) override
Changes the size of the list box.
static TGUI_NODISCARD ListBox::Ptr copy(const ListBox::ConstPtr &listBox)
Makes a copy of another list box.
TGUI_NODISCARD std::size_t getMaximumItems() const
Returns the maximum items that the list box can contain.
TGUI_NODISCARD std::size_t getItemCount() const
Returns the amount of items in the list box.
TGUI_NODISCARD ListBoxRenderer * getSharedRenderer() override
Returns the renderer, which gives access to functions that determine how the widget is displayed.
TGUI_NODISCARD String getSelectedItemId() const
Gets the id of the selected item.
std::size_t addItem(const String &itemName, const String &id="")
Adds an item to the list.
void rendererChanged(const String &property) override
Function called when one of the properties of the renderer is changed.
void setAutoScroll(bool autoScroll)
Changes whether the list box scrolls to the bottom when a new item is added.
TGUI_NODISCARD bool isMouseOnWidget(Vector2f pos) const override
Returns whether the mouse position (which is relative to the parent widget) lies on top of the widget...
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.
std::shared_ptr< ListBox > Ptr
Shared widget pointer.
Definition ListBox.hpp:46
TGUI_NODISCARD unsigned int getScrollbarValue() const
Returns the thumb position of the scrollbar.
bool setSelectedItemByIndex(std::size_t index)
Selects an item in the list box.
TGUI_NODISCARD int getSelectedItemIndex() const
Gets the index of the selected item.
TGUI_NODISCARD Widget::Ptr clone() const override
Makes a copy of the widget if you don't know its exact type.
TGUI_NODISCARD DataType getItemData(std::size_t index) const
Returns user data stored in the item.
Definition ListBox.hpp:412
Definition Outline.hpp:39
Signal to which the user can subscribe to get callbacks from.
Definition Signal.hpp:559
Signal to which the user can subscribe to get callbacks from.
Definition Signal.hpp:62
Wrapper class to store strings.
Definition String.hpp:101
Wrapper for text styles.
Definition TextStyle.hpp:57
Backend-independent wrapper around the backend-specific text class.
Definition Text.hpp:50
Namespace that contains all TGUI functions and classes.
Definition AbsoluteOrRelativeValue.hpp:39
KeyPressed event parameters.
Definition Event.hpp:169
Definition ListBox.hpp:709
States used for drawing.
Definition RenderStates.hpp:39