Template class to implement the generic field implementation. More...

#include <field.hpp>

Inheritance diagram for gui2::field< T, W, CT >:

Public Member Functions
	field (const std::string &id, const bool mandatory, const std::function< T()> &callback_load_value, const std::function< void(CT)> &callback_save_value)
	Constructor. More...

	field (const std::string &id, const bool mandatory, T &linked_variable)
	Constructor. More...

	field (const std::string &id, const bool mandatory, const T &value)
	Constructor. More...

void	widget_restore ()
	Inherited from field_base. More...

void	set_widget_value (CT value)
	Sets the value of the field. More...

void	set_cache_value (CT value)
	Sets the value of the field. More...

void	widget_save ()
	Inherited from field_base. More...

T	get_widget_value ()
	Gets the value of the field. More...

Public Member Functions inherited from gui2::field_base
	field_base (const std::string &id, const bool mandatory)
	Constructor. More...

virtual	~field_base ()

void	attach_to_window (window &window)
	Attaches the field to a window. More...

void	widget_init ()
	Initializes the widget. More...

void	widget_finalize ()
	Finalizes the widget. More...

void	detach_from_window ()
	Detaches the field from a window. More...

void	widget_set_enabled (const bool enable, const bool sync)
	Enables a widget. More...

const std::string &	id () const

bool	is_mandatory () const

styled_widget *	get_widget ()

const styled_widget *	get_widget () const

Private Member Functions
void	init_generic ()
	Inherited from field_base. More...

void	finalize_generic ()
	Inherited from field_base. More...

void	validate_widget ()
	Test whether the widget exists if the widget is mandatory. More...

void	save (const bool must_be_active)
	Stores the value in the widget in the interval value_. More...

void	restore ()
	Stores the internal value_ in the widget. More...

Private Attributes
T	value_
	The value_ of the widget, this value is also available once the widget is destroyed. More...

T &	link_
	The variable linked to the field. More...

std::function< T()>	callback_load_value_
	The callback function to load the value. More...

std::function< void(CT)>	callback_save_value_
	The callback function to save the value. More...

Detailed Description

template<class T, class W, class CT>
class gui2::field< T, W, CT >

Template class to implement the generic field implementation.

Template Parameters

T	The type of the item to show in the widget.
W	The type of widget to show, this is not a widget class but a behavior class.
CT	The type tp be used in the callback_save_value callback. Normally this is const T but for example with strings it can be const T&. Note the const needs to be in the template otherwise compilation on GCC-4.3 fails (not sure whether compiler bug or not).

Definition at line 245 of file field.hpp.

Constructor & Destructor Documentation

◆ field() [1/3]

template<class T , class W , class CT >

gui2::field< T, W, CT >::field	(	const std::string &	id,
		const bool	mandatory,
		const std::function< T()> &	callback_load_value,
		const std::function< void(CT)> &	callback_save_value
	)

inline

Constructor.

Parameters

id	The id of the widget to connect to the window. A widget can only be connected once.
mandatory	Is the widget mandatory?
callback_load_value	A callback function which is called when the window is shown. This callback returns the initial value of the field.
callback_save_value	A callback function which is called when the window closed with the OK button. The callback is executed with the new value of the field. It's meant to set the value of some variable in the engine after the window is closed with OK.

Definition at line 264 of file field.hpp.

◆ field() [2/3]

template<class T , class W , class CT >

gui2::field< T, W, CT >::field	(	const std::string &	id,
		const bool	mandatory,
		T &	linked_variable
	)

inline

Constructor.

Parameters

id	The id of the widget to connect to the window. A widget can only be connected once.
mandatory	Is the widget mandatory?
linked_variable	The variable which is linked to the field. Upon loading its value is used as initial value of the widget. Upon closing: with OK its value is set to the value of the widget. else, its value is undefined.

Definition at line 291 of file field.hpp.

◆ field() [3/3]

template<class T , class W , class CT >

gui2::field< T, W, CT >::field	(	const std::string &	id,
		const bool	mandatory,
		const T &	value
	)

inline

Constructor.

This version is used for read only variables.

Note: The difference between this constructor and the one above is the sending of the third parameter as const ref instead of a non-const ref. So it feels a bit tricky. Since this constructor is only used for a the styled_widget class and the other constructors not the issue is solved by using static asserts to test whether the proper constructor is used.

Parameters

mandatory	Is the widget mandatory?
id	The id of the widget to connect to the window. A widget can only be connected once.
value	The value of the widget.

Definition at line 318 of file field.hpp.

Member Function Documentation

◆ finalize_generic()

template<class T , class W , class CT >

void gui2::field< T, W, CT >::finalize_generic ( )

inlineprivatevirtual

Inherited from field_base.

Implements gui2::field_base.

Definition at line 422 of file field.hpp.

References gui2::field< T, W, CT >::callback_save_value_, gui2::field< T, W, CT >::link_, gui2::field< T, W, CT >::save(), and gui2::field< T, W, CT >::value_.

◆ get_widget_value()

template<class T , class W , class CT >

T gui2::field< T, W, CT >::get_widget_value ( )

inline

Gets the value of the field.

This function gets the value of the widget and stores that in the internal cache, then that value is returned.

Deprecated:: Use references to a variable instead.

Returns: The current value of the widget.

Definition at line 379 of file field.hpp.

References gui2::field< T, W, CT >::save(), and gui2::field< T, W, CT >::value_.

Referenced by gui2::dialogs::generator_settings::adjust_minimum_size_by_players(), gui2::dialogs::custom_tod::color_slider_callback(), gui2::dialogs::mp_login::load_password(), gui2::dialogs::mp_create_game::post_show(), gui2::dialogs::mp_login::save_password(), gui2::dialogs::editor_resize_map::update_expand_direction(), and gui2::dialogs::mp_create_game::update_map_settings().

◆ init_generic()

template<class T , class W , class CT >

void gui2::field< T, W, CT >::init_generic ( )

inlineprivatevirtual

Inherited from field_base.

Implements gui2::field_base.

Definition at line 408 of file field.hpp.

References gui2::field< T, W, CT >::callback_load_value_, gui2::field< T, W, CT >::link_, gui2::field< T, W, CT >::restore(), gui2::field< T, W, CT >::validate_widget(), and gui2::field< T, W, CT >::value_.

◆ restore()

template<class T , class W , class CT >

void gui2::field< T, W, CT >::restore ( )

inlineprivate

Stores the internal value_ in the widget.

Definition at line 475 of file field.hpp.

References gui2::field_base::get_widget(), and gui2::field< T, W, CT >::value_.

Referenced by gui2::field< T, W, CT >::init_generic(), gui2::field< T, W, CT >::set_widget_value(), and gui2::field< T, W, CT >::widget_restore().

◆ save()

template<class T , class W , class CT >

void gui2::field< T, W, CT >::save ( const bool must_be_active )

inlineprivate

Stores the value in the widget in the interval value_.

Parameters

must_be_active If true only active widgets will store their value.

Definition at line 456 of file field.hpp.

References gui2::field_base::get_widget(), and gui2::field< T, W, CT >::value_.

Referenced by gui2::field< T, W, CT >::finalize_generic(), gui2::field< T, W, CT >::get_widget_value(), and gui2::field< T, W, CT >::widget_save().

◆ set_cache_value()

template<class T , class W , class CT >

void gui2::field< T, W, CT >::set_cache_value ( CT value )

inline

Sets the value of the field.

This sets the internal cache value but not the widget value, this can be used to initialize the field.

Parameters

value The new value.

Definition at line 358 of file field.hpp.

References gui2::field< T, W, CT >::value_.

◆ set_widget_value()

template<class T , class W , class CT >

void gui2::field< T, W, CT >::set_widget_value ( CT value )

inline

Sets the value of the field.

This sets the value in both the internal cache value and in the widget itself.

Parameters

value The new value.

Definition at line 344 of file field.hpp.

References gui2::field< T, W, CT >::restore(), and gui2::field< T, W, CT >::value_.

Referenced by gui2::dialogs::mp_create_game::reset_timer_settings(), gui2::dialogs::mp_create_game::update_map_settings(), and gui2::dialogs::custom_tod::update_selected_tod_info().

◆ validate_widget()

template<class T , class W , class CT >

void gui2::field< T, W, CT >::validate_widget ( )

inlineprivate

Test whether the widget exists if the widget is mandatory.

Definition at line 444 of file field.hpp.

References gui2::field_base::get_widget(), and gui2::field_base::is_mandatory().

Referenced by gui2::field< T, W, CT >::init_generic(), and gui2::field< T, W, CT >::widget_restore().

◆ widget_restore()

template<class T , class W , class CT >

void gui2::field< T, W, CT >::widget_restore ( )

inlinevirtual

Inherited from field_base.

Implements gui2::field_base.

Definition at line 329 of file field.hpp.

References gui2::field< T, W, CT >::restore(), and gui2::field< T, W, CT >::validate_widget().

◆ widget_save()

template<class T , class W , class CT >

void gui2::field< T, W, CT >::widget_save ( )

inlinevirtual

Inherited from field_base.

Implements gui2::field_base.

Definition at line 364 of file field.hpp.

References gui2::field< T, W, CT >::save().

Member Data Documentation

◆ callback_load_value_

template<class T , class W , class CT >

std::function<T()> gui2::field< T, W, CT >::callback_load_value_

private

The callback function to load the value.

This is used to load the initial value of the widget, if defined.

Definition at line 405 of file field.hpp.

Referenced by gui2::field< T, W, CT >::init_generic().

◆ callback_save_value_

template<class T , class W , class CT >

std::function<void(CT)> gui2::field< T, W, CT >::callback_save_value_

private

The callback function to save the value.

Once the dialog has been successful this function is used to store the result of this widget.

Definition at line 439 of file field.hpp.

Referenced by gui2::field< T, W, CT >::finalize_generic().

◆ link_

template<class T , class W , class CT >

T& gui2::field< T, W, CT >::link_

private

The variable linked to the field.

When set determines the initial value and the final value is stored here in the finalizer.

Definition at line 398 of file field.hpp.

Referenced by gui2::field< T, W, CT >::finalize_generic(), and gui2::field< T, W, CT >::init_generic().

◆ value_

template<class T , class W , class CT >

T gui2::field< T, W, CT >::value_

private

The value_ of the widget, this value is also available once the widget is destroyed.

Definition at line 390 of file field.hpp.

Referenced by gui2::field< T, W, CT >::finalize_generic(), gui2::field< T, W, CT >::get_widget_value(), gui2::field< T, W, CT >::init_generic(), gui2::field< T, W, CT >::restore(), gui2::field< T, W, CT >::save(), gui2::field< T, W, CT >::set_cache_value(), and gui2::field< T, W, CT >::set_widget_value().

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

gui/auxiliary/field-fwd.hpp
gui/auxiliary/field.hpp

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

template<class T, class W, class CT> class gui2::field< T, W, CT >

Constructor & Destructor Documentation

◆ field() [1/3]

◆ field() [2/3]

◆ field() [3/3]

Member Function Documentation

◆ finalize_generic()

◆ get_widget_value()

◆ init_generic()

◆ restore()

◆ save()

◆ set_cache_value()

◆ set_widget_value()

◆ validate_widget()

◆ widget_restore()

◆ widget_save()

Member Data Documentation

◆ callback_load_value_

◆ callback_save_value_

◆ link_

◆ value_

template<class T, class W, class CT>
class gui2::field< T, W, CT >