TextView

TextView

#include <TextView.hpp>

Inherits: Widget

A read-only multiline text widget.

TextView displays text over multiple lines and supports optional vertical scrolling for long content.

Public Methods

Return	Name	Description
	TextView	Defaulted constructor.
	TextView inline explicit	Create a text view with text inside it.
void	setText inline	Set the text content of the TextView.
const std::string &	getText const inline	Get the current text content of the TextView.
void	setFlowMode inline	Set the text flow mode, which determines how the TextArea handles overflow.
TextFlowMode	getFlowMode const inline	Get the current text flow mode.
bool	isFocusable virtual const	Returns whether this widget can receive keyboard focus.
bool	onEvent virtual	Handles an input event.
void	setScrollX
int	scrollX const inline
void	setScrollY
int	scrollY const inline
core::Size	measure virtual	Measures how much space this widget needs.

---

TextView

TextView() = default

Defaulted constructor.

---

TextView

inline explicit

inline explicit TextView(const std::string & text)

Create a text view with text inside it.

Parameters

• text The text to display in the TextView

---

setText

inline

inline void setText(const std::string & t)

Set the text content of the TextView.

Parameters

• t The new text content

---

getText

const inline

inline const std::string & getText() const

Get the current text content of the TextView.

Returns

The current text content

---

setFlowMode

inline

inline void setFlowMode(TextFlowMode mode)

Set the text flow mode, which determines how the TextArea handles overflow.

Parameters

• mode The new TextFlowMode (default: Scroll)

---

getFlowMode

const inline

inline TextFlowMode getFlowMode() const

Get the current text flow mode.

Returns

The current flow mode

---

isFocusable

virtual const

virtual 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

---

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

---

setScrollX

void setScrollX(int x)

---

scrollX

const inline

inline int scrollX() const

---

setScrollY

void setScrollY(int y)

---

scrollY

const inline

inline int scrollY() const

---

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

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
std::string	text
int	scrollOffsetX
int	scrollOffsetY
TextFlowMode	flowMode

---

text

std::string text

---

scrollOffsetX

int scrollOffsetX = 0

---

scrollOffsetY

int scrollOffsetY = 0

---

flowMode

TextFlowMode flowMode = TextFlowMode::Scroll