DropdownPopup

DropdownPopup

#include <Dropdown.hpp>

Inherits: Widget

The floating list that appears when a Dropdown is opened. Managed by OverlayManager, not added to the widget tree directly.

Public Methods

Return	Name	Description
	DropdownPopup	Constructs a dropdown popup.
core::Size	measure virtual	Measures how much space this widget needs.
bool	onEvent virtual	Handles an input event.
bool	isFocusable virtual const inline	Returns whether this widget can receive keyboard focus.

---

DropdownPopup

DropdownPopup(const std::vector< Dropdown::Option > & options, int initialSelected, std::function< void(int)> onSelect, std::function< void()> onClose, std::weak_ptr< Dropdown > parentDropdown)

Constructs a dropdown popup.

Parameters

• options the list of options to display

• initialSelected the initially selected option index

• onSelect callback when an option is selected

• onClose callback when the popup is closed

• parentDropdown weak reference to the parent dropdown widget

---

measure

virtual

virtual core::Size measure(int availW, int availH)

Measures how much space this widget needs.

Called during the measurement pass to determine widget size requirements. Should return the preferred size based on available space.

Parameters

• availW Maximum available width (may be ignored by widget)

• availH Maximum available height (may be ignored by widget)

Returns

The Size this widget wants, or needs at minimum

---

onEvent

virtual

virtual bool onEvent(const core::events::Event & event)

Handles an input event.

Called by the framework to deliver an event to this widget. The default implementation runs any listeners registered via addEventListener(), then returns false. Subclasses (Button, Input, etc.) override this to add built-in behavior, and should call Widget::onEvent(event) first to give user listeners a chance to handle the event before the widget’s own logic.

Return true if the event was handled, false to let it bubble to the parent widget.

Parameters

• event The input event

Returns

True if this widget (or one of its listeners) handled the event

---

isFocusable

virtual const inline

virtual inline bool isFocusable() const

Returns whether this widget can receive keyboard focus.

Widgets like Button and Input return true; containers return false.

Returns

True if this widget can be focused, false otherwise

Protected Methods

Return	Name	Description
void	drawContent virtual	Draws this widget’s content.

---

drawContent

virtual

virtual void drawContent(backend::Buffer & buf, core::Rect inner)

Draws this widget’s content.

Called by render() after background and borders are drawn. This is where you should draw your widget’s actual content. The inner rectangle accounts for borders and padding.

Parameters

• buf The buffer to draw to

• inner The inner rectangle (excluding border/padding)

Private Attributes

Return	Name	Description
const std::vector< Dropdown::Option > &	options
int	hovered
int	initialSelected
int	scrollOffset
std::weak_ptr< Dropdown >	parentDropdown
std::function< void(int)>	onSelect
std::function< void()>	onClose

---

options

const std::vector< Dropdown::Option > & options

---

hovered

int hovered

---

initialSelected

int initialSelected

---

scrollOffset

int scrollOffset = 0

---

parentDropdown

std::weak_ptr< Dropdown > parentDropdown

---

onSelect

std::function< void(int)> onSelect

---

onClose

std::function< void()> onClose