hi::v1::default_text_field_delegate< T > Class Template Reference

#include <hikogui/widgets/text_field_delegate.hpp>

Inheritance diagram for hi::v1::default_text_field_delegate< T >:

Public Types
using	value_type = T
using	value_type = T
Public Types inherited from hi::v1::text_field_delegate
using	notifier_type = notifier<void()>

Public Member Functions
template<forward_of< observer< value_type > > Value>
	default_text_field_delegate (Value &&value) noexcept
label	validate (widget_intf const &sender, gstring const &text) noexcept override
	Validate the text field.
gstring	text (widget_intf const &sender) noexcept override
	Get the text to show in the text field.
void	set_text (widget_intf const &sender, gstring const &text) noexcept override
	Set the text as entered by the user.
template<forward_of< observer< value_type > > Value>
	default_text_field_delegate (Value &&value) noexcept
label	validate (widget_intf const &sender, gstring const &text) noexcept override
	Validate the text field.
gstring	text (widget_intf const &sender) noexcept override
	Get the text to show in the text field.
void	set_text (widget_intf const &sender, gstring const &text) noexcept override
	Set the text as entered by the user.
Public Member Functions inherited from hi::v1::text_field_delegate
virtual void	init (widget_intf const &sender) noexcept
virtual void	deinit (widget_intf const &sender) noexcept
template<forward_of< void()> Func>
callback< void()>	subscribe (Func &&func, callback_flags flags=callback_flags::synchronous) noexcept

Data Fields
observer< value_type >	value

Detailed Description

template<std::integral T>
class hi::v1::default_text_field_delegate< T >

A default text delegate specialization for std::integral<T>.

A default text delegate specialization for std::floating_point<T>.

This delegate makes it possible for a text-field to edit an integral value. It will automatically validate and convert between the integral value and the text representation.

Template Parameters

T	An integral type

This delegate makes it possible for a text-field to edit an floating point value. It will automatically validate and convert between the floating point value and the text representation.

Template Parameters

T	An floating point type

Member Function Documentation

set_text() [1/2]

template<std::integral T>

void hi::v1::default_text_field_delegate< T >::set_text ( widget_intf const & sender, gstring const & text )

inlineoverridevirtualnoexcept

Set the text as entered by the user.

When the user causes a text field to commit, by pressing enter, tab, or clicking outside the field and when the text was validated the widget will call this function to commit the text with the delegate.

Precondition

text Must have been validated as correct.

Parameters

sender	The widget that called this function.
text	The text entered by the user.

Reimplemented from hi::v1::text_field_delegate.

set_text() [2/2]

template<std::integral T>

void hi::v1::default_text_field_delegate< T >::set_text ( widget_intf const & sender, gstring const & text )

inlineoverridevirtualnoexcept

Set the text as entered by the user.

When the user causes a text field to commit, by pressing enter, tab, or clicking outside the field and when the text was validated the widget will call this function to commit the text with the delegate.

Precondition

text Must have been validated as correct.

Parameters

sender	The widget that called this function.
text	The text entered by the user.

Reimplemented from hi::v1::text_field_delegate.

text() [1/2]

template<std::integral T>

gstring hi::v1::default_text_field_delegate< T >::text ( widget_intf const & sender )

inlineoverridevirtualnoexcept

Get the text to show in the text field.

When the user is not editing the text the text-field will request what to show using this function.

Parameters

sender

The widget that called this function.

Returns

The text to show in the text field.

Reimplemented from hi::v1::text_field_delegate.

text() [2/2]

template<std::integral T>

gstring hi::v1::default_text_field_delegate< T >::text ( widget_intf const & sender )

inlineoverridevirtualnoexcept

Get the text to show in the text field.

When the user is not editing the text the text-field will request what to show using this function.

Parameters

sender

The widget that called this function.

Returns

The text to show in the text field.

Reimplemented from hi::v1::text_field_delegate.

validate() [1/2]

template<std::integral T>

label hi::v1::default_text_field_delegate< T >::validate ( widget_intf const & sender, gstring const & text )

inlineoverridevirtualnoexcept

Validate the text field.

Parameters

sender	The widget that called this function.
text	The text entered by the user into the text field.

Returns

no-value when valid, or a label to display to the user when invalid.

Reimplemented from hi::v1::text_field_delegate.

validate() [2/2]

template<std::integral T>

label hi::v1::default_text_field_delegate< T >::validate ( widget_intf const & sender, gstring const & text )

inlineoverridevirtualnoexcept

Validate the text field.

Parameters

sender	The widget that called this function.
text	The text entered by the user into the text field.

Returns

no-value when valid, or a label to display to the user when invalid.

Reimplemented from hi::v1::text_field_delegate.

---

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

• hikogui/src/hikogui/widgets/text_field_delegate.hpp