Abstract base class for the fields. More...

#include <field.hpp>

Inheritance diagram for gui2::tfield_:

Public Member Functions
	tfield_ (const std::string &id, const bool mandatory)
	Constructor. More...

virtual	~tfield_ ()

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

void	widget_init (twindow &window)
	Initializes the widget. More...

void	widget_finalize (twindow &window)
	Finalizes the widget. More...

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

virtual void	widget_save (twindow &window)=0
	Saves a widget. More...

virtual void	widget_restore (twindow &window)=0
	Restores a widget. More...

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

const std::string &	id () const

bool	is_mandatory () const

tcontrol *	widget ()

const tcontrol *	widget () const

Private Member Functions
virtual void	init_generic (twindow &window)=0
	See widget_init. More...

virtual void	init_specialized (twindow &)
	See widget_init. More...

virtual void	finalize_generic (twindow &window)=0
	See widget_finalize. More...

virtual void	finalize_specialized (twindow &)
	See widget_finalize. More...

Private Attributes
const std::string	id_
	The id field of the widget, should be unique in a window. More...

const bool	mandatory_
	Is the widget optional or mandatory in this window. More...

tcontrol *	widget_
	The widget attached to the field. More...

Detailed Description

Abstract base class for the fields.

Note: In this context a widget is a gui2::tcontrol and not a gui2::twidget. This name widget is a generic name and fits, however some functions used are first declared in a control.

Definition at line 44 of file field.hpp.

Constructor & Destructor Documentation

gui2::tfield_::tfield_	(	const std::string &	id,
		const bool	mandatory
	)

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

Definition at line 54 of file field.hpp.

virtual gui2::tfield_::~tfield_ ( )

inlinevirtual

Definition at line 59 of file field.hpp.

Member Function Documentation

void gui2::tfield_::attach_to_window ( twindow & window )

inline

Attaches the field to a window.

When attached the widget which we're a wrapper around is stored linked in here.

Warning: After attaching the window must remain a valid. Before the window is destroyed the detach_from_window function must be called.

Todo:: Most functions that have a window parameter only use it to get the widget. Evaluate and remove the window parameter where applicable.

Precondition: widget_ == nullptr

Parameters

window The window to be attached to.

Definition at line 79 of file field.hpp.

References id(), mandatory_, and widget_.

void gui2::tfield_::detach_from_window ( )

inline

Detaches the field from a window.

Precondition: widget_ != nullptr || !mandatory_

Definition at line 133 of file field.hpp.

References mandatory_, and widget_.

virtual void gui2::tfield_::finalize_generic ( twindow & window )

privatepure virtual

See widget_finalize.

Implemented in gui2::tfield< T, W, CT >, gui2::tfield< bool, tselectable_ >, gui2::tfield< std::string, tcontrol, const std::string & >, and gui2::tfield< std::string, ttext_, const std::string & >.

Referenced by widget_finalize().

virtual void gui2::tfield_::finalize_specialized ( twindow & )

inlineprivatevirtual

See widget_finalize.

Reimplemented in gui2::tfield_text.

Definition at line 241 of file field.hpp.

Referenced by widget_finalize().

const std::string& gui2::tfield_::id ( ) const

inline

Definition at line 198 of file field.hpp.

References id_.

Referenced by attach_to_window(), and gui2::tfield< std::string, ttext_, const std::string & >::validate_widget().

virtual void gui2::tfield_::init_generic ( twindow & window )

privatepure virtual

See widget_init.

Implemented in gui2::tfield< T, W, CT >, gui2::tfield< bool, tselectable_ >, gui2::tfield< std::string, tcontrol, const std::string & >, and gui2::tfield< std::string, ttext_, const std::string & >.

Referenced by widget_init().

virtual void gui2::tfield_::init_specialized ( twindow & )

inlineprivatevirtual

See widget_init.

Reimplemented in gui2::tfield_label, and gui2::tfield_bool.

Definition at line 232 of file field.hpp.

Referenced by widget_init().

bool gui2::tfield_::is_mandatory ( ) const

inline

Definition at line 203 of file field.hpp.

References mandatory_.

Referenced by gui2::tfield< std::string, ttext_, const std::string & >::validate_widget().

tcontrol* gui2::tfield_::widget ( )

inline

Definition at line 208 of file field.hpp.

References widget_.

Referenced by gui2::tcustom_tod::pre_show(), and widget_set_enabled().

const tcontrol* gui2::tfield_::widget ( ) const

inline

Definition at line 213 of file field.hpp.

References widget_.

void gui2::tfield_::widget_finalize ( twindow & window )

inline

Finalizes the widget.

This routine is called after the dialog is closed with OK. It's called before post_show(). This routine does the following:

if no active widget available exit.
if a setter is defined the widget value is saved in the setter.
The widget value is saved in value_.

Like widget_init it calls two functions with the same purpose.

Parameters

window The window containing the widget.

Definition at line 122 of file field.hpp.

References finalize_generic(), and finalize_specialized().

void gui2::tfield_::widget_init ( twindow & window )

inline

Initializes the widget.

This routine is called before the dialog is shown and the pre_show() is called. So the user can override the values set. This routine does the following:

If no widget available exit gives feedback it the widget must exist.
If a getter is defined we use to set value_ and the widget.
If no setter is defined we use the widget value to set value_.

The function calls two functions

init_generic which is to be used in the template subclass.
init_specialized which is to be used in subclasses of the template class. This way they can override this function without to use their signature to inherit.

Parameters

window The window containing the widget.

Definition at line 103 of file field.hpp.

References init_generic(), and init_specialized().

virtual void gui2::tfield_::widget_restore ( twindow & window )

pure virtual

Restores a widget.

See widget_save for more info.

Parameters

window The window containing the widget.

Implemented in gui2::tfield< T, W, CT >, gui2::tfield< bool, tselectable_ >, gui2::tfield< std::string, tcontrol, const std::string & >, and gui2::tfield< std::string, ttext_, const std::string & >.

Referenced by widget_set_enabled().

virtual void gui2::tfield_::widget_save ( twindow & window )

pure virtual

Saves a widget.

It can be a window must be recreated, in that case the state needs to be saved and restored. This routine does the following:

if no widget available exit (doesn't look at the active state).
The widget value is saved in value_.

Parameters

window The window containing the widget.

Implemented in gui2::tfield< T, W, CT >, gui2::tfield< bool, tselectable_ >, gui2::tfield< std::string, tcontrol, const std::string & >, and gui2::tfield< std::string, ttext_, const std::string & >.

Referenced by widget_set_enabled().

void gui2::tfield_::widget_set_enabled	(	twindow &	window,
		const bool	enable,
		const bool	sync
	)

inline

Enables a widget.

Parameters

window	The window containing the widget.
enable	If true enables the widget, disables otherwise.
sync	If the state is changed do we need to synchronize. Upon disabling, write the value of the widget in the variable value_. Upon enabling write the value of value_ in the widget.

Definition at line 172 of file field.hpp.

References gui2::twindow::find(), gui2::tcontrol::get_active(), gui2::tcontrol::set_active(), widget(), widget_restore(), and widget_save().

Referenced by gui2::tmp_create_game::update_map_settings().