Multiline text input area. More...

Detailed Description

Multiline text input area.

Word breaking text area.

In contrast to ATextField, ATextArea is not scrollable. It is often preferable to use a dedicated scroll area to make the entire application pages scrollable with other content rather than using nested scrolls just for text area.

If you want to make AScrollArea scrollable, it can be placed inside a AScrollArea:

AScrollArea::Builder().withContents(_new<AScrollArea>())

AScrollArea::Builder

Definition: AScrollArea.h:130

This is why it does not offer default styling - you would probably want to style AScrollArea as if it were text input.

ATextArea offers integrations and optimizations for AScrollArea specifically.

Public Types
using	Iterator = Entries::iterator

Public Member Functions
	ATextArea (const AString &text)

bool	capturesFocus () override

AString	toString () const override

const AString &	text () const override

unsigned int	cursorIndexByPos (glm::ivec2 pos) override

glm::ivec2	getPosByIndex (size_t index) override

void	setText (const AString &t) override

void	render (ARenderContext context) override

void	onCharEntered (char16_t c) override

glm::ivec2	getCursorPosition () override

void	setSize (glm::ivec2 size) override

bool	isPasswordField () const noexcept override

ATextInputType	textInputType () const noexcept override

Public Member Functions inherited from AAbstractTypeableView< ATextBase< AWordWrappingEngine< std::list< _unique< aui::detail::TextBaseEntry > > > > >
void	onKeyDown (AInput::Key key) override

void	onKeyRepeat (AInput::Key key) override

void	onFocusLost () override

void	onPointerPressed (const APointerPressedEvent &event) override

void	onPointerDoubleClicked (const APointerPressedEvent &event) override

void	onPointerMove (glm::vec2 pos, const APointerMoveEvent &event) override

void	onPointerReleased (const APointerReleasedEvent &event) override

bool	wantsTouchscreenKeyboard () override

bool	handlesNonMouseNavigation () override

void	onFocusAcquired () override

void	invalidateAllStyles () override

bool	isLButtonPressed () override

void	drawCursor (IRenderer &renderer, glm::ivec2 position)

Public Member Functions inherited from AAbstractTypeable
void	clear ()

void	setMaxTextLength (size_t newTextLength)

void	trimText ()

void	setCopyable (bool isCopyable)

void	setTextInputActionIcon (ATextInputActionIcon textInputActionIcon) noexcept

ATextInputActionIcon	textInputActionIcon () const noexcept

void	copyToClipboard () const
	Performs copy operation (CTRL+C) to system clipboard.

void	cutToClipboard ()
	Performs cut operation (CTRL+X) to system clipboard.

void	pasteFromClipboard ()
	Performs paste operation (CTRL+V) from system clipboard. More...

void	paste (AString content)
	Performs paste operation (CTRL+V). More...

void	moveCursorLeft ()
	Performs move left operation (like AInput::LEFT)

void	moveCursorRight ()
	Performs move right operation (like AInput::RIGHT)

Public Member Functions inherited from ACursorSelectable
AString	selectedText () const

Selection	selection () const

bool	hasSelection () const

void	selectAll ()
	Select whole text in the text field.

void	clearSelection ()
	Remove selection from the text field.

void	setSelection (int cursorIndex)

void	setSelection (Selection selection)

Protected Member Functions
void	typeableErase (size_t begin, size_t end) override

bool	typeableInsert (size_t at, const AString &toInsert) override

bool	typeableInsert (size_t at, char16_t toInsert) override

size_t	typeableFind (char16_t c, size_t startPos) override

size_t	typeableReverseFind (char16_t c, size_t startPos) override

size_t	length () const override

void	fillStringCanvas (const _< IRenderer::IMultiStringCanvas > &canvas) override

Protected Member Functions inherited from AAbstractTypeableView< ATextBase< AWordWrappingEngine< std::list< _unique< aui::detail::TextBaseEntry > > > > >
AMenuModel	composeContextMenu () override

void	commitStyle () override

int	getVerticalAlignmentOffset () noexcept

void	cursorSelectableRedraw () override

void	onSelectionChanged () override

Protected Member Functions inherited from AAbstractTypeable
bool	isCursorBlinkVisible () const

void	updateCursorBlinking ()

virtual void	updateSelectionOnTextSet (const AString &t)

void	enterChar (char16_t c)

AString	getDisplayText () override

AMenuModel	composeContextMenuImpl ()

void	handleKey (AInput::Key key)

Protected Member Functions inherited from ACursorSelectable
void	handleMouseDoubleClicked (const APointerPressedEvent &event)

void	handleMousePressed (const APointerPressedEvent &event)

void	handleMouseReleased (const APointerReleasedEvent &event)

void	handleMouseMove (const glm::ivec2 &pos)

template<aui::invocable Callback>
void	drawSelectionBeforeAndAfter (IRenderer &render, std::span< ARect< int > > rects, Callback &&drawText)

Friends
class	UITextArea

Additional Inherited Members
Static Public Member Functions inherited from IStringable
template<typename T >
static AString	toString (const T *t)

template<typename T >
static AString	toString (const _< T > &t)

Signals and public fields inherited from AAbstractTypeable
emits< AString >	textChanged

emits< AString >	textChanging

emits< Selection >	selectionChanged

emits	actionButtonPressed

Protected Attributes inherited from AAbstractTypeable
size_t	mMaxTextLength = 0x200

bool	mIsMultiline = false

Protected Attributes inherited from ACursorSelectable
unsigned	mCursorIndex = 0

AOptional< unsigned >	mCursorSelection

Member Function Documentation

◆ cursorIndexByPos()

unsigned int ATextArea::cursorIndexByPos ( glm::ivec2 pos )

overridevirtual

Returns: Character index by pixel position.

Implements ACursorSelectable.

◆ getCursorPosition()

glm::ivec2 ATextArea::getCursorPosition ( )

overridevirtual

Returns: Cursor position relative to this view.

Returns position relative to top left corner of the view. That is, if implementation supports scrolling (i.e., ATextField) the returned position does not include overflowed contents.

Implements ACursorSelectable.

◆ getPosByIndex()

glm::ivec2 ATextArea::getPosByIndex ( size_t index )

overridevirtual

Implements ACursorSelectable.

◆ isPasswordField()

bool ATextArea::isPasswordField ( ) const

overridevirtualnoexcept

Returns: true if this typeable should be treated as password.

Implements AAbstractTypeable.

◆ length()

size_t ATextArea::length ( ) const

overrideprotectedvirtual

Returns: Text field text length.

Implements ACursorSelectable.

◆ setText()

void ATextArea::setText ( const AString & t )

overridevirtual

Reimplemented from AAbstractTypeable.

◆ text()

const AString & ATextArea::text ( ) const

overridevirtual

Returns

Text field text.

Performance note: If text length is needed, use textLength() function instead. On some implementations it's faster that text().

Implements ACursorSelectable.

◆ textInputType()

ATextInputType ATextArea::textInputType ( ) const

overridevirtualnoexcept

Returns: text input type of this typeable.

See also: ATextInputType

Implements AAbstractTypeable.

◆ toString()

AString ATextArea::toString ( ) const

overridevirtual

Returns: string representation of the object

Implements IStringable.

◆ typeableErase()

void ATextArea::typeableErase	(	size_t	begin,
		size_t	end
	)

overrideprotectedvirtual

Implements AAbstractTypeable.

◆ typeableFind()

size_t ATextArea::typeableFind	(	char16_t	c,
		size_t	startPos
	)

overrideprotectedvirtual

Implements AAbstractTypeable.

◆ typeableInsert() [1/2]

bool ATextArea::typeableInsert	(	size_t	at,
		char16_t	toInsert
	)

overrideprotectedvirtual

Inserts string.

Returns: true, if successfully inserted; false otherwise

Note: when insert could not be completed (i.e. isValidText discarded the new string contents), the state is left unchanged as like if typeableInsert have not been called.

Implements AAbstractTypeable.

◆ typeableInsert() [2/2]

bool ATextArea::typeableInsert	(	size_t	at,
		const AString &	toInsert
	)

overrideprotectedvirtual

Inserts string.

Returns: true, if successfully inserted; false otherwise

Note: when insert could not be completed (i.e. isValidText discarded the new string contents), the state is left unchanged as like if typeableInsert have not been called.

Implements AAbstractTypeable.

◆ typeableReverseFind()

size_t ATextArea::typeableReverseFind	(	char16_t	c,
		size_t	startPos
	)

overrideprotectedvirtual

Implements AAbstractTypeable.

#include <AUI/View/ATextArea.h>

The documentation for this class was generated from the following files:

aui.views/src/AUI/View/ATextArea.h
aui.views/src/AUI/View/ATextArea.cpp

Inheritance diagram for ATextArea:

[legend]

Collaboration diagram for ATextArea:

[legend]

Detailed Description

Public Types

Public Member Functions

Protected Member Functions

Friends

Additional Inherited Members

Member Function Documentation

◆ cursorIndexByPos()

◆ getCursorPosition()

◆ getPosByIndex()

◆ isPasswordField()

◆ length()

◆ setText()

◆ text()

◆ textInputType()

◆ toString()

◆ typeableErase()

◆ typeableFind()

◆ typeableInsert() [1/2]

◆ typeableInsert() [2/2]

◆ typeableReverseFind()