#include <mouse_handler_base.hpp>
Public Member Functions | |
mouse_handler_base () | |
virtual | ~mouse_handler_base () |
virtual display & | gui ()=0 |
Reference to the used display objects. More... | |
virtual const display & | gui () const =0 |
Const version of gui. More... | |
bool | dragging_started () const |
If mouse/finger has moved far enough to consider it move/swipe, and not a click/touch. More... | |
bool | is_dragging () const |
virtual int | drag_threshold () const |
Minimum dragging distance to fire the drag&drop. More... | |
void | mouse_motion_event (const SDL_MouseMotionEvent &event, const bool browse) |
void | touch_motion_event (const SDL_TouchFingerEvent &event, const bool browse) |
void | mouse_update (const bool browse, map_location loc) |
Update the mouse with a fake mouse motion. More... | |
bool | get_show_menu () const |
bool | mouse_motion_default (int x, int y, bool update) |
This handles minimap scrolling and click-drag. More... | |
virtual void | mouse_motion (int x, int y, const bool browse, bool update=false, map_location new_loc=map_location::null_location())=0 |
Called when a mouse motion event takes place. More... | |
virtual void | touch_motion (int x, int y, const bool browse, bool update=false, map_location new_loc=map_location::null_location())=0 |
virtual void | mouse_press (const SDL_MouseButtonEvent &event, const bool browse) |
bool | is_left_click (const SDL_MouseButtonEvent &event) const |
bool | is_middle_click (const SDL_MouseButtonEvent &event) const |
bool | is_right_click (const SDL_MouseButtonEvent &event) const |
bool | is_touch_click (const SDL_MouseButtonEvent &event) const |
virtual void | mouse_wheel (int xscroll, int yscroll, bool browse) |
Called when scrolling with the mouse wheel. More... | |
virtual bool | allow_mouse_wheel_scroll (int, int) |
Derived classes can override this to disable mousewheel scrolling under some circumstances, e.g. More... | |
virtual bool | left_click (int x, int y, const bool browse) |
Overridden in derived classes, called on a left click (mousedown). More... | |
virtual void | move_action (bool) |
Overridden in derived class. More... | |
virtual void | touch_action (const map_location hex, bool browse) |
virtual void | left_drag_end (int, int, const bool) |
Called whenever the left mouse drag has "ended". More... | |
virtual void | left_mouse_up (int, int, const bool) |
Called when the left mouse button is up. More... | |
virtual bool | right_click (int x, int y, const bool browse) |
Overridden in derived classes, called on a right click (mousedown). More... | |
virtual bool | right_click_show_menu (int, int, const bool) |
Called in the default right_click when the context menu is about to be shown, can be used for preprocessing and preventing the menu from being displayed without rewriting the right click function. More... | |
virtual void | right_drag_end (int, int, const bool) |
Called whenever the right mouse drag has "ended". More... | |
virtual void | right_mouse_up (int, int, const bool) |
Called when the right mouse button is up. More... | |
virtual void | mouse_wheel_up (int, int, const bool) |
Called when the mouse wheel is scrolled up. More... | |
virtual void | mouse_wheel_down (int, int, const bool) |
Called when the mouse wheel is scrolled down. More... | |
virtual void | mouse_wheel_left (int, int, const bool) |
Called when the mouse wheel is scrolled left. More... | |
virtual void | mouse_wheel_right (int, int, const bool) |
Called when the mouse wheel is scrolled right. More... | |
void | set_scroll_start (int x, int y) |
Called when the middle click scrolling. More... | |
const SDL_Point | get_scroll_start () const |
bool | scroll_started () const |
Protected Member Functions | |
void | cancel_dragging () |
void | clear_dragging (const SDL_MouseButtonEvent &event, bool browse) |
void | init_dragging (bool &dragging_flag) |
Protected Attributes | |
bool | simple_warp_ |
MMB click (on game map) state flag. More... | |
bool | minimap_scrolling_ |
minimap scrolling (scroll-drag) state flag More... | |
bool | dragging_left_ |
LMB drag init flag. More... | |
bool | dragging_touch_ |
Finger drag init flag. More... | |
bool | dragging_started_ |
Actual drag flag. More... | |
bool | dragging_right_ |
RMB drag init flag. More... | |
int | drag_from_x_ |
Drag start position x. More... | |
int | drag_from_y_ |
Drag start position y. More... | |
map_location | drag_from_hex_ |
Drag start map location. More... | |
map_location | last_hex_ |
last highlighted hex More... | |
bool | show_menu_ |
Show context menu flag. More... | |
int | scroll_start_x_ |
Relative to middle click scrolling. More... | |
int | scroll_start_y_ |
bool | scroll_started_ |
Definition at line 35 of file mouse_handler_base.hpp.
events::mouse_handler_base::mouse_handler_base | ( | ) |
Definition at line 53 of file mouse_handler_base.cpp.
|
inlinevirtual |
Definition at line 40 of file mouse_handler_base.hpp.
|
inlinevirtual |
Derived classes can override this to disable mousewheel scrolling under some circumstances, e.g.
when the mouse wheel controls something else, but the event is also received by this class
Reimplemented in editor::editor_controller.
Definition at line 112 of file mouse_handler_base.hpp.
|
protected |
Definition at line 372 of file mouse_handler_base.cpp.
References dragging_left_, dragging_right_, dragging_started_, dragging_touch_, and cursor::set_dragging().
Referenced by mouse_press().
|
protected |
Definition at line 381 of file mouse_handler_base.cpp.
References dragging_left_, dragging_right_, dragging_started_, dragging_touch_, left_drag_end(), right_drag_end(), and cursor::set_dragging().
Referenced by mouse_press().
|
inlinevirtual |
Minimum dragging distance to fire the drag&drop.
Reimplemented in events::mouse_handler.
Definition at line 62 of file mouse_handler_base.hpp.
Referenced by controller_base::long_touch_callback(), and mouse_motion_default().
bool events::mouse_handler_base::dragging_started | ( | ) | const |
If mouse/finger has moved far enough to consider it move/swipe, and not a click/touch.
Definition at line 71 of file mouse_handler_base.cpp.
References dragging_started_.
|
inline |
Definition at line 206 of file mouse_handler_base.hpp.
Referenced by controller_base::handle_scroll().
|
inline |
Definition at line 74 of file mouse_handler_base.hpp.
References map_location::null_location(), and draw_manager::update().
Referenced by controller_base::handle_event().
|
pure virtual |
Reference to the used display objects.
Derived classes should ensure this is always valid. Note the constructor of this class cannot use this.
Implemented in editor::editor_controller, and events::mouse_handler.
Referenced by init_dragging(), left_click(), controller_base::long_touch_callback(), mouse_motion_default(), mouse_press(), mouse_wheel(), and right_mouse_up().
|
pure virtual |
Const version of gui.
Implemented in editor::editor_controller, and events::mouse_handler.
|
protected |
Definition at line 365 of file mouse_handler_base.cpp.
References drag_from_hex_, drag_from_x_, drag_from_y_, sdl::get_mouse_state(), gui(), and display::hex_clicked_on().
Referenced by mouse_press().
bool events::mouse_handler_base::is_dragging | ( | ) | const |
Definition at line 76 of file mouse_handler_base.cpp.
References dragging_left_, dragging_right_, and dragging_touch_.
Referenced by editor::editor_controller::mouse_motion(), mouse_motion_default(), and events::mouse_handler::touch_motion().
bool events::mouse_handler_base::is_left_click | ( | const SDL_MouseButtonEvent & | event | ) | const |
Definition at line 250 of file mouse_handler_base.cpp.
References events::command_active().
Referenced by mouse_press().
bool events::mouse_handler_base::is_middle_click | ( | const SDL_MouseButtonEvent & | event | ) | const |
Definition at line 263 of file mouse_handler_base.cpp.
Referenced by mouse_press().
bool events::mouse_handler_base::is_right_click | ( | const SDL_MouseButtonEvent & | event | ) | const |
Definition at line 268 of file mouse_handler_base.cpp.
References events::command_active().
Referenced by mouse_press().
bool events::mouse_handler_base::is_touch_click | ( | const SDL_MouseButtonEvent & | event | ) | const |
Definition at line 282 of file mouse_handler_base.cpp.
Referenced by mouse_press().
|
virtual |
Overridden in derived classes, called on a left click (mousedown).
Defaults to process (initiate) minimap scrolling.
Reimplemented in editor::editor_controller.
Definition at line 287 of file mouse_handler_base.cpp.
References gui(), last_hex_, display::minimap_location_on(), minimap_scrolling_, display::scroll_to_tile(), map_location::valid(), and display::WARP.
Referenced by mouse_press().
|
virtual |
Called whenever the left mouse drag has "ended".
Reimplemented in editor::editor_controller.
Definition at line 310 of file mouse_handler_base.cpp.
References move_action().
Referenced by clear_dragging().
|
inlinevirtual |
Called when the left mouse button is up.
Reimplemented in editor::editor_controller.
Definition at line 139 of file mouse_handler_base.hpp.
Referenced by mouse_press().
|
pure virtual |
Called when a mouse motion event takes place.
Derived classes must provide an implementation, possibly using mouse_motion_default().
Implemented in editor::editor_controller, and events::mouse_handler.
Referenced by mouse_motion_event(), and mouse_update().
bool events::mouse_handler_base::mouse_motion_default | ( | int | x, |
int | y, | ||
bool | update | ||
) |
This handles minimap scrolling and click-drag.
Definition at line 100 of file mouse_handler_base.cpp.
References drag_from_x_, drag_from_y_, drag_threshold(), dragging_left_, dragging_right_, dragging_started_, sdl::get_mouse_button_mask(), sdl::get_mouse_state(), gui(), is_dragging(), last_hex_, display::minimap_location_on(), minimap_scrolling_, tooltips::process(), display::scroll_to_tile(), cursor::set_dragging(), simple_warp_, map_location::valid(), and display::WARP.
Referenced by events::mouse_handler::mouse_motion().
void events::mouse_handler_base::mouse_motion_event | ( | const SDL_MouseMotionEvent & | event, |
const bool | browse | ||
) |
Definition at line 81 of file mouse_handler_base.cpp.
References mouse_motion().
Referenced by controller_base::handle_event().
|
virtual |
Definition at line 161 of file mouse_handler_base.cpp.
References cancel_dragging(), clear_dragging(), dragging_left_, dragging_right_, dragging_started_, dragging_touch_, gui(), display::hex_clicked_on(), display::highlight_hex(), init_dragging(), is_left_click(), is_middle_click(), is_right_click(), is_touch_click(), last_hex_, left_click(), left_mouse_up(), preferences::middle_click_scrolls(), display::minimap_location_on(), minimap_scrolling_, mouse_update(), right_click(), right_mouse_up(), scroll_started_, display::scroll_to_tile(), cursor::set_dragging(), set_scroll_start(), show_menu_, simple_warp_, map_location::valid(), and display::WARP.
Referenced by controller_base::handle_event(), play_controller::hotkey_handler::left_mouse_click(), and play_controller::hotkey_handler::right_mouse_click().
void events::mouse_handler_base::mouse_update | ( | const bool | browse, |
map_location | loc | ||
) |
Update the mouse with a fake mouse motion.
Definition at line 93 of file mouse_handler_base.cpp.
References sdl::get_mouse_state(), and mouse_motion().
Referenced by mouse_press(), and controller_base::play_slice().
|
virtual |
Called when scrolling with the mouse wheel.
Definition at line 315 of file mouse_handler_base.cpp.
References utils::contains(), sdl::get_mouse_state(), gui(), mouse_wheel_down(), mouse_wheel_left(), mouse_wheel_right(), mouse_wheel_up(), display::scroll(), and preferences::scroll_speed().
Referenced by controller_base::handle_event().
|
inlinevirtual |
Called when the mouse wheel is scrolled down.
Definition at line 185 of file mouse_handler_base.hpp.
Referenced by mouse_wheel().
|
inlinevirtual |
Called when the mouse wheel is scrolled left.
Definition at line 190 of file mouse_handler_base.hpp.
Referenced by mouse_wheel().
|
inlinevirtual |
Called when the mouse wheel is scrolled right.
Definition at line 195 of file mouse_handler_base.hpp.
Referenced by mouse_wheel().
|
inlinevirtual |
Called when the mouse wheel is scrolled up.
Definition at line 180 of file mouse_handler_base.hpp.
Referenced by mouse_wheel().
|
inlinevirtual |
Overridden in derived class.
Called on drag + drop movements.
Reimplemented in events::mouse_handler.
Definition at line 128 of file mouse_handler_base.hpp.
Referenced by left_drag_end().
|
inlinevirtual |
Overridden in derived classes, called on a right click (mousedown).
Defaults to displaying the menu (by setting the appropriate flag) if right_click_show_menu returns true.
Reimplemented in editor::editor_controller.
Definition at line 151 of file mouse_handler_base.hpp.
Referenced by mouse_press().
|
inlinevirtual |
Called in the default right_click when the context menu is about to be shown, can be used for preprocessing and preventing the menu from being displayed without rewriting the right click function.
Reimplemented in editor::editor_controller, and events::mouse_handler.
Definition at line 164 of file mouse_handler_base.hpp.
Referenced by right_mouse_up().
|
inlinevirtual |
Called whenever the right mouse drag has "ended".
Reimplemented in editor::editor_controller.
Definition at line 170 of file mouse_handler_base.hpp.
Referenced by clear_dragging().
|
virtual |
Called when the right mouse button is up.
Reimplemented in editor::editor_controller.
Definition at line 351 of file mouse_handler_base.cpp.
References theme::context_menu(), display::get_theme(), gui(), right_click_show_menu(), show_menu_, and WRN_DP.
Referenced by mouse_press().
|
inline |
Definition at line 211 of file mouse_handler_base.hpp.
Referenced by controller_base::handle_scroll().
|
inline |
Called when the middle click scrolling.
Definition at line 200 of file mouse_handler_base.hpp.
Referenced by controller_base::handle_scroll(), and mouse_press().
|
virtual |
Reimplemented in events::mouse_handler.
Definition at line 306 of file mouse_handler_base.cpp.
|
pure virtual |
Implemented in editor::editor_controller, and events::mouse_handler.
Referenced by touch_motion_event().
void events::mouse_handler_base::touch_motion_event | ( | const SDL_TouchFingerEvent & | event, |
const bool | browse | ||
) |
Definition at line 86 of file mouse_handler_base.cpp.
References touch_motion().
Referenced by controller_base::handle_event().
|
protected |
Drag start map location.
Definition at line 246 of file mouse_handler_base.hpp.
Referenced by init_dragging(), and editor::editor_controller::mouse_motion().
|
protected |
Drag start position x.
Definition at line 240 of file mouse_handler_base.hpp.
Referenced by init_dragging(), mouse_motion_default(), events::mouse_handler::select_or_action(), and events::mouse_handler::touch_motion().
|
protected |
Drag start position y.
Definition at line 243 of file mouse_handler_base.hpp.
Referenced by init_dragging(), mouse_motion_default(), events::mouse_handler::select_or_action(), and events::mouse_handler::touch_motion().
|
protected |
LMB drag init flag.
Definition at line 228 of file mouse_handler_base.hpp.
Referenced by cancel_dragging(), clear_dragging(), is_dragging(), editor::editor_controller::mouse_motion(), mouse_motion_default(), and mouse_press().
|
protected |
RMB drag init flag.
Definition at line 237 of file mouse_handler_base.hpp.
Referenced by cancel_dragging(), clear_dragging(), is_dragging(), editor::editor_controller::mouse_motion(), mouse_motion_default(), and mouse_press().
|
protected |
Actual drag flag.
Definition at line 234 of file mouse_handler_base.hpp.
Referenced by cancel_dragging(), clear_dragging(), dragging_started(), events::mouse_handler::mouse_motion(), mouse_motion_default(), mouse_press(), and events::mouse_handler::touch_motion().
|
protected |
Finger drag init flag.
Definition at line 231 of file mouse_handler_base.hpp.
Referenced by cancel_dragging(), clear_dragging(), is_dragging(), mouse_press(), and events::mouse_handler::touch_motion().
|
protected |
last highlighted hex
Definition at line 249 of file mouse_handler_base.hpp.
Referenced by events::mouse_handler::get_last_hex(), left_click(), events::mouse_handler::mouse_motion(), mouse_motion_default(), mouse_press(), events::mouse_handler::move_action(), events::mouse_handler::select_hex(), events::mouse_handler::select_or_action(), events::mouse_handler::selected_unit(), and events::mouse_handler::touch_motion().
|
protected |
minimap scrolling (scroll-drag) state flag
Definition at line 225 of file mouse_handler_base.hpp.
Referenced by left_click(), mouse_motion_default(), mouse_press(), and events::mouse_handler::touch_motion().
|
protected |
Relative to middle click scrolling.
Definition at line 255 of file mouse_handler_base.hpp.
|
protected |
Definition at line 256 of file mouse_handler_base.hpp.
|
protected |
Definition at line 257 of file mouse_handler_base.hpp.
Referenced by events::mouse_handler::mouse_motion(), and mouse_press().
|
protected |
Show context menu flag.
Definition at line 252 of file mouse_handler_base.hpp.
Referenced by mouse_press(), and right_mouse_up().
|
protected |
MMB click (on game map) state flag.
Definition at line 222 of file mouse_handler_base.hpp.
Referenced by mouse_motion_default(), mouse_press(), and events::mouse_handler::touch_motion().