Class for PickerClassWindow to collect information and retain state. More...

#include <picker_gui.h>

Inheritance diagram for PickerCallbacks:

Public Member Functions
	PickerCallbacks (const std::string &ini_group)

virtual void	Close (int)

virtual GrfSpecFeature	GetFeature () const =0

virtual bool	IsActive () const =0
	Should picker class/type selection be enabled?

virtual bool	HasClassChoice () const =0
	Are there multiple classes to chose from?

virtual StringID	GetClassTooltip () const =0
	Get the tooltip string for the class list.

virtual int	GetClassCount () const =0
	Get the number of classes.

virtual int	GetSelectedClass () const =0
	Get the index of the selected class.

virtual void	SetSelectedClass (int id) const =0
	Set the selected class.

virtual StringID	GetClassName (int id) const =0
	Get the name of a class.

virtual StringID	GetTypeTooltip () const =0
	Get the tooltip string for the type grid.

virtual int	GetTypeCount (int cls_id) const =0
	Get the number of types in a class.

virtual int	GetSelectedType () const =0
	Get the selected type.

virtual void	SetSelectedType (int id) const =0
	Set the selected type.

virtual PickerItem	GetPickerItem (int cls_id, int id) const =0
	Get data about an item.

virtual StringID	GetTypeName (int cls_id, int id) const =0
	Get the item of a type.

virtual std::span< const BadgeID >	GetTypeBadges (int cls_id, int id) const =0
	Get the item of a type.

virtual bool	IsTypeAvailable (int cls_id, int id) const =0
	Test if an item is currently buildable.

virtual void	DrawType (int x, int y, int cls_id, int id) const =0
	Draw preview image of an item.

virtual StringID	GetCollectionTooltip () const =0
	Get the tooltip string for the collection list.

virtual void	FillUsedItems (std::set< PickerItem > &items)=0
	Fill a set with all items that are used by the current player.

virtual std::map< std::string, std::set< PickerItem > >	UpdateSavedItems (const std::map< std::string, std::set< PickerItem > > &src)=0
	Update link between grfid/localidx and class_index/index in saved items.

std::set< std::string >	InitializeInactiveCollections (const std::map< std::string, std::set< PickerItem > > collections)
	Initialize the list of active collections for sorting purposes.

Data Fields
Listing	class_last_sorting = { false, 0 }
	Default sorting of PickerClassList.

Filtering	class_last_filtering = { false, 0 }
	Default filtering of PickerClassList.

Listing	type_last_sorting = { false, 0 }
	Default sorting of PickerTypeList.

Filtering	type_last_filtering = { false, 0 }
	Default filtering of PickerTypeList.

Listing	collection_last_sorting = { false, 0 }
	Default sorting of PickerCollectionList.

const std::string	ini_group
	Ini Group for saving favourites.

uint8_t	mode = 0
	Bitmask of `PickerFilterModes`.

bool	rename_collection = false
	Are we renaming a collection?

std::string	sel_collection
	Currently selected collection of saved items.

std::string	edit_collection
	Collection to rename or delete.

std::set< std::string >	rm_collections
	Set of removed or renamed collections for updating ini file.

int	preview_height = 0
	Previously adjusted height.

std::set< PickerItem >	used
	Set of items used in the current game by the current company.

std::map< std::string, std::set< PickerItem > >	saved
	Set of saved collections of items.

Detailed Description

Class for PickerClassWindow to collect information and retain state.

Definition at line 39 of file picker_gui.h.

Constructor & Destructor Documentation

◆ PickerCallbacks()

PickerCallbacks::PickerCallbacks ( const std::string & ini_group )

explicit

Definition at line 50 of file picker_gui.cpp.

◆ ~PickerCallbacks()

PickerCallbacks::~PickerCallbacks ( )

virtual

Definition at line 55 of file picker_gui.cpp.

Member Function Documentation

◆ Close()

virtual void PickerCallbacks::Close ( int )

inlinevirtual

Definition at line 44 of file picker_gui.h.

◆ DrawType()

virtual void PickerCallbacks::DrawType	(	int	x,
		int	y,
		int	cls_id,
		int	id
	)		const

pure virtual

Draw preview image of an item.

Implemented in ObjectPickerCallbacks, StationPickerCallbacks, WaypointPickerCallbacks, RoadStopPickerCallbacks< roadstoptype >, RoadWaypointPickerCallbacks, and HousePickerCallbacks.

Referenced by PickerWindow::DrawWidget().

◆ FillUsedItems()

virtual void PickerCallbacks::FillUsedItems ( std::set< PickerItem > & items )

pure virtual

Fill a set with all items that are used by the current player.

Implemented in ObjectPickerCallbacks, StationPickerCallbacks, WaypointPickerCallbacks, RoadStopPickerCallbacks< roadstoptype >, RoadWaypointPickerCallbacks, and HousePickerCallbacks.

◆ GetClassCount()

virtual int PickerCallbacks::GetClassCount ( ) const

pure virtual

Get the number of classes.

Note: Used only to estimate space requirements.

Implemented in PickerCallbacksNewGRFClass< T >, PickerCallbacksNewGRFClass< ObjectClass >, PickerCallbacksNewGRFClass< RoadStopClass >, PickerCallbacksNewGRFClass< StationClass >, and HousePickerCallbacks.

Referenced by PickerWindow::BuildPickerClassList(), and PickerWindow::BuildPickerTypeList().

◆ GetClassName()

virtual StringID PickerCallbacks::GetClassName ( int id ) const

pure virtual

Get the name of a class.

Implemented in ObjectPickerCallbacks, StationPickerCallbacks, WaypointPickerCallbacks, RoadStopPickerCallbacks< roadstoptype >, RoadWaypointPickerCallbacks, and HousePickerCallbacks.

Referenced by PickerWindow::BuildPickerClassList(), ClassTagNameFilter(), and PickerWindow::DrawWidget().

◆ GetClassTooltip()

virtual StringID PickerCallbacks::GetClassTooltip ( ) const

pure virtual

Get the tooltip string for the class list.

Implemented in RoadStopPickerCallbacks< roadstoptype >, RoadStopPickerCallbacks< roadstoptype >, ObjectPickerCallbacks, StationPickerCallbacks, WaypointPickerCallbacks, RoadStopPickerCallbacks< roadstoptype >, RoadWaypointPickerCallbacks, and HousePickerCallbacks.

◆ GetCollectionTooltip()

virtual StringID PickerCallbacks::GetCollectionTooltip ( ) const

pure virtual

Get the tooltip string for the collection list.

Implemented in RoadStopPickerCallbacks< roadstoptype >, RoadStopPickerCallbacks< roadstoptype >, ObjectPickerCallbacks, StationPickerCallbacks, WaypointPickerCallbacks, RoadStopPickerCallbacks< roadstoptype >, RoadWaypointPickerCallbacks, and HousePickerCallbacks.

◆ GetPickerItem()

virtual PickerItem PickerCallbacks::GetPickerItem	(	int	cls_id,
		int	id
	)		const

pure virtual

Get data about an item.

Implemented in PickerCallbacksNewGRFClass< T >, PickerCallbacksNewGRFClass< ObjectClass >, PickerCallbacksNewGRFClass< RoadStopClass >, PickerCallbacksNewGRFClass< StationClass >, and HousePickerCallbacks.

Referenced by PickerWindow::BuildPickerTypeList().

◆ GetSelectedClass()

virtual int PickerCallbacks::GetSelectedClass ( ) const

pure virtual

Get the index of the selected class.

Implemented in ObjectPickerCallbacks, StationPickerCallbacks, WaypointPickerCallbacks, RoadStopPickerCallbacks< roadstoptype >, RoadWaypointPickerCallbacks, and HousePickerCallbacks.

Referenced by PickerWindow::BuildPickerTypeList(), PickerWindow::DrawWidget(), and PickerWindow::OnClick().

◆ GetSelectedType()

virtual int PickerCallbacks::GetSelectedType ( ) const

pure virtual

Get the selected type.

Implemented in ObjectPickerCallbacks, StationPickerCallbacks, WaypointPickerCallbacks, RoadStopPickerCallbacks< roadstoptype >, RoadWaypointPickerCallbacks, and HousePickerCallbacks.

◆ GetTypeBadges()

virtual std::span< const BadgeID > PickerCallbacks::GetTypeBadges	(	int	cls_id,
		int	id
	)		const

pure virtual

Get the item of a type.

Implemented in ObjectPickerCallbacks, StationPickerCallbacks, WaypointPickerCallbacks, RoadStopPickerCallbacks< roadstoptype >, RoadWaypointPickerCallbacks, and HousePickerCallbacks.

Referenced by PickerWindow::DrawWidget(), and TypeTagNameFilter().

◆ GetTypeCount()

virtual int PickerCallbacks::GetTypeCount ( int cls_id ) const

pure virtual

Get the number of types in a class.

Note: Used only to estimate space requirements.

Implemented in PickerCallbacksNewGRFClass< T >, PickerCallbacksNewGRFClass< ObjectClass >, PickerCallbacksNewGRFClass< RoadStopClass >, PickerCallbacksNewGRFClass< StationClass >, and HousePickerCallbacks.

Referenced by PickerWindow::BuildPickerTypeList().

◆ GetTypeName()

virtual StringID PickerCallbacks::GetTypeName	(	int	cls_id,
		int	id
	)		const

pure virtual

Get the item of a type.

Implemented in ObjectPickerCallbacks, StationPickerCallbacks, WaypointPickerCallbacks, RoadStopPickerCallbacks< roadstoptype >, RoadWaypointPickerCallbacks, and HousePickerCallbacks.

Referenced by PickerWindow::BuildPickerTypeList(), PickerWindow::DrawWidget(), InitializeInactiveCollections(), and TypeTagNameFilter().

◆ GetTypeTooltip()

virtual StringID PickerCallbacks::GetTypeTooltip ( ) const

pure virtual

Get the tooltip string for the type grid.

Implemented in RoadStopPickerCallbacks< roadstoptype >, RoadStopPickerCallbacks< roadstoptype >, ObjectPickerCallbacks, StationPickerCallbacks, WaypointPickerCallbacks, RoadStopPickerCallbacks< roadstoptype >, RoadWaypointPickerCallbacks, and HousePickerCallbacks.

◆ HasClassChoice()

virtual bool PickerCallbacks::HasClassChoice ( ) const

pure virtual

Are there multiple classes to chose from?

Implemented in PickerCallbacksNewGRFClass< T >, PickerCallbacksNewGRFClass< ObjectClass >, PickerCallbacksNewGRFClass< RoadStopClass >, PickerCallbacksNewGRFClass< StationClass >, StationPickerCallbacks, WaypointPickerCallbacks, RoadStopPickerCallbacks< roadstoptype >, RoadWaypointPickerCallbacks, and HousePickerCallbacks.

◆ InitializeInactiveCollections()

std::set< std::string > PickerCallbacks::InitializeInactiveCollections ( const std::map< std::string, std::set< PickerItem > > collections )

inline

Initialize the list of active collections for sorting purposes.

Parameters

collections The map of collections to check.

Returns: The set of collections with inactive items.

Definition at line 97 of file picker_gui.h.

References GetTypeName(), and INVALID_STRING_ID.

◆ IsActive()

virtual bool PickerCallbacks::IsActive ( ) const

pure virtual

Should picker class/type selection be enabled?

Implemented in ObjectPickerCallbacks, StationPickerCallbacks, WaypointPickerCallbacks, RoadStopPickerCallbacks< roadstoptype >, RoadWaypointPickerCallbacks, and HousePickerCallbacks.

◆ IsTypeAvailable()

virtual bool PickerCallbacks::IsTypeAvailable	(	int	cls_id,
		int	id
	)		const

pure virtual

Test if an item is currently buildable.

Implemented in ObjectPickerCallbacks, StationPickerCallbacks, WaypointPickerCallbacks, RoadStopPickerCallbacks< roadstoptype >, RoadWaypointPickerCallbacks, and HousePickerCallbacks.

Referenced by PickerWindow::DrawWidget(), and PickerWindow::OnClick().

◆ SetSelectedClass()

virtual void PickerCallbacks::SetSelectedClass ( int id ) const

pure virtual

Set the selected class.

Implemented in HousePickerCallbacks, ObjectPickerCallbacks, StationPickerCallbacks, WaypointPickerCallbacks, RoadStopPickerCallbacks< roadstoptype >, and RoadWaypointPickerCallbacks.

Referenced by PickerWindow::OnClick().

◆ SetSelectedType()

virtual void PickerCallbacks::SetSelectedType ( int id ) const

pure virtual

Set the selected type.

Implemented in ObjectPickerCallbacks, StationPickerCallbacks, WaypointPickerCallbacks, RoadStopPickerCallbacks< roadstoptype >, RoadWaypointPickerCallbacks, and HousePickerCallbacks.

Referenced by PickerWindow::OnClick().

◆ UpdateSavedItems()

virtual std::map< std::string, std::set< PickerItem > > PickerCallbacks::UpdateSavedItems ( const std::map< std::string, std::set< PickerItem > > & src )

pure virtual

Update link between grfid/localidx and class_index/index in saved items.

Implemented in PickerCallbacksNewGRFClass< T >, PickerCallbacksNewGRFClass< ObjectClass >, PickerCallbacksNewGRFClass< RoadStopClass >, PickerCallbacksNewGRFClass< StationClass >, and HousePickerCallbacks.

Field Documentation

◆ class_last_filtering

Filtering PickerCallbacks::class_last_filtering = { false, 0 }

Default filtering of PickerClassList.

Definition at line 118 of file picker_gui.h.

◆ class_last_sorting

Listing PickerCallbacks::class_last_sorting = { false, 0 }

Default sorting of PickerClassList.

Definition at line 117 of file picker_gui.h.

◆ collection_last_sorting

Listing PickerCallbacks::collection_last_sorting = { false, 0 }

Default sorting of PickerCollectionList.

Definition at line 123 of file picker_gui.h.

◆ edit_collection

std::string PickerCallbacks::edit_collection

Collection to rename or delete.

Definition at line 129 of file picker_gui.h.

Referenced by PickerWindow::OnClick(), and PickerWindow::OnQueryTextFinished().

◆ ini_group

const std::string PickerCallbacks::ini_group

Ini Group for saving favourites.

Definition at line 125 of file picker_gui.h.

Referenced by PickerLoadConfig(), and PickerSaveConfig().

◆ mode

uint8_t PickerCallbacks::mode = 0

Bitmask of PickerFilterModes.

Definition at line 126 of file picker_gui.h.

Referenced by PickerWindow::BuildPickerClassList(), PickerWindow::BuildPickerTypeList(), PickerWindow::OnClick(), and PickerWindow::OnInvalidateData().

◆ preview_height

int PickerCallbacks::preview_height = 0

Previously adjusted height.

Definition at line 132 of file picker_gui.h.

Referenced by PickerWindow::OnClick().

◆ rename_collection

bool PickerCallbacks::rename_collection = false

Are we renaming a collection?

Definition at line 127 of file picker_gui.h.

Referenced by PickerWindow::OnClick().

◆ rm_collections

std::set<std::string> PickerCallbacks::rm_collections

Set of removed or renamed collections for updating ini file.

Definition at line 130 of file picker_gui.h.

Referenced by PickerWindow::OnQueryTextFinished(), and PickerSaveConfig().

◆ saved

std::map<std::string, std::set<PickerItem> > PickerCallbacks::saved

Set of saved collections of items.

Definition at line 135 of file picker_gui.h.

Referenced by PickerWindow::BuildPickerClassList(), PickerWindow::BuildPickerCollectionList(), PickerWindow::BuildPickerTypeList(), PickerWindow::DrawWidget(), PickerWindow::OnClick(), PickerWindow::OnQueryTextFinished(), PickerLoadConfig(), and PickerSaveConfig().

◆ sel_collection

std::string PickerCallbacks::sel_collection

Currently selected collection of saved items.

Definition at line 128 of file picker_gui.h.

Referenced by PickerWindow::BuildPickerTypeList(), PickerWindow::GetWidgetString(), PickerWindow::OnClick(), PickerWindow::OnDropdownSelect(), and PickerWindow::OnQueryTextFinished().

◆ type_last_filtering

Filtering PickerCallbacks::type_last_filtering = { false, 0 }

Default filtering of PickerTypeList.

Definition at line 121 of file picker_gui.h.

◆ type_last_sorting

Listing PickerCallbacks::type_last_sorting = { false, 0 }

Default sorting of PickerTypeList.

Definition at line 120 of file picker_gui.h.

◆ used

std::set<PickerItem> PickerCallbacks::used

Set of items used in the current game by the current company.

Definition at line 134 of file picker_gui.h.

Referenced by PickerWindow::BuildPickerClassList(), PickerWindow::BuildPickerTypeList(), and PickerWindow::DrawWidget().

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

src/picker_gui.h
src/picker_gui.cpp

Public Member Functions

Data Fields

Detailed Description

Constructor & Destructor Documentation

◆ PickerCallbacks()

◆ ~PickerCallbacks()

Member Function Documentation

◆ Close()

◆ DrawType()

◆ FillUsedItems()

◆ GetClassCount()

◆ GetClassName()

◆ GetClassTooltip()

◆ GetCollectionTooltip()

◆ GetPickerItem()

◆ GetSelectedClass()

◆ GetSelectedType()

◆ GetTypeBadges()

◆ GetTypeCount()

◆ GetTypeName()

◆ GetTypeTooltip()

◆ HasClassChoice()

◆ InitializeInactiveCollections()

◆ IsActive()

◆ IsTypeAvailable()

◆ SetSelectedClass()

◆ SetSelectedType()

◆ UpdateSavedItems()

Field Documentation

◆ class_last_filtering

◆ class_last_sorting

◆ collection_last_sorting

◆ edit_collection

◆ ini_group

◆ mode

◆ preview_height

◆ rename_collection

◆ rm_collections

◆ saved

◆ sel_collection

◆ type_last_filtering

◆ type_last_sorting

◆ used