libt3widget
 All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator Friends Groups
List of all members | Classes | Public Member Functions | Friends
t3_widget::menu_bar_t Class Reference

Class implementing a menu bar. More...

Inheritance diagram for t3_widget::menu_bar_t:
t3_widget::widget_t t3_widget::window_component_t t3_widget::mouse_target_t t3_widget::window_component_t

Classes

struct  implementation_t

Public Member Functions

virtual bool accepts_focus (void)
 Query whether this widget accepts focus.
void add_menu (menu_panel_t *menu)
 Add a menu to the menu bar.
virtual void hide (void)
virtual bool is_hotkey (key_t key)
 Query whether key is a hotkey for this widget.
 menu_bar_t (bool _hidden=false)
 Create a new menu_bar_t.
virtual bool process_key (key_t key)
virtual bool process_mouse_event (mouse_event_t event)
 Process a mouse event.
void remove_menu (menu_panel_t *menu)
 Remove a menu from the menu bar.
virtual void set_focus (focus_t focus)
void set_hidden (bool _hidden)
 Set the "hidden" display property.
virtual bool set_size (optint height, optint width)
virtual void show (void)
 T3_WIDGET_SIGNAL (activate, void, int)
 Signal emitted when a menu item is selected.
virtual void update_contents (void)
virtual ~menu_bar_t (void)
 Destroy the menu_bar_t.
- Public Member Functions inherited from t3_widget::widget_t
virtual void force_redraw (void)
virtual bool is_enabled (void)
 Query the enabled status of this widget.
virtual bool is_shown (void)
 Query the visibility status of this widget.
virtual void set_anchor (window_component_t *anchor, int relation)
 Set this widget's anchor.
virtual void set_enabled (bool enable)
 Set the enabled status of this widget.
virtual void set_position (optint top, optint left)
- Public Member Functions inherited from t3_widget::window_component_t
virtual void force_redraw (void)=0
 Request that this window_component_t be completely redrawn.
virtual t3_window_t * get_base_window (void)
 Retrieve the t3_window_t for this window_component_t.
virtual void hide (void)=0
 Hide the window_component_t.
virtual bool process_key (key_t key)=0
 Handle a key press by the user.
virtual void set_focus (focus_t focus)=0
 Set whether this window_component_t has the input focus.
virtual void set_position (optint top, optint left)=0
 Move the window_component_t to a specified position.
virtual bool set_size (optint height, optint width)=0
 Set the size of this window_component_t.
virtual void show (void)=0
 Display the window_component_t.
virtual void update_contents (void)=0
 Update the contents of the window.
 window_component_t (void)
 Base constructor.
virtual ~window_component_t (void)
 Base destructor.
- Public Member Functions inherited from t3_widget::mouse_target_t
void grab_mouse (void)
 Grab all future mouse events.
void register_mouse_target (t3_window_t *target)
 Register a window to receive mouse events.
void release_mouse_grab (void)
 Release a previous mouse grab.
void unregister_mouse_target (t3_window_t *target)
 Unregister a window to receive mouse events.

Friends

class menu_panel_t

Additional Inherited Members

- Public Types inherited from t3_widget::window_component_t
enum  focus_t {
  FOCUS_OUT, FOCUS_SET, FOCUS_IN_FWD, FOCUS_IN_BCK,
  FOCUS_REVERT
}
- Static Public Member Functions inherited from t3_widget::mouse_target_t
static bool handle_mouse_event (mouse_event_t event)
- Protected Member Functions inherited from t3_widget::widget_t
void init_unbacked_window (int height, int width, bool register_as_mouse_target=false)
 Initialize the window with an unbacked t3_window_t with height and width.
void init_window (int height, int width, bool register_as_mouse_target=true)
 Initialize the window with a t3_window_t with height and width.
 widget_t (int height, int width, bool register_as_mouse_target=true)
 Constructor which creates a default t3_window_t with height and width.
 widget_t (void)
 Constructor which does not create a default t3_window_t.
- Protected Attributes inherited from t3_widget::widget_t
bool enabled
 Widget is enabled.
bool redraw
 Widget requires redrawing on next update_contents call.
bool shown
 Widget is shown.

Detailed Description

Class implementing a menu bar.

Constructor & Destructor Documentation

t3_widget::menu_bar_t::menu_bar_t ( bool  _hidden = false)

Create a new menu_bar_t.

Parameters
_hiddenBoolean indicating whether this menu_bar_t has "hidden" display type.

A menu_bar_t can either be displayed continuously, or it can be hidden while none of its menus are active. The latter option should only be used when the user specifically asks for it, otherwise the user may not even be aware of the menu bar's existance.

t3_widget::menu_bar_t::~menu_bar_t ( void  )
virtual

Destroy the menu_bar_t.

Note that this does destroys the menus contained by this menu_bar_t.

Member Function Documentation

bool t3_widget::menu_bar_t::accepts_focus ( void  )
virtual

Query whether this widget accepts focus.

Reimplemented from t3_widget::widget_t.

void t3_widget::menu_bar_t::add_menu ( menu_panel_t menu)

Add a menu to the menu bar.

Note that this will be called automatically if the menu_bar_t is passed to the menu_panel_t constructor.

bool t3_widget::menu_bar_t::is_hotkey ( key_t  key)
virtual

Query whether key is a hotkey for this widget.

Reimplemented from t3_widget::widget_t.

bool t3_widget::menu_bar_t::process_mouse_event ( mouse_event_t  event)
virtual

Process a mouse event.

Returns
A boolean indicating whether this mouse_target_t handled the mouse event.

Reimplemented from t3_widget::widget_t.

void t3_widget::menu_bar_t::remove_menu ( menu_panel_t menu)

Remove a menu from the menu bar.

This does not destroy the menu.

void t3_widget::menu_bar_t::set_hidden ( bool  _hidden)

Set the "hidden" display property.

See #memu_bar_t for details.

t3_widget::menu_bar_t::T3_WIDGET_SIGNAL ( activate  ,
void  ,
int   
)

Signal emitted when a menu item is selected.

The integer passed as the first argument is determined when creating the menu item through menu_panel_t::add_item.