GFC Logo GFC Title Logo
Reference Manual
Main Page  |  Namespace List  |  Alphabetical List  |  Class List  |  File List

GFC::Gtk::MenuShell Class Reference

A GtkMenuShell C++ wrapper class. More...

#include <gfc/gtk/menushell.hh>

Inheritance diagram for GFC::Gtk::MenuShell:

GFC::Gtk::Container GFC::Gtk::Widget GFC::Gtk::Object GFC::Atk::Implementor GFC::G::Object GFC::G::TypeInterface GFC::G::TypeInstance GFC::G::TypeInstance GFC::Trackable GFC::Trackable GFC::Gtk::Menu GFC::Gtk::MenuBar List of all members.

Signal Prototypes

Public Member Functions

Constructors
Accessors
Methods
Signal Proxies

Protected Member Functions

Constructors

Detailed Description

A GtkMenuShell C++ wrapper class.

A MenuShell is the abstract base class used to derive the Menu and MenuBar subclasses. It is a container of MenuItem objects arranged in a list which can be navigated, selected, and activated by the user to perform application functions. A MenuItem can have a submenu associated with it, allowing for nested hierarchical menus.


Constructor & Destructor Documentation

GFC::Gtk::MenuShell::MenuShell GtkMenuShell *  menu_shell,
bool  owns_reference = false
[explicit, protected]
 

Construct a new MenuShell from an existing GtkMenuShell.

Parameters:
menu_shell A pointer to a GtkMenuShell.
owns_reference Set false if the initial reference count is floating, set true if it's not.

The menu_shell can be a newly created GtkMenuShell or an existing GtkMenuShell (see G::Object::Object).


Member Function Documentation

void GFC::Gtk::MenuShell::activate_item MenuItem item,
bool  force_deactivate
 

Activates the menu item within the menu shell.

Parameters:
item The menu item to activate.
force_deactivate If true, force the deactivation of the menu shell after the menu item is activated.

void GFC::Gtk::MenuShell::append const StockId stock_id,
const sigc::slot< void > &  callback
 

Adds a new stock menu item to the end of the menu shell's item list.

Parameters:
stock_id The stock ID of the menu item to append.
callback The callback slot to connect to the stock menu item's activate_signal.

void GFC::Gtk::MenuShell::append MenuItem item,
const AccelKey accel_key,
AccelGroup accel_group,
const sigc::slot< void > &  callback
 

Adds a new menu item to the end of the menu shell's item list.

Parameters:
item The menu item to add.
accel_key The accelerator key for the menu item.
accel_group The accelerator group to add the accelerator key to.
callback The callback slot to connect to item's activate_signal.

void GFC::Gtk::MenuShell::append MenuItem item,
const AccelKey accel_key,
const sigc::slot< void > &  callback
 

Adds a new menu item to the end of the menu shell's item list.

Parameters:
item The menu item to add.
accel_key The accelerator key for the menu item.
callback The callback slot to connect to item's activate_signal.

Calls Gtk::Menu::get_accel_group() to retrieve the accelerator group for the menu, and adds the accelerator key to this accelerator group.

void GFC::Gtk::MenuShell::append MenuItem item,
const sigc::slot< void > &  callback
 

Adds a new menu item to the end of the menu shell's item list.

Parameters:
item The menu item to add.
callback The callback slot to connect to item's activate_signal.

void GFC::Gtk::MenuShell::append MenuItem item  ) 
 

Adds a new menu item to the end of the menu shell's item list.

Parameters:
item The menu item to add.

bool GFC::Gtk::MenuShell::children std::vector< MenuItem * > &  child_list  )  const
 

Get the list of MenuItem objects contained by this MenuShell.

Parameters:
child_list A reference to a vector of MenuItem* to hold the child list.
Returns:
true if the child list is not empty, and false if it is empty.

void GFC::Gtk::MenuShell::deactivate  ) 
 

Deactivates the menu shell.

Typically this results in the menu shell being erased from the screen.

void GFC::Gtk::MenuShell::insert const StockId stock_id,
int  position,
const sigc::slot< void > &  callback
 

Adds a new stock menu item to the menu shell's item list at the position indicated by position.

Parameters:
stock_id The stock ID of the menu item to insert.
position The position in the item list where child is added (numbered from 0 to n-1).
callback The callback slot to connect to the stock menu item's activate_signal.

void GFC::Gtk::MenuShell::insert MenuItem item,
int  position,
const AccelKey accel_key,
AccelGroup accel_group,
const sigc::slot< void > &  callback
 

Adds a new menu item to the menu shell's item list at the position indicated by position.

Parameters:
item The menu item to add.
position The position in the item list where child is added (numbered from 0 to n-1).
accel_key The accelerator key for the menu item.
accel_group The accelerator group to add the accelerator key to.
callback The callback slot to connect to item's activate_signal.

void GFC::Gtk::MenuShell::insert MenuItem item,
int  position,
const AccelKey accel_key,
const sigc::slot< void > &  callback
 

Adds a new menu item to the menu shell's item list at the position indicated by position.

Parameters:
item The menu item to add.
position The position in the item list where child is added (numbered from 0 to n-1).
accel_key The accelerator key for the menu item.
callback The callback slot to connect to item's activate_signal.

Calls Gtk::Menu::get_accel_group() to retrieve the accelerator group for the menu, and adds the accelerator key to this accelerator group.

void GFC::Gtk::MenuShell::insert MenuItem item,
int  position,
const sigc::slot< void > &  callback
 

Adds a new menu item to the menu shell's item list at the position indicated by position.

Parameters:
item The menu item to add.
position The position in the item list where child is added (numbered from 0 to n-1).
callback The callback slot to connect to item's activate_signal.

void GFC::Gtk::MenuShell::insert MenuItem item,
int  position
 

Adds a new menu item to the menu shell's item list at the position indicated by position.

Parameters:
item The menu item to add.
position The position in the item list where child is added (numbered from 0 to n-1).

void GFC::Gtk::MenuShell::prepend const StockId stock_id,
const sigc::slot< void > &  callback
 

Adds a new stock menu item to the beginning of the menu shell's item list.

Parameters:
stock_id The stock ID of the menu item to prepend.
callback The callback slot to connect to the stock menu item's activate_signal.

void GFC::Gtk::MenuShell::prepend MenuItem item,
const AccelKey accel_key,
AccelGroup accel_group,
const sigc::slot< void > &  callback
 

Adds a new menu item to the beginning of the menu shell's item list.

Parameters:
item The menu item to add.
accel_key The accelerator key for the menu item.
accel_group The accelerator group to add the accelerator key to.
callback The callback slot to connect to item's activate_signal.

void GFC::Gtk::MenuShell::prepend MenuItem item,
const AccelKey accel_key,
const sigc::slot< void > &  callback
 

Adds a new menu item to the beginning of the menu shell's item list.

Parameters:
item The menu item to add.
accel_key The accelerator key for the menu item.
callback The callback slot to connect to item's activate_signal.

Calls Gtk::Menu::get_accel_group() to retrieve the accelerator group for the menu, and adds the accelerator key to this accelerator group.

void GFC::Gtk::MenuShell::prepend MenuItem item,
const sigc::slot< void > &  callback
 

Adds a new menu item to the beginning of the menu shell's item list.

Parameters:
item The menu item to add.
callback The callback slot to connect to item's activate_signal.

void GFC::Gtk::MenuShell::prepend MenuItem item  ) 
 

Adds a new menu item to the beginning of the menu shell's item list.

Parameters:
item The menu item to add.

void GFC::Gtk::MenuShell::select_first bool  search_sensitive  ) 
 

Select the first visible or selectable child of the menu shell; don't select tearoff items unless the only item is a tearoff item.

Parameters:
search_sensitive If true, search for the first selectable menu item, otherwise select nothing if the first item isn't sensitive.

search_sensitive should be false if the menu is being popped up initially.

void GFC::Gtk::MenuShell::select_item MenuItem item  ) 
 

Selects the menu item from the menu shell.

Parameters:
item The MenuItem to select.


Member Data Documentation

const DeactivateSignalType GFC::Gtk::MenuShell::deactivate_signal [static, protected]
 

Deactivate signal (see sig_deactivate()).

Calls a slot with the signature:

             void function();

const SelectionDoneSignalType GFC::Gtk::MenuShell::selection_done_signal [static, protected]
 

Selection done signal (see sig_selection_done()).

Calls a slot with the signature:

             void function();


The documentation for this class was generated from the following file:
Generated on Tue Aug 24 00:34:40 2004 for GFC-UI by doxygen 1.3.8