#include <group.hpp>

Public Member Functions
void	add_member (selectable_item *w, const T &value)
	Adds a widget/value pair to the group map. More...

void	remove_member (const T &value)
	Removes a member from the group map. More...

void	clear ()
	Clears the entire group of members. More...

group_map &	members ()
	Group member getters. More...

const group_map &	members () const

template<typename W >
W &	member (const T &value)

T	get_active_member_value () const
	Returns the value paired with the currently actively toggled member of the group. More...

void	set_member_states (const T &value)
	Sets the toggle values for all widgets besides the one associated with the specified value to false. More...

template<typename Func >
void	on_modified (const Func &func)
	Sets a common callback function for all members. More...

template<typename Func >
void	set_members_enabled (const Func &predicate)
	Wrapper for enabling or disabling member widgets. More...

Private Types
using	group_map = std::map< T, selectable_item * >

using	order_vector = std::vector< styled_widget * >

Private Member Functions
void	group_operator ()
	The default actions to take when clicking on one of the widgets in the group. More...

Private Attributes
group_map	members_
	Container map for group members, organized by member value, associated widget. More...

order_vector	member_order_
	Since iterating over std::map is specified by operator< for it's key values, we can't guarantee the order would line up with the logical order - ie, that which the widgets appear in in a specific dialog. More...

Detailed Description

template<class T>
class gui2::group< T >

Definition at line 30 of file group.hpp.

Member Typedef Documentation

◆ group_map

template<class T >

using gui2::group< T >::group_map = std::map<T, selectable_item*>

private

Definition at line 32 of file group.hpp.

◆ order_vector

template<class T >

using gui2::group< T >::order_vector = std::vector<styled_widget*>

private

Definition at line 33 of file group.hpp.

Member Function Documentation

◆ add_member()

template<class T >

void gui2::group< T >::add_member	(	selectable_item *	w,
		const T &	value
	)

inline

Adds a widget/value pair to the group map.

A callback is set that toggles each members' state to false when clicked. This happens before individual widget handlers fire, ensuring that the clicked widget will remain the only one selected.

Definition at line 41 of file group.hpp.

References gui2::event::dispatcher::connect_signal(), ERR_GUI_G, gui2::event::dispatcher::front_child, gui2::group< T >::group_operator(), gui2::event::LEFT_BUTTON_CLICK, gui2::group< T >::member_order_, gui2::group< T >::members_, and w.

Referenced by gui2::dialogs::preferences_dialog::initialize_callbacks(), gui2::dialogs::editor_edit_side::pre_show(), gui2::dialogs::log_settings::pre_show(), gui2::dialogs::faction_select::pre_show(), gui2::dialogs::units_dialog::pre_show(), and gui2::dialogs::select_orb_colors::setup_orb_group().

◆ clear()

template<class T >

void gui2::group< T >::clear ( )

inline

Clears the entire group of members.

Definition at line 68 of file group.hpp.

References gui2::group< T >::members_.

◆ get_active_member_value()

template<class T >

T gui2::group< T >::get_active_member_value ( ) const

inline

Returns the value paired with the currently actively toggled member of the group.

Definition at line 95 of file group.hpp.

References gui2::group< T >::member(), and gui2::group< T >::members_.

Referenced by gui2::dialogs::editor_edit_side::post_show().

◆ group_operator()

template<class T >

void gui2::group< T >::group_operator ( )

inlineprivate

The default actions to take when clicking on one of the widgets in the group.

Definition at line 201 of file group.hpp.

References gui2::group< T >::member(), and gui2::group< T >::members_.

Referenced by gui2::group< T >::add_member().

◆ member()

template<class T >

template<typename W >

W& gui2::group< T >::member ( const T & value )

inline

Definition at line 87 of file group.hpp.

References gui2::group< T >::members_.

Referenced by gui2::group< T >::get_active_member_value(), gui2::group< T >::group_operator(), gui2::group< T >::on_modified(), gui2::group< T >::set_member_states(), and gui2::group< T >::set_members_enabled().

◆ members() [1/2]

template<class T >

group_map& gui2::group< T >::members ( )

inline

Group member getters.

Definition at line 76 of file group.hpp.

References gui2::group< T >::members_.

◆ members() [2/2]

template<class T >

const group_map& gui2::group< T >::members ( ) const

inline

Definition at line 81 of file group.hpp.

References gui2::group< T >::members_.

◆ on_modified()

template<class T >

template<typename Func >

void gui2::group< T >::on_modified ( const Func & func )

inline

Sets a common callback function for all members.

Definition at line 121 of file group.hpp.

References gui2::event::connect_signal_notify_modified(), gui2::selectable_item::get_value_bool(), gui2::group< T >::member(), gui2::group< T >::members_, and w.

Referenced by gui2::dialogs::preferences_dialog::initialize_callbacks(), gui2::dialogs::faction_select::pre_show(), and gui2::dialogs::units_dialog::pre_show().

◆ remove_member()

template<class T >

void gui2::group< T >::remove_member ( const T & value )

inline

Removes a member from the group map.

Definition at line 60 of file group.hpp.

References gui2::group< T >::members_.

◆ set_member_states()

template<class T >

void gui2::group< T >::set_member_states ( const T & value )

inline

Sets the toggle values for all widgets besides the one associated with the specified value to false.

Definition at line 110 of file group.hpp.

References gui2::group< T >::member(), and gui2::group< T >::members_.

Referenced by gui2::dialogs::preferences_dialog::initialize_callbacks(), gui2::dialogs::editor_edit_side::pre_show(), gui2::dialogs::log_settings::pre_show(), gui2::dialogs::faction_select::pre_show(), gui2::dialogs::units_dialog::pre_show(), and gui2::dialogs::select_orb_colors::setup_orb_group().

◆ set_members_enabled()

template<class T >

template<typename Func >

void gui2::group< T >::set_members_enabled ( const Func & predicate )

inline

Wrapper for enabling or disabling member widgets.

Each member widget will be enabled or disabled based on the result of the specified predicate, which takes its associated value.

If a selected widget is to be disabled, it is deselected and the first active member selected instead. The same happens if no members were previously active at all.

Definition at line 151 of file group.hpp.

References gui2::group< T >::member(), gui2::group< T >::member_order_, gui2::group< T >::members_, gui2::selectable_item::set_value_bool(), and w.

Referenced by gui2::dialogs::faction_select::on_leader_select().

Member Data Documentation

◆ member_order_

template<class T >

order_vector gui2::group< T >::member_order_

private

Since iterating over std::map is specified by operator< for it's key values, we can't guarantee the order would line up with the logical order - ie, that which the widgets appear in in a specific dialog.

Keeping a separate vector here allows iterating over members in the order which they are added to the group.

Definition at line 196 of file group.hpp.

Referenced by gui2::group< T >::add_member(), and gui2::group< T >::set_members_enabled().

◆ members_

template<class T >

group_map gui2::group< T >::members_

private

Container map for group members, organized by member value, associated widget.

Definition at line 188 of file group.hpp.

Referenced by gui2::group< T >::add_member(), gui2::group< T >::clear(), gui2::group< T >::get_active_member_value(), gui2::group< T >::group_operator(), gui2::group< T >::member(), gui2::group< T >::members(), gui2::group< T >::on_modified(), gui2::group< T >::remove_member(), gui2::group< T >::set_member_states(), and gui2::group< T >::set_members_enabled().

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

gui/widgets/group.hpp

Public Member Functions

Private Types

Private Member Functions

Private Attributes

Detailed Description

template<class T> class gui2::group< T >

Member Typedef Documentation

◆ group_map

◆ order_vector

Member Function Documentation

◆ add_member()

◆ clear()

◆ get_active_member_value()

◆ group_operator()

◆ member()

◆ members() [1/2]

◆ members() [2/2]

◆ on_modified()

◆ remove_member()

◆ set_member_states()

◆ set_members_enabled()

Member Data Documentation

◆ member_order_

◆ members_

template<class T>
class gui2::group< T >