Google

logo top
Main Page   Widgets   Namespaces   Book  

Gtk::MenuItem Class Reference
[WidgetsMenu classes]

Child item for menus. More...

Inheritance diagram for Gtk::MenuItem:

Inheritance graph
[legend]
List of all members.

Public Methods

virtual ~MenuItem ()
GtkMenuItem* gobj ()
const GtkMenuItem* gobj () const
 MenuItem ()
 Create an empty menu item.

 MenuItem (Widget& widget)
 Create a menu item with widget.

 MenuItem (const Glib::ustring& label, bool mnemonic=false)
 Create a menu item with label.

void set_submenu (Menu& submenu)
Menuget_submenu ()
 Gets the submenu underneath this menu item, if any.

const Menuget_submenu () const
 Gets the submenu underneath this menu item, if any.

bool has_submenu () const
void remove_submenu ()
void select ()
void deselect ()
void activate ()
 For widgets that can be "activated" (buttons, menu items, etc.) this function activates them.

void toggle_size_request (int& requisition)
void toggle_size_allocate (int allocation)
void set_right_justified (bool right_justified=true)
 Sets whether the menu item appears justified at the right side of a menu bar.

bool get_right_justified () const
 Gets whether the menu item appears justified at the right side of the menu bar.

void set_accel_path (const Glib::ustring& accel_path)
 Set the accelerator path on menu_item , through which runtime changes of the menu item's accelerator caused by the user can be identified and saved to persistant storage (see gtk_accel_map_save() on this).

Glib::SignalProxy0<void> signal_activate ()
Glib::SignalProxy0<void> signal_activate_item ()
Glib::SignalProxy1< void,
int* > 
signal_toggle_size_request ()
Glib::SignalProxy1< void,
int > 
signal_toggle_size_allocate ()
void accelerate (Window& window)

Protected Methods

virtual void on_activate ()
virtual void on_activate_item ()
virtual void on_toggle_size_request (int* requisition)
virtual void on_toggle_size_allocate (int allocation)
void add_accel_label (const Glib::ustring& label, bool mnemonic=true)
void set_accel_key (const Menu_Helpers::AccelKey& accel_key)

Friends

class Menu_Helpers::Element

Related Functions

(Note that these are not member functions.)

Gtk::MenuItem* wrap (GtkMenuItem* object, bool take_copy=false)

Detailed Description

Child item for menus.

Handle highlighting, alignment, events and submenus. As it derives from Gtk::Bin it can hold any valid child widget, altough only a few are really useful.


Constructor & Destructor Documentation

virtual Gtk::MenuItem::~MenuItem (   [virtual]
 

Gtk::MenuItem::MenuItem (  
 

Create an empty menu item.

Gtk::MenuItem::MenuItem ( Widget   widget [explicit]
 

Create a menu item with widget.

Gtk::MenuItem::MenuItem ( const Glib::ustring   label,
bool    mnemonic = false
[explicit]
 

Create a menu item with label.


Member Function Documentation

void Gtk::MenuItem::accelerate ( Window   window
 

void Gtk::MenuItem::activate (  
 

For widgets that can be "activated" (buttons, menu items, etc.) this function activates them.

Activation is what happens when you press Enter on a widget during key navigation; clicking a button, selecting a menu item, etc. If widget isn't activatable, the function returns false.

Returns:
true if the widget was activatable.

Reimplemented from Gtk::Widget.

void Gtk::MenuItem::add_accel_label ( const Glib::ustring   label,
bool    mnemonic = true
[protected]
 

void Gtk::MenuItem::deselect (  
 

Reimplemented from Gtk::Item.

bool Gtk::MenuItem::get_right_justified (   const
 

Gets whether the menu item appears justified at the right side of the menu bar.

Returns:
true if the menu item will appear at the far right if added to a menu bar.

const Menu* Gtk::MenuItem::get_submenu (   const
 

Gets the submenu underneath this menu item, if any.

See set_submenu().

Returns:
Submenu for this menu item, or 0 if none.

Menu* Gtk::MenuItem::get_submenu (  
 

Gets the submenu underneath this menu item, if any.

See set_submenu().

Returns:
Submenu for this menu item, or 0 if none.

const GtkMenuItem* Gtk::MenuItem::gobj (   const [inline]
 

Reimplemented from Gtk::Item.

Reimplemented in Gtk::CheckMenuItem, Gtk::ImageMenuItem, Gtk::RadioMenuItem, Gtk::SeparatorMenuItem, and Gtk::TearoffMenuItem.

GtkMenuItem* Gtk::MenuItem::gobj (   [inline]
 

Reimplemented from Gtk::Item.

Reimplemented in Gtk::CheckMenuItem, Gtk::ImageMenuItem, Gtk::RadioMenuItem, Gtk::SeparatorMenuItem, and Gtk::TearoffMenuItem.

bool Gtk::MenuItem::has_submenu (   const
 

virtual void Gtk::MenuItem::on_activate (   [protected, virtual]
 

virtual void Gtk::MenuItem::on_activate_item (   [protected, virtual]
 

virtual void Gtk::MenuItem::on_toggle_size_allocate ( int    allocation [protected, virtual]
 

virtual void Gtk::MenuItem::on_toggle_size_request ( int*    requisition [protected, virtual]
 

void Gtk::MenuItem::remove_submenu (  
 

void Gtk::MenuItem::select (  
 

Reimplemented from Gtk::Item.

void Gtk::MenuItem::set_accel_key ( const Menu_Helpers::AccelKey   accel_key [protected]
 

void Gtk::MenuItem::set_accel_path ( const Glib::ustring   accel_path
 

Set the accelerator path on menu_item , through which runtime changes of the menu item's accelerator caused by the user can be identified and saved to persistant storage (see gtk_accel_map_save() on this).

To setup a default accelerator for this menu item, call gtk_accel_map_add_entry() with the same accel_path . See also gtk_accel_map_add_entry() on the specifics of accelerator paths, and set_accel_path() for a more convenient variant of this function.

This function is basically a convenience wrapper that handles calling Gtk::Widget::set_accel_path() with the appropriate accelerator group for the menu item.

Note that you do need to set an accelerator on the parent menu with set_accel_group() for this to work.

Parameters:
accel_path Accelerator path, corresponding to this menu item's functionality, or 0 to unset the current path.

void Gtk::MenuItem::set_right_justified ( bool    right_justified = true
 

Sets whether the menu item appears justified at the right side of a menu bar.

This was traditionally done for "Help" menu items, but is now considered a bad idea. (If the widget layout is reversed for a right-to-left language like Hebrew or Arabic, right-justified-menu-items appear at the left.)

Parameters:
right_justified If true the menu item will appear at the far right if added to a menu bar.

void Gtk::MenuItem::set_submenu ( Menu   submenu
 

Glib::SignalProxy0<void> Gtk::MenuItem::signal_activate (  
 

Prototype:
void activate()

Glib::SignalProxy0<void> Gtk::MenuItem::signal_activate_item (  
 

Prototype:
void activate_item()

Glib::SignalProxy1<void,int> Gtk::MenuItem::signal_toggle_size_allocate (  
 

Prototype:
void toggle_size_allocate(int allocation)

Glib::SignalProxy1<void,int*> Gtk::MenuItem::signal_toggle_size_request (  
 

Prototype:
void toggle_size_request(int* requisition)

void Gtk::MenuItem::toggle_size_allocate ( int    allocation
 

void Gtk::MenuItem::toggle_size_request ( int&    requisition
 


Friends And Related Function Documentation

friend class Menu_Helpers::Element [friend]
 

Gtk::MenuItem* wrap ( GtkMenuItem*    object,
bool    take_copy = false
[related]
 


The documentation for this class was generated from the following file:
Generated for gtkmm by Doxygen 1.3-rc1 © 1997-2001