List template of 'things' T to sort in a GUI. More...

#include <sortlist_type.h>

Inheritance diagram for GUIList< T, P, F >:

Public Types
using	SortFunction = std::conditional_t< std::is_same_v< P, std::nullptr_t >, bool(const T &, const T &), bool(const T &, const T &, const P)>
	Signature of sort function.

typedef bool CDECL	FilterFunction(const T *, F)
	Signature of filter function.

Public Member Functions
template<typename T_ = T, typename P_ = P, typename _F = F, std::enable_if_t<!std::is_same_v< P_, std::nullptr_t >> * = nullptr>
	GUIList (const P &params)

uint8_t	SortType () const
	Get the sorttype of the list. More...

void	SetSortType (uint8_t n_type)
	Set the sorttype of the list. More...

Listing	GetListing () const
	Export current sort conditions. More...

void	SetListing (Listing l)
	Import sort conditions. More...

uint8_t	FilterType () const
	Get the filtertype of the list. More...

void	SetFilterType (uint8_t n_type)
	Set the filtertype of the list. More...

Filtering	GetFiltering () const
	Export current filter conditions. More...

void	SetFiltering (Filtering f)
	Import filter conditions. More...

bool	NeedResort ()
	Check if a resort is needed next loop If used the resort timer will decrease every call till 0. More...

void	ForceResort ()
	Force a resort next Sort call Reset the resort timer if used too.

bool	IsDescSortOrder () const
	Check if the sort order is descending. More...

void	ToggleSortOrder ()
	Toggle the sort order Since that is the worst condition for the sort function reverse the list here.

template<typename Comp >
bool	Sort (Comp compare)
	Sort the list. More...

void	SetSortFuncs (SortFunction const n_funcs)
	Hand the array of sort function pointers to the sort list. More...

bool	Sort ()
	Overload of #Sort(SortFunction *compare) Overloaded to reduce external code. More...

bool	IsFilterEnabled () const
	Check if the filter is enabled. More...

void	SetFilterState (bool state)
	Enable or disable the filter. More...

bool	Filter (FilterFunction *decide, F filter_data)
	Filter the list. More...

void	SetFilterFuncs (FilterFunction const n_funcs)
	Hand the array of filter function pointers to the sort list. More...

bool	Filter (F filter_data)
	Filter the data with the currently selected filter. More...

bool	NeedRebuild () const
	Check if a rebuild is needed. More...

void	ForceRebuild ()
	Force that a rebuild is needed.

void	RebuildDone ()
	Notify the sortlist that the rebuild is done. More...

Protected Types
using	SortParameterReference = std::conditional_t< std::is_same_v< P, std::nullptr_t >, P, P & >

Protected Member Functions
bool	IsSortable () const
	Check if the list is sortable. More...

void	ResetResortTimer ()
	Reset the resort timer.

Protected Attributes
SortFunction const	sort_func_list
	the sort criteria functions

FilterFunction const	filter_func_list
	the filter criteria functions

SortListFlags	flags
	used to control sorting/resorting/etc.

uint8_t	sort_type
	what criteria to sort on

uint8_t	filter_type
	what criteria to filter on

uint16_t	resort_timer
	resort list after a given amount of ticks if set

const SortParameterReference	params

Detailed Description

template<typename T, typename P = std::nullptr_t, typename F = const char*>
class GUIList< T, P, F >

List template of 'things' T to sort in a GUI.

Template Parameters

T	Type of data stored in the list to represent each item.
P	Tyoe of data passed as additional parameter to the sort function.
F	Type of data fed as additional value to the filter function.

See also: FilterFunction

Definition at line 47 of file sortlist_type.h.

Member Function Documentation

◆ Filter() [1/2]

template<typename T , typename P = std::nullptr_t, typename F = const char*>

bool GUIList< T, P, F >::Filter ( F filter_data )

inline

Filter the data with the currently selected filter.

Parameters

filter_data Additional data passed to the filter function.

Returns: true if the list has been altered by filtering

Definition at line 377 of file sortlist_type.h.

◆ Filter() [2/2]

template<typename T , typename P = std::nullptr_t, typename F = const char*>

bool GUIList< T, P, F >::Filter	(	FilterFunction *	decide,
		F	filter_data
	)

inline

Filter the list.

Parameters

decide	The function to decide about an item
filter_data	Additional data passed to the filter function

Returns: true if the list has been altered by filtering

Definition at line 343 of file sortlist_type.h.

Referenced by BuildObjectWindow::BuildObjectClassesAvailable(), IndustryDirectoryWindow::BuildSortIndustriesList(), BuildRailStationWindow::BuildStationClassesAvailable(), NetworkContentListWindow::FilterContentList(), BuildVehicleWindow::FilterEngineList(), SignList::FilterSignList(), and BaseVehicleListWindow::FilterVehicleList().

◆ FilterType()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

uint8_t GUIList< T, P, F >::FilterType ( ) const

inline

Get the filtertype of the list.

Returns: The current filtertype

Definition at line 166 of file sortlist_type.h.

◆ GetFiltering()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

Filtering GUIList< T, P, F >::GetFiltering ( ) const

inline

Export current filter conditions.

Returns: the current filter conditions

Definition at line 188 of file sortlist_type.h.

Referenced by NetworkContentListWindow::UpdateFilterState().

◆ GetListing()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

Listing GUIList< T, P, F >::GetListing ( ) const

inline

Export current sort conditions.

Returns: the current sort conditions

Definition at line 137 of file sortlist_type.h.

◆ IsDescSortOrder()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

bool GUIList< T, P, F >::IsDescSortOrder ( ) const

inline

Check if the sort order is descending.

Returns: true if the sort order is descending

Definition at line 244 of file sortlist_type.h.

Referenced by NetworkContentListWindow::OnPaint().

◆ IsFilterEnabled()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

bool GUIList< T, P, F >::IsFilterEnabled ( ) const

inline

Check if the filter is enabled.

Returns: true if the filter is enabled

Definition at line 317 of file sortlist_type.h.

◆ IsSortable()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

bool GUIList< T, P, F >::IsSortable ( ) const

inlineprotected

Check if the list is sortable.

Returns: true if we can sort the list

Definition at line 70 of file sortlist_type.h.

Referenced by GUIList< BuildBridgeData >::Sort(), and GUIList< BuildBridgeData >::ToggleSortOrder().

◆ NeedRebuild()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

bool GUIList< T, P, F >::NeedRebuild ( ) const

inline

Check if a rebuild is needed.

Returns: true if a rebuild is needed

Definition at line 387 of file sortlist_type.h.

Referenced by PerformanceLeagueWindow::BuildCompanyList(), NetworkContentListWindow::BuildContentList(), VehicleGroupWindow::BuildGroupList(), NetworkGameWindow::BuildGUINetworkGameList(), BuildObjectWindow::BuildObjectClassesAvailable(), IndustryDirectoryWindow::BuildSortIndustriesList(), BuildRailStationWindow::BuildStationClassesAvailable(), CompanyStationsWindow::BuildStationsList(), StoryBookWindow::BuildStoryPageElementList(), StoryBookWindow::BuildStoryPageList(), NetworkContentListWindow::OnInvalidateData(), SignListWindow::OnPaint(), NetworkGameWindow::OnPaint(), NetworkContentListWindow::OnPaint(), TownDirectoryWindow::OnPaint(), and IndustryDirectoryWindow::OnPaint().

◆ NeedResort()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

bool GUIList< T, P, F >::NeedResort ( )

inline

Check if a resort is needed next loop If used the resort timer will decrease every call till 0.

If 0 reached the resort bit will be set and the timer will be reset.

Returns: true if resort bit is set for next loop

Definition at line 220 of file sortlist_type.h.

Referenced by PerformanceLeagueWindow::OnGameTick(), CompanyStationsWindow::OnGameTick(), VehicleGroupWindow::OnGameTick(), VehicleListWindow::OnGameTick(), NetworkGameWindow::OnPaint(), and SignWindow::PrevNextSign().

◆ RebuildDone()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

void GUIList< T, P, F >::RebuildDone ( )

inline

Notify the sortlist that the rebuild is done.

Note: This forces a resort

Definition at line 405 of file sortlist_type.h.

Referenced by PerformanceLeagueWindow::BuildCompanyList(), NetworkContentListWindow::BuildContentList(), VehicleGroupWindow::BuildGroupList(), BuildObjectWindow::BuildObjectClassesAvailable(), IndustryDirectoryWindow::BuildSortIndustriesList(), BuildRailStationWindow::BuildStationClassesAvailable(), CompanyStationsWindow::BuildStationsList(), StoryBookWindow::BuildStoryPageElementList(), StoryBookWindow::BuildStoryPageList(), and ReplaceVehicleWindow::GenerateLists().

◆ SetFilterFuncs()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

void GUIList< T, P, F >::SetFilterFuncs ( FilterFunction *const * n_funcs )

inline

Hand the array of filter function pointers to the sort list.

Parameters

n_funcs The pointer to the first filter func

Definition at line 366 of file sortlist_type.h.

Referenced by NetworkContentListWindow::NetworkContentListWindow(), BaseVehicleListWindow::SetCargoFilterArray(), BuildVehicleWindow::SetCargoFilterArray(), and IndustryDirectoryWindow::SetCargoFilterArray().

◆ SetFiltering()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

void GUIList< T, P, F >::SetFiltering ( Filtering f )

inline

Import filter conditions.

Parameters

f	The filter conditions we want to use

Definition at line 202 of file sortlist_type.h.

Referenced by NetworkContentListWindow::NetworkContentListWindow().

◆ SetFilterState()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

void GUIList< T, P, F >::SetFilterState ( bool state )

inline

Enable or disable the filter.

Parameters

state If filtering should be enabled or disabled

Definition at line 327 of file sortlist_type.h.

Referenced by IndustryDirectoryWindow::SetAcceptedCargoFilter(), BaseVehicleListWindow::SetCargoFilter(), BaseVehicleListWindow::SetCargoFilterArray(), IndustryDirectoryWindow::SetProducedCargoFilter(), and NetworkContentListWindow::UpdateFilterState().

◆ SetFilterType()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

void GUIList< T, P, F >::SetFilterType ( uint8_t n_type )

inline

Set the filtertype of the list.

Parameters

n_type the new filter type

Definition at line 176 of file sortlist_type.h.

Referenced by NetworkContentListWindow::FilterContentList(), IndustryDirectoryWindow::SetAcceptedCargoFilter(), BaseVehicleListWindow::SetCargoFilter(), and IndustryDirectoryWindow::SetProducedCargoFilter().

◆ SetListing()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

void GUIList< T, P, F >::SetListing ( Listing l )

inline

Import sort conditions.

Parameters

l	The sort conditions we want to use

Definition at line 151 of file sortlist_type.h.

Referenced by NetworkContentListWindow::NetworkContentListWindow().

◆ SetSortFuncs()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

void GUIList< T, P, F >::SetSortFuncs ( SortFunction *const * n_funcs )

inline

Hand the array of sort function pointers to the sort list.

Parameters

n_funcs The pointer to the first sort func

Definition at line 295 of file sortlist_type.h.

Referenced by NetworkContentListWindow::NetworkContentListWindow().

◆ SetSortType()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

void GUIList< T, P, F >::SetSortType ( uint8_t n_type )

inline

Set the sorttype of the list.

Parameters

n_type the new sort type

Definition at line 124 of file sortlist_type.h.

◆ Sort() [1/2]

template<typename T , typename P = std::nullptr_t, typename F = const char*>

bool GUIList< T, P, F >::Sort ( )

inline

Overload of #Sort(SortFunction *compare) Overloaded to reduce external code.

Returns: true if the list sequence has been altered

Definition at line 306 of file sortlist_type.h.

Referenced by GUIList< BuildBridgeData >::Sort().

◆ Sort() [2/2]

template<typename T , typename P = std::nullptr_t, typename F = const char*>

template<typename Comp >

bool GUIList< T, P, F >::Sort ( Comp compare )

inline

Sort the list.

Parameters

compare The function to compare two list items

Returns: true if the list sequence has been altered

Definition at line 268 of file sortlist_type.h.

Referenced by VehicleGroupWindow::BuildGroupList(), BuildObjectWindow::BuildObjectClassesAvailable(), IndustryDirectoryWindow::BuildSortIndustriesList(), BuildRailStationWindow::BuildStationClassesAvailable(), StoryBookWindow::BuildStoryPageElementList(), StoryBookWindow::BuildStoryPageList(), PerformanceLeagueWindow::OnPaint(), BuildBridgeWindow::SortBridgeList(), NetworkContentListWindow::SortContentList(), NetworkGameWindow::SortNetworkGameList(), and CompanyStationsWindow::SortStationsList().

◆ SortType()

template<typename T , typename P = std::nullptr_t, typename F = const char*>

uint8_t GUIList< T, P, F >::SortType ( ) const

inline

Get the sorttype of the list.

Returns: The current sorttype

Definition at line 114 of file sortlist_type.h.

Referenced by NetworkContentListWindow::OnPaint(), and BuildBridgeWindow::SortBridgeList().

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

src/sortlist_type.h

Public Types

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Detailed Description

template<typename T, typename P = std::nullptr_t, typename F = const char*> class GUIList< T, P, F >

Member Function Documentation

◆ Filter() [1/2]

◆ Filter() [2/2]

◆ FilterType()

◆ GetFiltering()

◆ GetListing()

◆ IsDescSortOrder()

◆ IsFilterEnabled()

◆ IsSortable()

◆ NeedRebuild()

◆ NeedResort()

◆ RebuildDone()

◆ SetFilterFuncs()

◆ SetFiltering()

◆ SetFilterState()

◆ SetFilterType()

◆ SetListing()

◆ SetSortFuncs()

◆ SetSortType()

◆ Sort() [1/2]

◆ Sort() [2/2]

◆ SortType()

template<typename T, typename P = std::nullptr_t, typename F = const char*>
class GUIList< T, P, F >