The Battle for Wesnoth  1.19.5+dev
Public Member Functions | List of all members
editor::common_palette Class Referenceabstract

#include <common_palette.hpp>

Inheritance diagram for editor::common_palette:

Public Member Functions

 common_palette ()
 
virtual ~common_palette ()
 
virtual sdl_handler_vector handler_members ()
 
virtual bool scroll_up ()=0
 Scroll the editor-palette up one step if possible. More...
 
virtual bool can_scroll_up ()=0
 
virtual bool scroll_down ()=0
 Scroll the editor-palette down one step if possible. More...
 
virtual bool can_scroll_down ()=0
 
virtual void adjust_size (const SDL_Rect &target)=0
 
virtual void set_group (std::size_t index)=0
 
virtual void next_group ()=0
 
virtual void prev_group ()=0
 
virtual const std::vector< item_group > & get_groups () const =0
 
virtual void expand_palette_groups_menu (std::vector< config > &items, int i)=0
 Menu expanding for palette group list. More...
 
virtual std::size_t num_items ()=0
 
virtual std::size_t start_num ()=0
 
virtual void set_start_item (std::size_t index)=0
 
virtual bool supports_swap ()
 Whether the hotkey system should the enable GUI button connected to swap(). More...
 
virtual void swap ()=0
 For tools which support fg and bg items, exchange the two items. More...
 
virtual std::vector< std::string > action_pressed () const
 
- Public Member Functions inherited from gui::widget
const rectlocation () const
 
virtual void set_location (const SDL_Rect &rect)
 
void set_location (int x, int y)
 
void set_width (int w)
 
void set_height (int h)
 
void set_measurements (int w, int h)
 
int width () const
 
int height () const
 
bool focus (const SDL_Event *event)
 
void set_focus (bool focus)
 
virtual void hide (bool value=true)
 
bool hidden () const
 
virtual void enable (bool new_val=true)
 
bool enabled () const
 
void set_clip_rect (const SDL_Rect &rect)
 
void queue_redraw ()
 Indicate that the widget should be redrawn. More...
 
void queue_redraw (const rect &)
 Indicate that a specific region of the screen should be redrawn. More...
 
void set_dirty (bool dirty=true)
 
bool dirty () const
 
const std::string & id () const
 
void set_id (const std::string &id)
 
void set_tooltip_string (const std::string &str)
 
virtual void process_tooltip_string (int mousex, int mousey) override
 
virtual void layout () override
 Called by draw_manager to validate layout. More...
 
virtual bool expose (const rect &region) override
 Called by draw_manager when it believes a redraw is necessary. More...
 
virtual rect screen_location () override
 The current draw location of the display, on the screen. More...
 
- Public Member Functions inherited from events::sdl_handler
virtual void handle_window_event (const SDL_Event &)
 
virtual void process_event ()
 
virtual bool requires_event_focus (const SDL_Event *=nullptr) const
 
virtual void join ()
 
virtual void join (context &c)
 
virtual void join_same (sdl_handler *parent)
 
virtual void leave ()
 
virtual void join_global ()
 
virtual void leave_global ()
 
virtual bool has_joined ()
 
virtual bool has_joined_global ()
 
sdl_handleroperator= (sdl_handler &&)=delete
 Moving would require two instances' context membership to be handled, it's simpler to delete these and require the two instances to be separately constructed / destructed. More...
 
 sdl_handler (sdl_handler &&)=delete
 
- Public Member Functions inherited from gui2::top_level_drawable
virtual void update ()
 Update state and any parameters that may effect layout, or any of the later stages. More...
 
virtual void render ()
 Perform any internal rendering necessary to prepare the drawable. More...
 

Additional Inherited Members

- Protected Member Functions inherited from gui::widget
 widget (const bool auto_join=true)
 
virtual ~widget ()
 
virtual void draw_contents ()
 
virtual void update_location (const SDL_Rect &)
 
virtual void handle_event (const SDL_Event &) override
 
bool mouse_locked () const
 
void aquire_mouse_lock ()
 
void free_mouse_lock ()
 
- Protected Member Functions inherited from events::sdl_handler
 sdl_handler (const bool auto_join=true)
 
 sdl_handler (const sdl_handler &)
 
sdl_handleroperator= (const sdl_handler &)
 
virtual ~sdl_handler ()
 
- Protected Member Functions inherited from gui2::top_level_drawable
 top_level_drawable ()
 
virtual ~top_level_drawable ()
 
 top_level_drawable (const top_level_drawable &)
 
top_level_drawableoperator= (const top_level_drawable &)
 
 top_level_drawable (top_level_drawable &&)
 
top_level_drawableoperator= (top_level_drawable &&)
 
- Protected Attributes inherited from gui::widget
bool focus_
 

Detailed Description

Definition at line 45 of file common_palette.hpp.

Constructor & Destructor Documentation

◆ common_palette()

editor::common_palette::common_palette ( )
inline

Definition at line 49 of file common_palette.hpp.

◆ ~common_palette()

virtual editor::common_palette::~common_palette ( )
inlinevirtual

Definition at line 51 of file common_palette.hpp.

Member Function Documentation

◆ action_pressed()

virtual std::vector<std::string> editor::common_palette::action_pressed ( ) const
inlinevirtual

Reimplemented in editor::location_palette.

Definition at line 95 of file common_palette.hpp.

◆ adjust_size()

virtual void editor::common_palette::adjust_size ( const SDL_Rect &  target)
pure virtual

◆ can_scroll_down()

virtual bool editor::common_palette::can_scroll_down ( )
pure virtual

◆ can_scroll_up()

virtual bool editor::common_palette::can_scroll_up ( )
pure virtual

◆ expand_palette_groups_menu()

virtual void editor::common_palette::expand_palette_groups_menu ( std::vector< config > &  items,
int  i 
)
pure virtual

◆ get_groups()

virtual const std::vector<item_group>& editor::common_palette::get_groups ( ) const
pure virtual

◆ handler_members()

virtual sdl_handler_vector editor::common_palette::handler_members ( )
inlinevirtual

◆ next_group()

virtual void editor::common_palette::next_group ( )
pure virtual

◆ num_items()

virtual std::size_t editor::common_palette::num_items ( )
pure virtual

◆ prev_group()

virtual void editor::common_palette::prev_group ( )
pure virtual

◆ scroll_down()

virtual bool editor::common_palette::scroll_down ( )
pure virtual

◆ scroll_up()

virtual bool editor::common_palette::scroll_up ( )
pure virtual

◆ set_group()

virtual void editor::common_palette::set_group ( std::size_t  index)
pure virtual

◆ set_start_item()

virtual void editor::common_palette::set_start_item ( std::size_t  index)
pure virtual

◆ start_num()

virtual std::size_t editor::common_palette::start_num ( )
pure virtual

◆ supports_swap()

virtual bool editor::common_palette::supports_swap ( )
inlinevirtual

Whether the hotkey system should the enable GUI button connected to swap().

Reimplemented in editor::unit_palette, editor::location_palette, and editor::empty_palette.

Definition at line 84 of file common_palette.hpp.

◆ swap()

virtual void editor::common_palette::swap ( )
pure virtual

For tools which support fg and bg items, exchange the two items.

Typically, fg and bg mean that they're placed by left or right mouse clicks, respectively.

There's a mismatch between class structure and responsibilities here, as part of the UX isn't part of the palette. The tool decides what right-click does. Even for the scenery item tool, where right-click deletes an item, fg and bg provide a way to switch between two items.

Implemented in editor::location_palette, editor::empty_palette, editor::editor_palette< Item >, editor::editor_palette< t_translation::terrain_code >, editor::editor_palette< const unit_type & >, and editor::editor_palette< overlay >.


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