The Battle for Wesnoth  1.13.4+dev
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes | List of all members
help::help_browser Class Reference

A help browser widget. More...

#include <help_browser.hpp>

Inheritance diagram for help::help_browser:
Inheritance graph

Public Member Functions

 help_browser (CVideo &video, const section &toplevel)
 
void adjust_layout ()
 
void show_topic (const std::string &topic_id)
 Display the topic with the specified identifier. More...
 
- Public Member Functions inherited from gui::widget
SDL_Rect const & location () const
 
virtual void set_location (SDL_Rect const &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 set_volatile (bool val=true)
 
void set_dirty (bool dirty=true)
 
bool dirty () const
 
const std::string & id () const
 
void set_id (const std::string &id)
 
void set_help_string (const std::string &str)
 
void set_tooltip_string (const std::string &str)
 
virtual void process_help_string (int mousex, int mousey)
 
virtual void process_tooltip_string (int mousex, int mousey)
 
- Public Member Functions inherited from events::sdl_handler
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 ()
 

Protected Member Functions

virtual void update_location (SDL_Rect const &rect)
 
virtual void process_event ()
 
virtual void handle_event (const SDL_Event &event)
 
- Protected Member Functions inherited from gui::widget
 widget (widget const &o)
 
 widget (CVideo &video, const bool auto_join=true)
 
virtual ~widget ()
 
void bg_register (SDL_Rect const &rect)
 
void bg_restore () const
 
void bg_restore (SDL_Rect const &rect) const
 
void bg_update ()
 
void bg_cancel ()
 
CVideo & video () const
 
virtual void draw ()
 
virtual void draw_contents ()
 
const SDL_Rect * clip_rect () const
 
virtual sdl_handler_vector member_handlers ()
 
virtual void handle_window_event (SDL_Event const &event)
 
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)
 
virtual ~sdl_handler ()
 
virtual std::vector
< sdl_handler * > 		handler_members ()
 

Private Member Functions

void update_cursor ()
 Update the current cursor, set it to the reference cursor if mousex, mousey is over a cross-reference, otherwise, set it to the normal cursor. More...
 
void show_topic (const topic &t, bool save_in_history=true)
 
void move_in_history (std::deque< const topic * > &from, std::deque< const topic * > &to)
 Move in the topic history. More...
 

Private Attributes

help_menu menu_
 
help_text_area text_area_
 
const section & toplevel_
 
bool ref_cursor_
 
std::deque< const topic * > back_topics_
 
std::deque< const topic * > forward_topics_
 
gui::button back_button_
 
gui::button forward_button_
 
topic const * shown_topic_
 

Additional Inherited Members

- Protected Attributes inherited from gui::widget
bool focus_
 

Detailed Description

A help browser widget.

Definition at line 31 of file help_browser.hpp.

Constructor & Destructor Documentation

help::help_browser::help_browser ( CVideo &  video,
const section &  toplevel 
)

Definition at line 33 of file help_browser.cpp.

References back_button_, forward_button_, gui::widget::hide(), font::relative_size(), and gui::widget::set_measurements().

Member Function Documentation

void help::help_browser::adjust_layout ( )

Definition at line 54 of file help_browser.cpp.

References back_button_, forward_button_, gui::widget::height(), gui::widget::location(), menu_, font::relative_size(), gui::widget::set_dirty(), gui::widget::set_height(), gui::widget::set_location(), gui::menu::set_max_height(), gui::menu::set_max_width(), gui::widget::set_width(), text_area_, and gui::widget::width().

Referenced by update_location().

void help::help_browser::handle_event ( const SDL_Event &  event)
protectedvirtual

Reimplemented from gui::widget.

Definition at line 137 of file help_browser.cpp.

References _(), help::find_topic(), gui::widget::handle_event(), game_logic::msg(), help::help_text_area::ref_at(), show_topic(), gui2::show_transient_message(), text_area_, toplevel_, update_cursor(), and gui::widget::video().

void help::help_browser::move_in_history ( std::deque< const topic * > &  from,
std::deque< const topic * > &  to 
)
private

Move in the topic history.

Pop an element from from and insert it in to. Pop at the fronts if the maximum number of elements is exceeded.

Definition at line 120 of file help_browser.cpp.

References help::max_history, show_topic(), and shown_topic_.

Referenced by process_event().

void help::help_browser::process_event ( )
protectedvirtual

Fake focus functionality for the menu, only process it if it has focus.

A new topic has been chosen in the menu, display it.

Reimplemented from events::sdl_handler.

Definition at line 95 of file help_browser.cpp.

References back_button_, back_topics_, help::help_menu::chosen_topic(), forward_button_, forward_topics_, gui::widget::hide(), gui::widget::location(), menu_, move_in_history(), sdl::point_in_rect(), gui::button::pressed(), help::help_menu::process(), show_topic(), and shown_topic_.

void help::help_browser::show_topic ( const std::string &  topic_id)

Display the topic with the specified identifier.

Open the menu on the right location and display the topic in the text area.

Definition at line 183 of file help_browser.cpp.

References help::find_topic(), help::hidden_symbol(), toplevel_, help::unit_prefix, and help::unknown_unit_topic.

Referenced by handle_event(), move_in_history(), process_event(), and help::show_help().

void help::help_browser::show_topic ( const topic &  t,
bool  save_in_history = true 
)
private

Definition at line 197 of file help_browser.cpp.

References back_topics_, forward_topics_, log_scope, help::max_history, menu_, help::help_menu::select_topic(), help::help_text_area::show_topic(), shown_topic_, text_area_, and update_cursor().

void help::help_browser::update_cursor ( )
private

Update the current cursor, set it to the reference cursor if mousex, mousey is over a cross-reference, otherwise, set it to the normal cursor.

Definition at line 168 of file help_browser.cpp.

References cursor::HYPERLINK, cursor::NORMAL, help::help_text_area::ref_at(), ref_cursor_, cursor::set(), and text_area_.

Referenced by handle_event(), and show_topic().

void help::help_browser::update_location ( SDL_Rect const &  rect)
protectedvirtual

Reimplemented from gui::widget.

Definition at line 90 of file help_browser.cpp.

References adjust_layout().

Member Data Documentation

gui::button help::help_browser::back_button_
private

Definition at line 62 of file help_browser.hpp.

Referenced by adjust_layout(), help_browser(), and process_event().

std::deque<const topic *> help::help_browser::back_topics_
private

Definition at line 61 of file help_browser.hpp.

Referenced by process_event(), and show_topic().

gui::button help::help_browser::forward_button_
private

Definition at line 62 of file help_browser.hpp.

Referenced by adjust_layout(), help_browser(), and process_event().

std::deque<const topic *> help::help_browser::forward_topics_
private

Definition at line 61 of file help_browser.hpp.

Referenced by process_event(), and show_topic().

help_menu help::help_browser::menu_
private

Definition at line 57 of file help_browser.hpp.

Referenced by adjust_layout(), process_event(), and show_topic().

bool help::help_browser::ref_cursor_
private

Definition at line 60 of file help_browser.hpp.

Referenced by update_cursor().

topic const* help::help_browser::shown_topic_
private

Definition at line 63 of file help_browser.hpp.

Referenced by move_in_history(), process_event(), and show_topic().

help_text_area help::help_browser::text_area_
private

Definition at line 58 of file help_browser.hpp.

Referenced by adjust_layout(), handle_event(), show_topic(), and update_cursor().

const section& help::help_browser::toplevel_
private

Definition at line 59 of file help_browser.hpp.

Referenced by handle_event(), and show_topic().

The documentation for this class was generated from the following files:
Generated by   doxygen 1.8.8