~ubuntu-branches/ubuntu/karmic/gtkmm2.4/karmic

« back to all changes in this revision

Viewing changes to docs/reference/html/classGtk_1_1MenuShell.html

  • Committer: Bazaar Package Importer
  • Author(s): Robert Ancell
  • Date: 2009-09-22 10:14:59 UTC
  • mfrom: (1.2.42 upstream)
  • Revision ID: james.westby@ubuntu.com-20090922101459-pespb00fbm1mlqbd
Tags: 1:2.18.1-0ubuntu1
* New upstream release: (LP: #434355)
  - RecentManager: Undeprecate get_default().
  - Clipboard: wait_for_targets): Fix a crash.
  - Window: Added set_icon_name().
  - Require a recent pangomm.
  - Style: Fix a compiler error with the Intel C++ compiler.
  - Fix recently-introduced problems with disable-deprecated options.
* debian/control.in:
  - Bump libpangomm-1.4-dev depends and build-depends

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
 
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
2
<html xmlns="http://www.w3.org/1999/xhtml">
 
3
<head>
 
4
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
3
5
<title>gtkmm: Gtk::MenuShell Class Reference</title>
4
 
<link href="tabs.css" rel="stylesheet" type="text/css">
5
 
<link href="doxygen.css" rel="stylesheet" type="text/css">
6
 
</head><body>
7
 
<!-- Generated by Doxygen 1.5.8 -->
 
6
<link href="tabs.css" rel="stylesheet" type="text/css"/>
 
7
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
 
8
</head>
 
9
<body>
 
10
<!-- Generated by Doxygen 1.6.1 -->
8
11
<div class="navigation" id="top">
9
12
  <div class="tabs">
10
13
    <ul>
27
30
  </div>
28
31
</div>
29
32
<div class="contents">
30
 
<h1>Gtk::MenuShell Class Reference<br>
 
33
<h1>Gtk::MenuShell Class Reference<br/>
31
34
<small>
32
35
[<a class="el" href="group__Widgets.html">Widgets</a>,&#160;<a class="el" href="group__Containers.html">Container Widgets</a>,&#160;<a class="el" href="group__Menus.html">Menu classes</a>]</small>
33
 
</h1><!-- doxytag: class="Gtk::MenuShell" --><!-- doxytag: inherits="Gtk::Container" -->The abstract base class for <a class="el" href="classGtk_1_1Menu.html" title="A drop-down menu consisting of Gtk::MenuItem objects which can be navigated and activated...">Gtk::Menu</a> and <a class="el" href="classGtk_1_1MenuBar.html" title="A standard menu bar which usually holds Gtk::Menu submenu items.">Gtk::MenuBar</a>. <a href="#_details">More...</a>
34
 
<p>
35
 
Inherits <a class="el" href="classGtk_1_1Container.html">Gtk::Container</a>.
36
 
<p>
37
 
Inherited by <a class="el" href="classGtk_1_1Menu.html">Gtk::Menu</a>, and <a class="el" href="classGtk_1_1MenuBar.html">Gtk::MenuBar</a>.
38
 
<p>
 
36
</h1><!-- doxytag: class="Gtk::MenuShell" --><!-- doxytag: inherits="Gtk::Container" -->
 
37
<p>The abstract base class for <a class="el" href="classGtk_1_1Menu.html" title="A drop-down menu consisting of Gtk::MenuItem objects which can be navigated and activated...">Gtk::Menu</a> and <a class="el" href="classGtk_1_1MenuBar.html" title="A standard menu bar which usually holds Gtk::Menu submenu items.">Gtk::MenuBar</a>. <a href="#_details">More...</a></p>
 
38
 
 
39
<p>Inherits <a class="el" href="classGtk_1_1Container.html">Gtk::Container</a>.</p>
 
40
 
 
41
<p>Inherited by <a class="el" href="classGtk_1_1Menu.html">Gtk::Menu</a>, and <a class="el" href="classGtk_1_1MenuBar.html">Gtk::MenuBar</a>.</p>
39
42
<div class="dynheader">
40
43
Collaboration diagram for Gtk::MenuShell:</div>
41
44
<div class="dynsection">
42
 
<p><center><img src="classGtk_1_1MenuShell__coll__graph.png" border="0" usemap="#Gtk_1_1MenuShell__coll__map" alt="Collaboration graph"></center>
43
 
<map name="Gtk_1_1MenuShell__coll__map">
44
 
<area shape="rect" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="873,36,977,63"><area shape="rect" href="classGtk_1_1Bin.html" title="A container with just one child." alt="" coords="1827,69,1896,96"><area shape="rect" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)." alt="" coords="661,36,752,63"><area shape="rect" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non&#45;widget objects such..." alt="" coords="505,5,593,32"><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="340,5,431,32"><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="163,29,283,56"><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="333,56,437,83"><area shape="rect" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="5,29,112,56"><area shape="rect" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="489,56,609,83"><area shape="rect" href="classGtk_1_1Window.html" title="Toplevel Window This represents all widgets which are physical windows controlled..." alt="" coords="2332,80,2428,107"><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html" title="Glib::RefPtr\&lt; AccelGroup \&gt;" alt="" coords="1771,120,1952,147"><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html" title="Glib::RefPtr\&lt; T_CppObject \&gt;" alt="" coords="831,120,1020,147"><area shape="rect" href="classGtk_1_1Menu__Helpers_1_1MenuList.html" title="Gtk::Menu_Helpers::MenuList" alt="" coords="2283,153,2477,180"><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1HelperList.html" title="Glib::HelperList\&lt; MenuItem, const Element, Glib::List_Cpp_Iterator\&lt; GtkMenuItem, MenuItem \&gt; \&gt;" alt="" coords="1565,171,2157,197"><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1HelperList.html" title="Glib::HelperList\&lt; class, class, class \&gt;" alt="" coords="804,171,1047,197"></map>
45
 
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
46
 
 
47
 
<p>
48
 
<a href="classGtk_1_1MenuShell-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
49
 
<tr><td></td></tr>
50
 
<tr><td colspan="2"><br><h2>Public Types</h2></td></tr>
51
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef <a class="el" href="classGtk_1_1Menu__Helpers_1_1MenuList.html">Menu_Helpers::MenuList</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#8d79bb921d0a3ffca5e4c9d8f77648a2">MenuList</a></td></tr>
52
 
 
53
 
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
54
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#b7117e65877843c10ad7d5b705a770e7">~MenuShell</a> ()</td></tr>
55
 
 
56
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">GtkMenuShell*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#bb7c2641f9e3624f3225dcf76d8b994c">gobj</a> ()</td></tr>
57
 
 
58
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#bb7c2641f9e3624f3225dcf76d8b994c"></a><br></td></tr>
59
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">const GtkMenuShell*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#4417adfb6a301e40a0040517c43e69c7">gobj</a> () const </td></tr>
60
 
 
61
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#4417adfb6a301e40a0040517c43e69c7"></a><br></td></tr>
62
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#24d5b1a4a61941006e544a4f5a230917">append</a> (<a class="el" href="classGtk_1_1MenuItem.html">MenuItem</a>&amp; menu_item)</td></tr>
63
 
 
64
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#5aa0142b2f86f511ac5f98ce892d03bd">prepend</a> (<a class="el" href="classGtk_1_1MenuItem.html">MenuItem</a>&amp; menu_item)</td></tr>
65
 
 
66
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a3243bef17ebc3ed18b3885194e7d9a3">insert</a> (<a class="el" href="classGtk_1_1MenuItem.html">MenuItem</a>&amp; menu_item, int position)</td></tr>
67
 
 
68
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#c38fde346621b24154540f83243956fd">select_item</a> (<a class="el" href="classGtk_1_1MenuItem.html">MenuItem</a>&amp; menu_item)</td></tr>
69
 
 
70
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#b90ff16ed2fcba9aa3460569d45f1c1a">deselect</a> ()</td></tr>
71
 
 
72
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#6e5136fc61381ae6f2e529906066680a">activate_item</a> (<a class="el" href="classGtk_1_1MenuItem.html">MenuItem</a>&amp; menu_item, bool force_deactivate=false)</td></tr>
73
 
 
74
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#882dab72c89e462a879a6b6179464cc2">select_first</a> (bool search_sensitive=true)</td></tr>
75
 
 
76
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Select the first visible or selectable child of the menu shell; don't select tearoff items unless the only item is a tearoff item. <a href="#882dab72c89e462a879a6b6179464cc2"></a><br></td></tr>
77
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#9b6af9110758ce34856b005b19a7a2fb">deactivate</a> ()</td></tr>
78
 
 
79
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#bc8e49ce84e81319c81bdc58020245c0">cancel</a> ()</td></tr>
80
 
 
81
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Cancels the selection within the menu shell. <a href="#bc8e49ce84e81319c81bdc58020245c0"></a><br></td></tr>
82
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>&lt; void &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#14c8a5dcb0d5afa8b1ab93ae149cf603">signal_deactivate</a> ()</td></tr>
83
 
 
84
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>&lt; void &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#fe3aa91d39c133487f5ee87afdf3e255">signal_selection_done</a> ()</td></tr>
85
 
 
86
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>&lt; gboolean, int &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#29358f68b2c16afdab5147f7021368e8">signal_move_selected</a> ()</td></tr>
87
 
 
88
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGtk_1_1Menu__Helpers_1_1MenuList.html">MenuList</a>&amp;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#3be08eb46038a65ca6c9b5b35f310672">items</a> ()</td></tr>
89
 
 
90
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="classGtk_1_1Menu__Helpers_1_1MenuList.html">MenuList</a>&amp;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a65f89396cb05203e8ef565a2cd0ea1d">items</a> () const </td></tr>
91
 
 
92
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#b871eaa94a1566f520beb132ba3794c4">accelerate</a> (<a class="el" href="classGtk_1_1Window.html">Window</a>&amp; window)</td></tr>
93
 
 
94
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Initializes menu accelerators. <a href="#b871eaa94a1566f520beb132ba3794c4"></a><br></td></tr>
95
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#b854722984e3fc3e85d2ad7c7ba20c2f">accelerate</a> (<a class="el" href="classGtk_1_1Widget.html">Widget</a>&amp; parent)</td></tr>
96
 
 
97
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Initializes menu accelerators. <a href="#b854722984e3fc3e85d2ad7c7ba20c2f"></a><br></td></tr>
98
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#959971445f815ecfcc2f3d3cda24708a">get_take_focus</a> () const </td></tr>
99
 
 
100
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns: <code>true</code> if the menu shell will take the keyboard focus on popup. <a href="#959971445f815ecfcc2f3d3cda24708a"></a><br></td></tr>
101
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#c076143bf45a4c69cd65965a7779a963">set_take_focus</a> (bool take_focus=true)</td></tr>
102
 
 
103
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">If <em>take_focus</em> is <code>true</code> (the default) the menu shell will take the keyboard focus so that it will receive all keyboard events which is needed to enable keyboard navigation in menus. <a href="#c076143bf45a4c69cd65965a7779a963"></a><br></td></tr>
104
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>&lt; bool &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#98a38ba541cff7ba9f990e24adeb6642">property_take_focus</a> ()</td></tr>
105
 
 
106
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">A boolean that determines whether the menu grabs the keyboard focus. <a href="#98a38ba541cff7ba9f990e24adeb6642"></a><br></td></tr>
107
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak">
108
 
&lt; bool &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#4119fb422a09241e3e88a6cc1431ee06">property_take_focus</a> () const </td></tr>
109
 
 
110
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">A boolean that determines whether the menu grabs the keyboard focus. <a href="#4119fb422a09241e3e88a6cc1431ee06"></a><br></td></tr>
111
 
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
112
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#eceb71b253394dbc8ca282feb8ae8e58">on_deactivate</a> ()</td></tr>
113
 
 
114
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#407cbaed85670dc36c35a67cdefd015b">on_selection_done</a> ()</td></tr>
115
 
 
116
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#6af3cf3fd23271ebe15daa3210339bfe">MenuShell</a> ()</td></tr>
117
 
 
118
 
<tr><td colspan="2"><br><h2>Related Functions</h2></td></tr>
119
 
<tr><td colspan="2">(Note that these are not member functions.) <br><br></td></tr>
120
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGtk_1_1MenuShell.html">Gtk::MenuShell</a>*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#5a3342e817b330a6b353d25c37ea2359">wrap</a> (GtkMenuShell* object, bool take_copy=false)</td></tr>
121
 
 
122
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">A <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#5a3342e817b330a6b353d25c37ea2359"></a><br></td></tr>
 
45
<div class="center"><img src="classGtk_1_1MenuShell__coll__graph.png" border="0" usemap="#Gtk_1_1MenuShell_coll__map" alt="Collaboration graph"/></div>
 
46
<map name="Gtk_1_1MenuShell_coll__map" id="Gtk_1_1MenuShell_coll__map">
 
47
<area shape="rect" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="873,36,977,63"/><area shape="rect" href="classGtk_1_1Bin.html" title="A container with just one child." alt="" coords="1840,69,1909,96"/><area shape="rect" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)." alt="" coords="661,36,752,63"/><area shape="rect" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non&#45;widget objects such..." alt="" coords="505,5,593,32"/><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="340,5,431,32"/><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="163,29,283,56"/><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="333,56,437,83"/><area shape="rect" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="5,29,112,56"/><area shape="rect" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="489,56,609,83"/><area shape="rect" href="classGtk_1_1Window.html" title="Toplevel Window This represents all widgets which are physical windows controlled..." alt="" coords="2345,80,2441,107"/><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html" title="Glib::RefPtr\&lt; AccelGroup \&gt;" alt="" coords="1784,120,1965,147"/><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html" title="Glib::RefPtr\&lt; T_CppObject \&gt;" alt="" coords="831,120,1020,147"/><area shape="rect" href="classGtk_1_1Menu__Helpers_1_1MenuList.html" title="Gtk::Menu_Helpers::MenuList" alt="" coords="2296,153,2491,180"/><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1HelperList.html" title="Glib::HelperList\&lt; MenuItem, const Element, Glib::List_Cpp_Iterator\&lt; GtkMenuItem, MenuItem \&gt; \&gt;" alt="" coords="1579,171,2171,197"/><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1HelperList.html" title="Glib::HelperList\&lt; class, class, class \&gt;" alt="" coords="804,171,1047,197"/></map>
 
48
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
 
49
 
 
50
<p><a href="classGtk_1_1MenuShell-members.html">List of all members.</a></p>
 
51
<table border="0" cellpadding="0" cellspacing="0">
 
52
<tr><td colspan="2"><h2>Public Types</h2></td></tr>
 
53
<tr><td class="memItemLeft" align="right" valign="top">typedef <a class="el" href="classGtk_1_1Menu__Helpers_1_1MenuList.html">Menu_Helpers::MenuList</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a8d79bb921d0a3ffca5e4c9d8f77648a2">MenuList</a></td></tr>
 
54
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
 
55
<tr><td class="memItemLeft" align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#ab7117e65877843c10ad7d5b705a770e7">~MenuShell</a> ()</td></tr>
 
56
<tr><td class="memItemLeft" align="right" valign="top">GtkMenuShell*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#abb7c2641f9e3624f3225dcf76d8b994c">gobj</a> ()</td></tr>
 
57
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#abb7c2641f9e3624f3225dcf76d8b994c"></a><br/></td></tr>
 
58
<tr><td class="memItemLeft" align="right" valign="top">const GtkMenuShell*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a4417adfb6a301e40a0040517c43e69c7">gobj</a> () const </td></tr>
 
59
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#a4417adfb6a301e40a0040517c43e69c7"></a><br/></td></tr>
 
60
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a24d5b1a4a61941006e544a4f5a230917">append</a> (<a class="el" href="classGtk_1_1MenuItem.html">MenuItem</a>&amp; menu_item)</td></tr>
 
61
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a5aa0142b2f86f511ac5f98ce892d03bd">prepend</a> (<a class="el" href="classGtk_1_1MenuItem.html">MenuItem</a>&amp; menu_item)</td></tr>
 
62
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#aa3243bef17ebc3ed18b3885194e7d9a3">insert</a> (<a class="el" href="classGtk_1_1MenuItem.html">MenuItem</a>&amp; menu_item, int position)</td></tr>
 
63
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#ac38fde346621b24154540f83243956fd">select_item</a> (<a class="el" href="classGtk_1_1MenuItem.html">MenuItem</a>&amp; menu_item)</td></tr>
 
64
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#ab90ff16ed2fcba9aa3460569d45f1c1a">deselect</a> ()</td></tr>
 
65
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a6e5136fc61381ae6f2e529906066680a">activate_item</a> (<a class="el" href="classGtk_1_1MenuItem.html">MenuItem</a>&amp; menu_item, bool force_deactivate=false)</td></tr>
 
66
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a882dab72c89e462a879a6b6179464cc2">select_first</a> (bool search_sensitive=true)</td></tr>
 
67
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Select the first visible or selectable child of the menu shell; don't select tearoff items unless the only item is a tearoff item. <a href="#a882dab72c89e462a879a6b6179464cc2"></a><br/></td></tr>
 
68
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a9b6af9110758ce34856b005b19a7a2fb">deactivate</a> ()</td></tr>
 
69
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#abc8e49ce84e81319c81bdc58020245c0">cancel</a> ()</td></tr>
 
70
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Cancels the selection within the menu shell. <a href="#abc8e49ce84e81319c81bdc58020245c0"></a><br/></td></tr>
 
71
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>&lt; void &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a14c8a5dcb0d5afa8b1ab93ae149cf603">signal_deactivate</a> ()</td></tr>
 
72
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>&lt; void &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#afe3aa91d39c133487f5ee87afdf3e255">signal_selection_done</a> ()</td></tr>
 
73
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>&lt; gboolean, int &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a29358f68b2c16afdab5147f7021368e8">signal_move_selected</a> ()</td></tr>
 
74
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1Menu__Helpers_1_1MenuList.html">MenuList</a>&amp;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a3be08eb46038a65ca6c9b5b35f310672">items</a> ()</td></tr>
 
75
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="classGtk_1_1Menu__Helpers_1_1MenuList.html">MenuList</a>&amp;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#aa65f89396cb05203e8ef565a2cd0ea1d">items</a> () const </td></tr>
 
76
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#ab871eaa94a1566f520beb132ba3794c4">accelerate</a> (<a class="el" href="classGtk_1_1Window.html">Window</a>&amp; window)</td></tr>
 
77
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Initializes menu accelerators. <a href="#ab871eaa94a1566f520beb132ba3794c4"></a><br/></td></tr>
 
78
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#ab854722984e3fc3e85d2ad7c7ba20c2f">accelerate</a> (<a class="el" href="classGtk_1_1Widget.html">Widget</a>&amp; parent)</td></tr>
 
79
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Initializes menu accelerators. <a href="#ab854722984e3fc3e85d2ad7c7ba20c2f"></a><br/></td></tr>
 
80
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a959971445f815ecfcc2f3d3cda24708a">get_take_focus</a> () const </td></tr>
 
81
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns: <code>true</code> if the menu shell will take the keyboard focus on popup. <a href="#a959971445f815ecfcc2f3d3cda24708a"></a><br/></td></tr>
 
82
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#ac076143bf45a4c69cd65965a7779a963">set_take_focus</a> (bool take_focus=true)</td></tr>
 
83
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">If <em>take_focus</em> is <code>true</code> (the default) the menu shell will take the keyboard focus so that it will receive all keyboard events which is needed to enable keyboard navigation in menus. <a href="#ac076143bf45a4c69cd65965a7779a963"></a><br/></td></tr>
 
84
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>&lt; bool &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a98a38ba541cff7ba9f990e24adeb6642">property_take_focus</a> ()</td></tr>
 
85
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">A boolean that determines whether the menu grabs the keyboard focus. <a href="#a98a38ba541cff7ba9f990e24adeb6642"></a><br/></td></tr>
 
86
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
 
87
&lt; bool &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a4119fb422a09241e3e88a6cc1431ee06">property_take_focus</a> () const </td></tr>
 
88
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">A boolean that determines whether the menu grabs the keyboard focus. <a href="#a4119fb422a09241e3e88a6cc1431ee06"></a><br/></td></tr>
 
89
<tr><td colspan="2"><h2>Protected Member Functions</h2></td></tr>
 
90
<tr><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#aeceb71b253394dbc8ca282feb8ae8e58">on_deactivate</a> ()</td></tr>
 
91
<tr><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a407cbaed85670dc36c35a67cdefd015b">on_selection_done</a> ()</td></tr>
 
92
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a6af3cf3fd23271ebe15daa3210339bfe">MenuShell</a> ()</td></tr>
 
93
<tr><td colspan="2"><h2>Related Functions</h2></td></tr>
 
94
<tr><td colspan="2"><p>(Note that these are not member functions.) </p>
 
95
<br/><br/></td></tr>
 
96
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1MenuShell.html">Gtk::MenuShell</a>*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1MenuShell.html#a5a3342e817b330a6b353d25c37ea2359">wrap</a> (GtkMenuShell* object, bool take_copy=false)</td></tr>
 
97
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">A <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a5a3342e817b330a6b353d25c37ea2359"></a><br/></td></tr>
123
98
</table>
124
 
<hr><a name="_details"></a><h2>Detailed Description</h2>
125
 
The abstract base class for <a class="el" href="classGtk_1_1Menu.html" title="A drop-down menu consisting of Gtk::MenuItem objects which can be navigated and activated...">Gtk::Menu</a> and <a class="el" href="classGtk_1_1MenuBar.html" title="A standard menu bar which usually holds Gtk::Menu submenu items.">Gtk::MenuBar</a>. <p>
126
 
It is a container of <a class="el" href="classGtk_1_1MenuItem.html" title="Child item for menus.">Gtk::MenuItem</a> objects arranged in a list which can be navigated, selected, and activated by the user to perform application functions. It can have a submenu associated with it, allowing for nested hierarchical menus. You can use <a class="el" href="classGtk_1_1MenuShell.html#24d5b1a4a61941006e544a4f5a230917">append()</a>, <a class="el" href="classGtk_1_1MenuShell.html#5aa0142b2f86f511ac5f98ce892d03bd">prepend()</a> and <a class="el" href="classGtk_1_1MenuShell.html#a3243bef17ebc3ed18b3885194e7d9a3">insert()</a> to add <a class="el" href="classGtk_1_1MenuItem.html" title="Child item for menus.">Gtk::MenuItem</a> widgets, but you will probably find it more convenient to use the STL-style <a class="el" href="classGtk_1_1MenuShell.html#3be08eb46038a65ca6c9b5b35f310672">items()</a> interface with the Gtk::Menu_Helpers::MenuElem() class. <hr><h2>Member Typedef Documentation</h2>
127
 
<a class="anchor" name="8d79bb921d0a3ffca5e4c9d8f77648a2"></a><!-- doxytag: member="Gtk::MenuShell::MenuList" ref="8d79bb921d0a3ffca5e4c9d8f77648a2" args="" -->
 
99
<hr/><a name="_details"></a><h2>Detailed Description</h2>
 
100
<p>The abstract base class for <a class="el" href="classGtk_1_1Menu.html" title="A drop-down menu consisting of Gtk::MenuItem objects which can be navigated and activated...">Gtk::Menu</a> and <a class="el" href="classGtk_1_1MenuBar.html" title="A standard menu bar which usually holds Gtk::Menu submenu items.">Gtk::MenuBar</a>. </p>
 
101
<p>It is a container of <a class="el" href="classGtk_1_1MenuItem.html" title="Child item for menus.">Gtk::MenuItem</a> objects arranged in a list which can be navigated, selected, and activated by the user to perform application functions. It can have a submenu associated with it, allowing for nested hierarchical menus. You can use <a class="el" href="classGtk_1_1MenuShell.html#a24d5b1a4a61941006e544a4f5a230917">append()</a>, <a class="el" href="classGtk_1_1MenuShell.html#a5aa0142b2f86f511ac5f98ce892d03bd">prepend()</a> and <a class="el" href="classGtk_1_1MenuShell.html#aa3243bef17ebc3ed18b3885194e7d9a3">insert()</a> to add <a class="el" href="classGtk_1_1MenuItem.html" title="Child item for menus.">Gtk::MenuItem</a> widgets, but you will probably find it more convenient to use the STL-style <a class="el" href="classGtk_1_1MenuShell.html#a3be08eb46038a65ca6c9b5b35f310672">items()</a> interface with the Gtk::Menu_Helpers::MenuElem() class. </p>
 
102
<hr/><h2>Member Typedef Documentation</h2>
 
103
<a class="anchor" id="a8d79bb921d0a3ffca5e4c9d8f77648a2"></a><!-- doxytag: member="Gtk::MenuShell::MenuList" ref="a8d79bb921d0a3ffca5e4c9d8f77648a2" args="" -->
128
104
<div class="memitem">
129
105
<div class="memproto">
130
106
      <table class="memname">
131
107
        <tr>
132
 
          <td class="memname">typedef <a class="el" href="classGtk_1_1Menu__Helpers_1_1MenuList.html">Menu_Helpers::MenuList</a> <a class="el" href="classGtk_1_1Menu__Helpers_1_1MenuList.html">Gtk::MenuShell::MenuList</a> </td>
 
108
          <td class="memname">typedef <a class="el" href="classGtk_1_1Menu__Helpers_1_1MenuList.html">Menu_Helpers::MenuList</a> <a class="el" href="classGtk_1_1Menu__Helpers_1_1MenuList.html">Gtk::MenuShell::MenuList</a></td>
133
109
        </tr>
134
110
      </table>
135
111
</div>
136
112
<div class="memdoc">
137
113
 
138
 
<p>
139
 
 
140
 
</div>
141
 
</div><p>
142
 
<hr><h2>Constructor &amp; Destructor Documentation</h2>
143
 
<a class="anchor" name="b7117e65877843c10ad7d5b705a770e7"></a><!-- doxytag: member="Gtk::MenuShell::~MenuShell" ref="b7117e65877843c10ad7d5b705a770e7" args="()" -->
 
114
</div>
 
115
</div>
 
116
<hr/><h2>Constructor &amp; Destructor Documentation</h2>
 
117
<a class="anchor" id="ab7117e65877843c10ad7d5b705a770e7"></a><!-- doxytag: member="Gtk::MenuShell::~MenuShell" ref="ab7117e65877843c10ad7d5b705a770e7" args="()" -->
144
118
<div class="memitem">
145
119
<div class="memproto">
146
120
      <table class="memname">
147
121
        <tr>
148
122
          <td class="memname">virtual Gtk::MenuShell::~MenuShell </td>
149
123
          <td>(</td>
150
 
          <td class="paramname"> </td>
 
124
          <td class="paramname"></td>
151
125
          <td>&#160;)&#160;</td>
152
126
          <td><code> [virtual]</code></td>
153
127
        </tr>
155
129
</div>
156
130
<div class="memdoc">
157
131
 
158
 
<p>
159
 
 
160
 
</div>
161
 
</div><p>
162
 
<a class="anchor" name="6af3cf3fd23271ebe15daa3210339bfe"></a><!-- doxytag: member="Gtk::MenuShell::MenuShell" ref="6af3cf3fd23271ebe15daa3210339bfe" args="()" -->
 
132
</div>
 
133
</div>
 
134
<a class="anchor" id="a6af3cf3fd23271ebe15daa3210339bfe"></a><!-- doxytag: member="Gtk::MenuShell::MenuShell" ref="a6af3cf3fd23271ebe15daa3210339bfe" args="()" -->
163
135
<div class="memitem">
164
136
<div class="memproto">
165
137
      <table class="memname">
166
138
        <tr>
167
139
          <td class="memname">Gtk::MenuShell::MenuShell </td>
168
140
          <td>(</td>
169
 
          <td class="paramname"> </td>
 
141
          <td class="paramname"></td>
170
142
          <td>&#160;)&#160;</td>
171
143
          <td><code> [protected]</code></td>
172
144
        </tr>
174
146
</div>
175
147
<div class="memdoc">
176
148
 
177
 
<p>
178
 
 
179
 
</div>
180
 
</div><p>
181
 
<hr><h2>Member Function Documentation</h2>
182
 
<a class="anchor" name="b854722984e3fc3e85d2ad7c7ba20c2f"></a><!-- doxytag: member="Gtk::MenuShell::accelerate" ref="b854722984e3fc3e85d2ad7c7ba20c2f" args="(Widget &amp;parent)" -->
 
149
</div>
 
150
</div>
 
151
<hr/><h2>Member Function Documentation</h2>
 
152
<a class="anchor" id="ab854722984e3fc3e85d2ad7c7ba20c2f"></a><!-- doxytag: member="Gtk::MenuShell::accelerate" ref="ab854722984e3fc3e85d2ad7c7ba20c2f" args="(Widget &amp;parent)" -->
183
153
<div class="memitem">
184
154
<div class="memproto">
185
155
      <table class="memname">
187
157
          <td class="memname">void Gtk::MenuShell::accelerate </td>
188
158
          <td>(</td>
189
159
          <td class="paramtype"><a class="el" href="classGtk_1_1Widget.html">Widget</a>&amp;&#160;</td>
190
 
          <td class="paramname"> <em>parent</em> </td>
 
160
          <td class="paramname"> <em>parent</em></td>
191
161
          <td>&#160;)&#160;</td>
192
162
          <td></td>
193
163
        </tr>
195
165
</div>
196
166
<div class="memdoc">
197
167
 
198
 
<p>
199
 
Initializes menu accelerators. <p>
200
 
Does the same as the <a class="el" href="classGtk_1_1MenuShell.html#b871eaa94a1566f520beb132ba3794c4" title="Initializes menu accelerators.">accelerate(Window&amp; window)</a> method. But you can use any parent widget where the menu is used. This method then gets the toplevel window using <a class="el" href="classGtk_1_1Widget.html#b91722dd77223c450b8dfaa45af59c1a" title="This function returns the topmost widget in the container hierarchy widget is a part...">Widget::get_toplevel()</a> and uses this window for registering the menu accelerators.<p>
201
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
168
<p>Initializes menu accelerators. </p>
 
169
<p>Does the same as the <a class="el" href="classGtk_1_1MenuShell.html#ab871eaa94a1566f520beb132ba3794c4" title="Initializes menu accelerators.">accelerate(Window&amp; window)</a> method. But you can use any parent widget where the menu is used. This method then gets the toplevel window using <a class="el" href="classGtk_1_1Widget.html#ab91722dd77223c450b8dfaa45af59c1a" title="This function returns the topmost widget in the container hierarchy widget is a part...">Widget::get_toplevel()</a> and uses this window for registering the menu accelerators.</p>
 
170
<dl><dt><b>Parameters:</b></dt><dd>
202
171
  <table border="0" cellspacing="2" cellpadding="0">
203
172
    <tr><td valign="top"></td><td valign="top"><em>parent</em>&#160;</td><td>Parent widget used as starting point for searching the toplevel window. </td></tr>
204
173
  </table>
 
174
  </dd>
205
175
</dl>
206
176
 
207
177
</div>
208
 
</div><p>
209
 
<a class="anchor" name="b871eaa94a1566f520beb132ba3794c4"></a><!-- doxytag: member="Gtk::MenuShell::accelerate" ref="b871eaa94a1566f520beb132ba3794c4" args="(Window &amp;window)" -->
 
178
</div>
 
179
<a class="anchor" id="ab871eaa94a1566f520beb132ba3794c4"></a><!-- doxytag: member="Gtk::MenuShell::accelerate" ref="ab871eaa94a1566f520beb132ba3794c4" args="(Window &amp;window)" -->
210
180
<div class="memitem">
211
181
<div class="memproto">
212
182
      <table class="memname">
214
184
          <td class="memname">void Gtk::MenuShell::accelerate </td>
215
185
          <td>(</td>
216
186
          <td class="paramtype"><a class="el" href="classGtk_1_1Window.html">Window</a>&amp;&#160;</td>
217
 
          <td class="paramname"> <em>window</em> </td>
 
187
          <td class="paramname"> <em>window</em></td>
218
188
          <td>&#160;)&#160;</td>
219
189
          <td></td>
220
190
        </tr>
222
192
</div>
223
193
<div class="memdoc">
224
194
 
225
 
<p>
226
 
Initializes menu accelerators. <p>
227
 
This method initializes the menu accelerators. Therefore an <a class="el" href="classGtk_1_1AccelGroup.html" title="A Gtk::AccelGroup represents a group of keyboard accelerators, typically attached...">AccelGroup</a> object is needed which is stored in each <a class="el" href="classGtk_1_1Window.html" title="Toplevel Window This represents all widgets which are physical windows controlled...">Window</a> object in the Gtkmm library implementation.<p>
228
 
When using <a class="el" href="classGtk_1_1MenuBar.html" title="A standard menu bar which usually holds Gtk::Menu submenu items.">MenuBar</a> and <a class="el" href="classGtk_1_1OptionMenu.html" title="A widget used to choose from a list of valid choices.">OptionMenu</a> objects this method is called automatically when the menus are realized. Because most likely the <a class="el" href="classGtk_1_1MenuBar.html" title="A standard menu bar which usually holds Gtk::Menu submenu items.">MenuBar</a> and <a class="el" href="classGtk_1_1OptionMenu.html" title="A widget used to choose from a list of valid choices.">OptionMenu</a> is attached to a window at this time and the window object can be found automatically.<p>
229
 
Important note when using popup menus: If you are using accelerated menu entries inside a popup menu you have to call the <a class="el" href="classGtk_1_1MenuShell.html#b871eaa94a1566f520beb132ba3794c4" title="Initializes menu accelerators.">accelerate()</a> method manually. This is because the popup menu is not connected to any window and the accelerators should be initialized even before the popup menu is shown. The right place to call the <a class="el" href="classGtk_1_1MenuShell.html#b871eaa94a1566f520beb132ba3794c4" title="Initializes menu accelerators.">accelerate()</a> method is right after the popup menu has been build.<p>
230
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
195
<p>Initializes menu accelerators. </p>
 
196
<p>This method initializes the menu accelerators. Therefore an <a class="el" href="classGtk_1_1AccelGroup.html" title="A Gtk::AccelGroup represents a group of keyboard accelerators, typically attached...">AccelGroup</a> object is needed which is stored in each <a class="el" href="classGtk_1_1Window.html" title="Toplevel Window This represents all widgets which are physical windows controlled...">Window</a> object in the Gtkmm library implementation.</p>
 
197
<p>When using <a class="el" href="classGtk_1_1MenuBar.html" title="A standard menu bar which usually holds Gtk::Menu submenu items.">MenuBar</a> and <a class="el" href="classGtk_1_1OptionMenu.html" title="A widget used to choose from a list of valid choices.">OptionMenu</a> objects this method is called automatically when the menus are realized. Because most likely the <a class="el" href="classGtk_1_1MenuBar.html" title="A standard menu bar which usually holds Gtk::Menu submenu items.">MenuBar</a> and <a class="el" href="classGtk_1_1OptionMenu.html" title="A widget used to choose from a list of valid choices.">OptionMenu</a> is attached to a window at this time and the window object can be found automatically.</p>
 
198
<p>Important note when using popup menus: If you are using accelerated menu entries inside a popup menu you have to call the <a class="el" href="classGtk_1_1MenuShell.html#ab871eaa94a1566f520beb132ba3794c4" title="Initializes menu accelerators.">accelerate()</a> method manually. This is because the popup menu is not connected to any window and the accelerators should be initialized even before the popup menu is shown. The right place to call the <a class="el" href="classGtk_1_1MenuShell.html#ab871eaa94a1566f520beb132ba3794c4" title="Initializes menu accelerators.">accelerate()</a> method is right after the popup menu has been build.</p>
 
199
<dl><dt><b>Parameters:</b></dt><dd>
231
200
  <table border="0" cellspacing="2" cellpadding="0">
232
201
    <tr><td valign="top"></td><td valign="top"><em>window</em>&#160;</td><td><a class="el" href="classGtk_1_1Window.html" title="Toplevel Window This represents all widgets which are physical windows controlled...">Window</a> where the menu is shown. Inside this window the <a class="el" href="classGtk_1_1AccelGroup.html" title="A Gtk::AccelGroup represents a group of keyboard accelerators, typically attached...">AccelGroup</a> object is stored that will be used to initialize the accelerators. </td></tr>
233
202
  </table>
 
203
  </dd>
234
204
</dl>
235
205
 
236
206
</div>
237
 
</div><p>
238
 
<a class="anchor" name="6e5136fc61381ae6f2e529906066680a"></a><!-- doxytag: member="Gtk::MenuShell::activate_item" ref="6e5136fc61381ae6f2e529906066680a" args="(MenuItem &amp;menu_item, bool force_deactivate=false)" -->
 
207
</div>
 
208
<a class="anchor" id="a6e5136fc61381ae6f2e529906066680a"></a><!-- doxytag: member="Gtk::MenuShell::activate_item" ref="a6e5136fc61381ae6f2e529906066680a" args="(MenuItem &amp;menu_item, bool force_deactivate=false)" -->
239
209
<div class="memitem">
240
210
<div class="memproto">
241
211
      <table class="memname">
260
230
</div>
261
231
<div class="memdoc">
262
232
 
263
 
<p>
264
 
 
265
 
</div>
266
 
</div><p>
267
 
<a class="anchor" name="24d5b1a4a61941006e544a4f5a230917"></a><!-- doxytag: member="Gtk::MenuShell::append" ref="24d5b1a4a61941006e544a4f5a230917" args="(MenuItem &amp;menu_item)" -->
 
233
</div>
 
234
</div>
 
235
<a class="anchor" id="a24d5b1a4a61941006e544a4f5a230917"></a><!-- doxytag: member="Gtk::MenuShell::append" ref="a24d5b1a4a61941006e544a4f5a230917" args="(MenuItem &amp;menu_item)" -->
268
236
<div class="memitem">
269
237
<div class="memproto">
270
238
      <table class="memname">
272
240
          <td class="memname">void Gtk::MenuShell::append </td>
273
241
          <td>(</td>
274
242
          <td class="paramtype"><a class="el" href="classGtk_1_1MenuItem.html">MenuItem</a>&amp;&#160;</td>
275
 
          <td class="paramname"> <em>menu_item</em> </td>
 
243
          <td class="paramname"> <em>menu_item</em></td>
276
244
          <td>&#160;)&#160;</td>
277
245
          <td></td>
278
246
        </tr>
280
248
</div>
281
249
<div class="memdoc">
282
250
 
283
 
<p>
284
 
 
285
 
</div>
286
 
</div><p>
287
 
<a class="anchor" name="bc8e49ce84e81319c81bdc58020245c0"></a><!-- doxytag: member="Gtk::MenuShell::cancel" ref="bc8e49ce84e81319c81bdc58020245c0" args="()" -->
 
251
</div>
 
252
</div>
 
253
<a class="anchor" id="abc8e49ce84e81319c81bdc58020245c0"></a><!-- doxytag: member="Gtk::MenuShell::cancel" ref="abc8e49ce84e81319c81bdc58020245c0" args="()" -->
288
254
<div class="memitem">
289
255
<div class="memproto">
290
256
      <table class="memname">
291
257
        <tr>
292
258
          <td class="memname">void Gtk::MenuShell::cancel </td>
293
259
          <td>(</td>
294
 
          <td class="paramname"> </td>
 
260
          <td class="paramname"></td>
295
261
          <td>&#160;)&#160;</td>
296
262
          <td></td>
297
263
        </tr>
299
265
</div>
300
266
<div class="memdoc">
301
267
 
302
 
<p>
303
 
Cancels the selection within the menu shell. <p>
304
 
<dl compact><dt><b><a class="el" href="since_2_4.html#_since_2_4000203">Since gtkmm 2.4:</a></b></dt><dd></dd></dl>
 
268
<p>Cancels the selection within the menu shell. </p>
 
269
<dl class="since_2_4"><dt><b><a class="el" href="since_2_4.html#_since_2_4000203">Since gtkmm 2.4:</a></b></dt><dd></dd></dl>
305
270
 
306
271
</div>
307
 
</div><p>
308
 
<a class="anchor" name="9b6af9110758ce34856b005b19a7a2fb"></a><!-- doxytag: member="Gtk::MenuShell::deactivate" ref="9b6af9110758ce34856b005b19a7a2fb" args="()" -->
 
272
</div>
 
273
<a class="anchor" id="a9b6af9110758ce34856b005b19a7a2fb"></a><!-- doxytag: member="Gtk::MenuShell::deactivate" ref="a9b6af9110758ce34856b005b19a7a2fb" args="()" -->
309
274
<div class="memitem">
310
275
<div class="memproto">
311
276
      <table class="memname">
312
277
        <tr>
313
278
          <td class="memname">void Gtk::MenuShell::deactivate </td>
314
279
          <td>(</td>
315
 
          <td class="paramname"> </td>
 
280
          <td class="paramname"></td>
316
281
          <td>&#160;)&#160;</td>
317
282
          <td></td>
318
283
        </tr>
320
285
</div>
321
286
<div class="memdoc">
322
287
 
323
 
<p>
324
 
 
325
 
</div>
326
 
</div><p>
327
 
<a class="anchor" name="b90ff16ed2fcba9aa3460569d45f1c1a"></a><!-- doxytag: member="Gtk::MenuShell::deselect" ref="b90ff16ed2fcba9aa3460569d45f1c1a" args="()" -->
 
288
</div>
 
289
</div>
 
290
<a class="anchor" id="ab90ff16ed2fcba9aa3460569d45f1c1a"></a><!-- doxytag: member="Gtk::MenuShell::deselect" ref="ab90ff16ed2fcba9aa3460569d45f1c1a" args="()" -->
328
291
<div class="memitem">
329
292
<div class="memproto">
330
293
      <table class="memname">
331
294
        <tr>
332
295
          <td class="memname">void Gtk::MenuShell::deselect </td>
333
296
          <td>(</td>
334
 
          <td class="paramname"> </td>
 
297
          <td class="paramname"></td>
335
298
          <td>&#160;)&#160;</td>
336
299
          <td></td>
337
300
        </tr>
339
302
</div>
340
303
<div class="memdoc">
341
304
 
342
 
<p>
343
 
 
344
 
</div>
345
 
</div><p>
346
 
<a class="anchor" name="959971445f815ecfcc2f3d3cda24708a"></a><!-- doxytag: member="Gtk::MenuShell::get_take_focus" ref="959971445f815ecfcc2f3d3cda24708a" args="() const " -->
 
305
</div>
 
306
</div>
 
307
<a class="anchor" id="a959971445f815ecfcc2f3d3cda24708a"></a><!-- doxytag: member="Gtk::MenuShell::get_take_focus" ref="a959971445f815ecfcc2f3d3cda24708a" args="() const " -->
347
308
<div class="memitem">
348
309
<div class="memproto">
349
310
      <table class="memname">
350
311
        <tr>
351
312
          <td class="memname">bool Gtk::MenuShell::get_take_focus </td>
352
313
          <td>(</td>
353
 
          <td class="paramname"> </td>
 
314
          <td class="paramname"></td>
354
315
          <td>&#160;)&#160;</td>
355
316
          <td> const</td>
356
317
        </tr>
358
319
</div>
359
320
<div class="memdoc">
360
321
 
361
 
<p>
362
 
Returns: <code>true</code> if the menu shell will take the keyboard focus on popup. <p>
363
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the menu shell will take the keyboard focus on popup.</dd></dl>
364
 
<dl compact><dt><b><a class="el" href="since_2_8.html#_since_2_8000032">Since gtkmm 2.8:</a></b></dt><dd></dd></dl>
 
322
<p>Returns: <code>true</code> if the menu shell will take the keyboard focus on popup. </p>
 
323
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if the menu shell will take the keyboard focus on popup.</dd></dl>
 
324
<dl class="since_2_8"><dt><b><a class="el" href="since_2_8.html#_since_2_8000032">Since gtkmm 2.8:</a></b></dt><dd></dd></dl>
365
325
 
366
326
</div>
367
 
</div><p>
368
 
<a class="anchor" name="4417adfb6a301e40a0040517c43e69c7"></a><!-- doxytag: member="Gtk::MenuShell::gobj" ref="4417adfb6a301e40a0040517c43e69c7" args="() const " -->
 
327
</div>
 
328
<a class="anchor" id="a4417adfb6a301e40a0040517c43e69c7"></a><!-- doxytag: member="Gtk::MenuShell::gobj" ref="a4417adfb6a301e40a0040517c43e69c7" args="() const " -->
369
329
<div class="memitem">
370
330
<div class="memproto">
371
331
      <table class="memname">
372
332
        <tr>
373
333
          <td class="memname">const GtkMenuShell* Gtk::MenuShell::gobj </td>
374
334
          <td>(</td>
375
 
          <td class="paramname"> </td>
 
335
          <td class="paramname"></td>
376
336
          <td>&#160;)&#160;</td>
377
337
          <td> const<code> [inline]</code></td>
378
338
        </tr>
380
340
</div>
381
341
<div class="memdoc">
382
342
 
383
 
<p>
384
 
Provides access to the underlying C GtkObject. <p>
385
 
 
386
 
<p>Reimplemented from <a class="el" href="classGtk_1_1Container.html#b80be58ac27710f10f329120587e7d60">Gtk::Container</a>.</p>
387
 
 
388
 
<p>Reimplemented in <a class="el" href="classGtk_1_1Menu.html#943271a828e8bfa829c6bf4ed0060203">Gtk::Menu</a>, <a class="el" href="classGtk_1_1MenuBar.html#3e7df05b207812ee2abca13e8c0f26e3">Gtk::MenuBar</a>, and <a class="el" href="classGtk_1_1RecentChooserMenu.html#c8d86c1bbe5f6997e524f28db4cb95b5">Gtk::RecentChooserMenu</a>.</p>
389
 
 
390
 
</div>
391
 
</div><p>
392
 
<a class="anchor" name="bb7c2641f9e3624f3225dcf76d8b994c"></a><!-- doxytag: member="Gtk::MenuShell::gobj" ref="bb7c2641f9e3624f3225dcf76d8b994c" args="()" -->
 
343
<p>Provides access to the underlying C GtkObject. </p>
 
344
 
 
345
<p>Reimplemented from <a class="el" href="classGtk_1_1Container.html#ab80be58ac27710f10f329120587e7d60">Gtk::Container</a>.</p>
 
346
 
 
347
<p>Reimplemented in <a class="el" href="classGtk_1_1Menu.html#a943271a828e8bfa829c6bf4ed0060203">Gtk::Menu</a>, <a class="el" href="classGtk_1_1MenuBar.html#a3e7df05b207812ee2abca13e8c0f26e3">Gtk::MenuBar</a>, and <a class="el" href="classGtk_1_1RecentChooserMenu.html#ac8d86c1bbe5f6997e524f28db4cb95b5">Gtk::RecentChooserMenu</a>.</p>
 
348
 
 
349
</div>
 
350
</div>
 
351
<a class="anchor" id="abb7c2641f9e3624f3225dcf76d8b994c"></a><!-- doxytag: member="Gtk::MenuShell::gobj" ref="abb7c2641f9e3624f3225dcf76d8b994c" args="()" -->
393
352
<div class="memitem">
394
353
<div class="memproto">
395
354
      <table class="memname">
396
355
        <tr>
397
356
          <td class="memname">GtkMenuShell* Gtk::MenuShell::gobj </td>
398
357
          <td>(</td>
399
 
          <td class="paramname"> </td>
 
358
          <td class="paramname"></td>
400
359
          <td>&#160;)&#160;</td>
401
360
          <td><code> [inline]</code></td>
402
361
        </tr>
404
363
</div>
405
364
<div class="memdoc">
406
365
 
407
 
<p>
408
 
Provides access to the underlying C GtkObject. <p>
409
 
 
410
 
<p>Reimplemented from <a class="el" href="classGtk_1_1Container.html#1b45ff015f4b09b143699bad9d4e423d">Gtk::Container</a>.</p>
411
 
 
412
 
<p>Reimplemented in <a class="el" href="classGtk_1_1Menu.html#08434c6b137ce53eb939b09d577aa9bb">Gtk::Menu</a>, <a class="el" href="classGtk_1_1MenuBar.html#3c2333c3c7c03939590bb2e41b4aaa63">Gtk::MenuBar</a>, and <a class="el" href="classGtk_1_1RecentChooserMenu.html#e3863ae813b85f9b9ac6f4075370a55e">Gtk::RecentChooserMenu</a>.</p>
413
 
 
414
 
</div>
415
 
</div><p>
416
 
<a class="anchor" name="a3243bef17ebc3ed18b3885194e7d9a3"></a><!-- doxytag: member="Gtk::MenuShell::insert" ref="a3243bef17ebc3ed18b3885194e7d9a3" args="(MenuItem &amp;menu_item, int position)" -->
 
366
<p>Provides access to the underlying C GtkObject. </p>
 
367
 
 
368
<p>Reimplemented from <a class="el" href="classGtk_1_1Container.html#a1b45ff015f4b09b143699bad9d4e423d">Gtk::Container</a>.</p>
 
369
 
 
370
<p>Reimplemented in <a class="el" href="classGtk_1_1Menu.html#a08434c6b137ce53eb939b09d577aa9bb">Gtk::Menu</a>, <a class="el" href="classGtk_1_1MenuBar.html#a3c2333c3c7c03939590bb2e41b4aaa63">Gtk::MenuBar</a>, and <a class="el" href="classGtk_1_1RecentChooserMenu.html#ae3863ae813b85f9b9ac6f4075370a55e">Gtk::RecentChooserMenu</a>.</p>
 
371
 
 
372
</div>
 
373
</div>
 
374
<a class="anchor" id="aa3243bef17ebc3ed18b3885194e7d9a3"></a><!-- doxytag: member="Gtk::MenuShell::insert" ref="aa3243bef17ebc3ed18b3885194e7d9a3" args="(MenuItem &amp;menu_item, int position)" -->
417
375
<div class="memitem">
418
376
<div class="memproto">
419
377
      <table class="memname">
438
396
</div>
439
397
<div class="memdoc">
440
398
 
441
 
<p>
442
 
 
443
 
</div>
444
 
</div><p>
445
 
<a class="anchor" name="a65f89396cb05203e8ef565a2cd0ea1d"></a><!-- doxytag: member="Gtk::MenuShell::items" ref="a65f89396cb05203e8ef565a2cd0ea1d" args="() const " -->
 
399
</div>
 
400
</div>
 
401
<a class="anchor" id="aa65f89396cb05203e8ef565a2cd0ea1d"></a><!-- doxytag: member="Gtk::MenuShell::items" ref="aa65f89396cb05203e8ef565a2cd0ea1d" args="() const " -->
446
402
<div class="memitem">
447
403
<div class="memproto">
448
404
      <table class="memname">
449
405
        <tr>
450
406
          <td class="memname">const <a class="el" href="classGtk_1_1Menu__Helpers_1_1MenuList.html">MenuList</a>&amp; Gtk::MenuShell::items </td>
451
407
          <td>(</td>
452
 
          <td class="paramname"> </td>
 
408
          <td class="paramname"></td>
453
409
          <td>&#160;)&#160;</td>
454
410
          <td> const</td>
455
411
        </tr>
457
413
</div>
458
414
<div class="memdoc">
459
415
 
460
 
<p>
461
 
 
462
 
</div>
463
 
</div><p>
464
 
<a class="anchor" name="3be08eb46038a65ca6c9b5b35f310672"></a><!-- doxytag: member="Gtk::MenuShell::items" ref="3be08eb46038a65ca6c9b5b35f310672" args="()" -->
 
416
</div>
 
417
</div>
 
418
<a class="anchor" id="a3be08eb46038a65ca6c9b5b35f310672"></a><!-- doxytag: member="Gtk::MenuShell::items" ref="a3be08eb46038a65ca6c9b5b35f310672" args="()" -->
465
419
<div class="memitem">
466
420
<div class="memproto">
467
421
      <table class="memname">
468
422
        <tr>
469
423
          <td class="memname"><a class="el" href="classGtk_1_1Menu__Helpers_1_1MenuList.html">MenuList</a>&amp; Gtk::MenuShell::items </td>
470
424
          <td>(</td>
471
 
          <td class="paramname"> </td>
 
425
          <td class="paramname"></td>
472
426
          <td>&#160;)&#160;</td>
473
427
          <td></td>
474
428
        </tr>
476
430
</div>
477
431
<div class="memdoc">
478
432
 
479
 
<p>
480
 
 
481
 
</div>
482
 
</div><p>
483
 
<a class="anchor" name="eceb71b253394dbc8ca282feb8ae8e58"></a><!-- doxytag: member="Gtk::MenuShell::on_deactivate" ref="eceb71b253394dbc8ca282feb8ae8e58" args="()" -->
 
433
</div>
 
434
</div>
 
435
<a class="anchor" id="aeceb71b253394dbc8ca282feb8ae8e58"></a><!-- doxytag: member="Gtk::MenuShell::on_deactivate" ref="aeceb71b253394dbc8ca282feb8ae8e58" args="()" -->
484
436
<div class="memitem">
485
437
<div class="memproto">
486
438
      <table class="memname">
487
439
        <tr>
488
440
          <td class="memname">virtual void Gtk::MenuShell::on_deactivate </td>
489
441
          <td>(</td>
490
 
          <td class="paramname"> </td>
 
442
          <td class="paramname"></td>
491
443
          <td>&#160;)&#160;</td>
492
444
          <td><code> [protected, virtual]</code></td>
493
445
        </tr>
495
447
</div>
496
448
<div class="memdoc">
497
449
 
498
 
<p>
499
 
 
500
 
</div>
501
 
</div><p>
502
 
<a class="anchor" name="407cbaed85670dc36c35a67cdefd015b"></a><!-- doxytag: member="Gtk::MenuShell::on_selection_done" ref="407cbaed85670dc36c35a67cdefd015b" args="()" -->
 
450
</div>
 
451
</div>
 
452
<a class="anchor" id="a407cbaed85670dc36c35a67cdefd015b"></a><!-- doxytag: member="Gtk::MenuShell::on_selection_done" ref="a407cbaed85670dc36c35a67cdefd015b" args="()" -->
503
453
<div class="memitem">
504
454
<div class="memproto">
505
455
      <table class="memname">
506
456
        <tr>
507
457
          <td class="memname">virtual void Gtk::MenuShell::on_selection_done </td>
508
458
          <td>(</td>
509
 
          <td class="paramname"> </td>
 
459
          <td class="paramname"></td>
510
460
          <td>&#160;)&#160;</td>
511
461
          <td><code> [protected, virtual]</code></td>
512
462
        </tr>
514
464
</div>
515
465
<div class="memdoc">
516
466
 
517
 
<p>
518
 
 
519
 
</div>
520
 
</div><p>
521
 
<a class="anchor" name="5aa0142b2f86f511ac5f98ce892d03bd"></a><!-- doxytag: member="Gtk::MenuShell::prepend" ref="5aa0142b2f86f511ac5f98ce892d03bd" args="(MenuItem &amp;menu_item)" -->
 
467
</div>
 
468
</div>
 
469
<a class="anchor" id="a5aa0142b2f86f511ac5f98ce892d03bd"></a><!-- doxytag: member="Gtk::MenuShell::prepend" ref="a5aa0142b2f86f511ac5f98ce892d03bd" args="(MenuItem &amp;menu_item)" -->
522
470
<div class="memitem">
523
471
<div class="memproto">
524
472
      <table class="memname">
526
474
          <td class="memname">void Gtk::MenuShell::prepend </td>
527
475
          <td>(</td>
528
476
          <td class="paramtype"><a class="el" href="classGtk_1_1MenuItem.html">MenuItem</a>&amp;&#160;</td>
529
 
          <td class="paramname"> <em>menu_item</em> </td>
 
477
          <td class="paramname"> <em>menu_item</em></td>
530
478
          <td>&#160;)&#160;</td>
531
479
          <td></td>
532
480
        </tr>
534
482
</div>
535
483
<div class="memdoc">
536
484
 
537
 
<p>
538
 
 
539
 
</div>
540
 
</div><p>
541
 
<a class="anchor" name="4119fb422a09241e3e88a6cc1431ee06"></a><!-- doxytag: member="Gtk::MenuShell::property_take_focus" ref="4119fb422a09241e3e88a6cc1431ee06" args="() const " -->
 
485
</div>
 
486
</div>
 
487
<a class="anchor" id="a4119fb422a09241e3e88a6cc1431ee06"></a><!-- doxytag: member="Gtk::MenuShell::property_take_focus" ref="a4119fb422a09241e3e88a6cc1431ee06" args="() const " -->
542
488
<div class="memitem">
543
489
<div class="memproto">
544
490
      <table class="memname">
545
491
        <tr>
546
492
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a>&lt;bool&gt; Gtk::MenuShell::property_take_focus </td>
547
493
          <td>(</td>
548
 
          <td class="paramname"> </td>
 
494
          <td class="paramname"></td>
549
495
          <td>&#160;)&#160;</td>
550
496
          <td> const</td>
551
497
        </tr>
553
499
</div>
554
500
<div class="memdoc">
555
501
 
556
 
<p>
557
 
A boolean that determines whether the menu grabs the keyboard focus. <p>
558
 
You rarely need to use properties because there are get_ and set_ methods for almost all of them. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
 
502
<p>A boolean that determines whether the menu grabs the keyboard focus. </p>
 
503
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
 
504
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
559
505
 
560
506
</div>
561
 
</div><p>
562
 
<a class="anchor" name="98a38ba541cff7ba9f990e24adeb6642"></a><!-- doxytag: member="Gtk::MenuShell::property_take_focus" ref="98a38ba541cff7ba9f990e24adeb6642" args="()" -->
 
507
</div>
 
508
<a class="anchor" id="a98a38ba541cff7ba9f990e24adeb6642"></a><!-- doxytag: member="Gtk::MenuShell::property_take_focus" ref="a98a38ba541cff7ba9f990e24adeb6642" args="()" -->
563
509
<div class="memitem">
564
510
<div class="memproto">
565
511
      <table class="memname">
566
512
        <tr>
567
513
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>&lt;bool&gt; Gtk::MenuShell::property_take_focus </td>
568
514
          <td>(</td>
569
 
          <td class="paramname"> </td>
 
515
          <td class="paramname"></td>
570
516
          <td>&#160;)&#160;</td>
571
517
          <td></td>
572
518
        </tr>
574
520
</div>
575
521
<div class="memdoc">
576
522
 
577
 
<p>
578
 
A boolean that determines whether the menu grabs the keyboard focus. <p>
579
 
You rarely need to use properties because there are get_ and set_ methods for almost all of them. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
 
523
<p>A boolean that determines whether the menu grabs the keyboard focus. </p>
 
524
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
 
525
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
580
526
 
581
527
</div>
582
 
</div><p>
583
 
<a class="anchor" name="882dab72c89e462a879a6b6179464cc2"></a><!-- doxytag: member="Gtk::MenuShell::select_first" ref="882dab72c89e462a879a6b6179464cc2" args="(bool search_sensitive=true)" -->
 
528
</div>
 
529
<a class="anchor" id="a882dab72c89e462a879a6b6179464cc2"></a><!-- doxytag: member="Gtk::MenuShell::select_first" ref="a882dab72c89e462a879a6b6179464cc2" args="(bool search_sensitive=true)" -->
584
530
<div class="memitem">
585
531
<div class="memproto">
586
532
      <table class="memname">
588
534
          <td class="memname">void Gtk::MenuShell::select_first </td>
589
535
          <td>(</td>
590
536
          <td class="paramtype">bool&#160;</td>
591
 
          <td class="paramname"> <em>search_sensitive</em> = <code>true</code> </td>
 
537
          <td class="paramname"> <em>search_sensitive</em> = <code>true</code></td>
592
538
          <td>&#160;)&#160;</td>
593
539
          <td></td>
594
540
        </tr>
596
542
</div>
597
543
<div class="memdoc">
598
544
 
599
 
<p>
600
 
Select the first visible or selectable child of the menu shell; don't select tearoff items unless the only item is a tearoff item. <p>
601
 
<dl compact><dt><b><a class="el" href="since_2_2.html#_since_2_2000102">Since gtkmm 2.2:</a></b></dt><dd></dd></dl>
602
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
545
<p>Select the first visible or selectable child of the menu shell; don't select tearoff items unless the only item is a tearoff item. </p>
 
546
<dl class="since_2_2"><dt><b><a class="el" href="since_2_2.html#_since_2_2000102">Since gtkmm 2.2:</a></b></dt><dd></dd></dl>
 
547
<dl><dt><b>Parameters:</b></dt><dd>
603
548
  <table border="0" cellspacing="2" cellpadding="0">
604
549
    <tr><td valign="top"></td><td valign="top"><em>search_sensitive</em>&#160;</td><td>If <code>true</code>, search for the first selectable menu item, otherwise select nothing if the first item isn't sensitive. This should be <code>false</code> if the menu is being popped up initially. </td></tr>
605
550
  </table>
 
551
  </dd>
606
552
</dl>
607
553
 
608
554
</div>
609
 
</div><p>
610
 
<a class="anchor" name="c38fde346621b24154540f83243956fd"></a><!-- doxytag: member="Gtk::MenuShell::select_item" ref="c38fde346621b24154540f83243956fd" args="(MenuItem &amp;menu_item)" -->
 
555
</div>
 
556
<a class="anchor" id="ac38fde346621b24154540f83243956fd"></a><!-- doxytag: member="Gtk::MenuShell::select_item" ref="ac38fde346621b24154540f83243956fd" args="(MenuItem &amp;menu_item)" -->
611
557
<div class="memitem">
612
558
<div class="memproto">
613
559
      <table class="memname">
615
561
          <td class="memname">void Gtk::MenuShell::select_item </td>
616
562
          <td>(</td>
617
563
          <td class="paramtype"><a class="el" href="classGtk_1_1MenuItem.html">MenuItem</a>&amp;&#160;</td>
618
 
          <td class="paramname"> <em>menu_item</em> </td>
 
564
          <td class="paramname"> <em>menu_item</em></td>
619
565
          <td>&#160;)&#160;</td>
620
566
          <td></td>
621
567
        </tr>
623
569
</div>
624
570
<div class="memdoc">
625
571
 
626
 
<p>
627
 
 
628
 
</div>
629
 
</div><p>
630
 
<a class="anchor" name="c076143bf45a4c69cd65965a7779a963"></a><!-- doxytag: member="Gtk::MenuShell::set_take_focus" ref="c076143bf45a4c69cd65965a7779a963" args="(bool take_focus=true)" -->
 
572
</div>
 
573
</div>
 
574
<a class="anchor" id="ac076143bf45a4c69cd65965a7779a963"></a><!-- doxytag: member="Gtk::MenuShell::set_take_focus" ref="ac076143bf45a4c69cd65965a7779a963" args="(bool take_focus=true)" -->
631
575
<div class="memitem">
632
576
<div class="memproto">
633
577
      <table class="memname">
635
579
          <td class="memname">void Gtk::MenuShell::set_take_focus </td>
636
580
          <td>(</td>
637
581
          <td class="paramtype">bool&#160;</td>
638
 
          <td class="paramname"> <em>take_focus</em> = <code>true</code> </td>
 
582
          <td class="paramname"> <em>take_focus</em> = <code>true</code></td>
639
583
          <td>&#160;)&#160;</td>
640
584
          <td></td>
641
585
        </tr>
643
587
</div>
644
588
<div class="memdoc">
645
589
 
646
 
<p>
647
 
If <em>take_focus</em> is <code>true</code> (the default) the menu shell will take the keyboard focus so that it will receive all keyboard events which is needed to enable keyboard navigation in menus. <p>
648
 
Setting <em>take_focus</em> to <code>false</code> is useful only for special applications like virtual keyboard implementations which should not take keyboard focus.<p>
649
 
The <em>take_focus</em> state of a menu or menu bar is automatically propagated to submenus whenever a submenu is popped up, so you don't have to worry about recursively setting it for your entire menu hierarchy. Only when programmatically picking a submenu and popping it up manually, the <em>take_focus</em> property of the submenu needs to be set explicitely.<p>
650
 
Note that setting it to <code>false</code> has side-effects:<p>
651
 
If the focus is in some other app, it keeps the focus and keynav in the menu doesn't work. Consequently, keynav on the menu will only work if the focus is on some toplevel owned by the onscreen keyboard.<p>
652
 
To avoid confusing the user, menus with <em>take_focus</em> set to <code>false</code> should not display mnemonics or accelerators, since it cannot be guaranteed that they will work.<p>
653
 
See also gdk_keyboard_grab()<p>
654
 
<dl compact><dt><b><a class="el" href="since_2_8.html#_since_2_8000033">Since gtkmm 2.8:</a></b></dt><dd></dd></dl>
655
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
590
<p>If <em>take_focus</em> is <code>true</code> (the default) the menu shell will take the keyboard focus so that it will receive all keyboard events which is needed to enable keyboard navigation in menus. </p>
 
591
<p>Setting <em>take_focus</em> to <code>false</code> is useful only for special applications like virtual keyboard implementations which should not take keyboard focus.</p>
 
592
<p>The <em>take_focus</em> state of a menu or menu bar is automatically propagated to submenus whenever a submenu is popped up, so you don't have to worry about recursively setting it for your entire menu hierarchy. Only when programmatically picking a submenu and popping it up manually, the <em>take_focus</em> property of the submenu needs to be set explicitely.</p>
 
593
<p>Note that setting it to <code>false</code> has side-effects:</p>
 
594
<p>If the focus is in some other app, it keeps the focus and keynav in the menu doesn't work. Consequently, keynav on the menu will only work if the focus is on some toplevel owned by the onscreen keyboard.</p>
 
595
<p>To avoid confusing the user, menus with <em>take_focus</em> set to <code>false</code> should not display mnemonics or accelerators, since it cannot be guaranteed that they will work.</p>
 
596
<p>See also gdk_keyboard_grab()</p>
 
597
<dl class="since_2_8"><dt><b><a class="el" href="since_2_8.html#_since_2_8000033">Since gtkmm 2.8:</a></b></dt><dd></dd></dl>
 
598
<dl><dt><b>Parameters:</b></dt><dd>
656
599
  <table border="0" cellspacing="2" cellpadding="0">
657
600
    <tr><td valign="top"></td><td valign="top"><em>take_focus</em>&#160;</td><td><code>true</code> if the menu shell should take the keyboard focus on popup. </td></tr>
658
601
  </table>
 
602
  </dd>
659
603
</dl>
660
604
 
661
605
</div>
662
 
</div><p>
663
 
<a class="anchor" name="14c8a5dcb0d5afa8b1ab93ae149cf603"></a><!-- doxytag: member="Gtk::MenuShell::signal_deactivate" ref="14c8a5dcb0d5afa8b1ab93ae149cf603" args="()" -->
 
606
</div>
 
607
<a class="anchor" id="a14c8a5dcb0d5afa8b1ab93ae149cf603"></a><!-- doxytag: member="Gtk::MenuShell::signal_deactivate" ref="a14c8a5dcb0d5afa8b1ab93ae149cf603" args="()" -->
664
608
<div class="memitem">
665
609
<div class="memproto">
666
610
      <table class="memname">
667
611
        <tr>
668
612
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>&lt; void &gt; Gtk::MenuShell::signal_deactivate </td>
669
613
          <td>(</td>
670
 
          <td class="paramname"> </td>
 
614
          <td class="paramname"></td>
671
615
          <td>&#160;)&#160;</td>
672
616
          <td></td>
673
617
        </tr>
674
618
      </table>
675
619
</div>
676
620
<div class="memdoc">
677
 
 
678
 
<p>
679
 
<dl class="user" compact><dt><b>Prototype:</b></dt><dd><code>void on_my_deactivate()</code> </dd></dl>
680
 
 
681
 
</div>
682
 
</div><p>
683
 
<a class="anchor" name="29358f68b2c16afdab5147f7021368e8"></a><!-- doxytag: member="Gtk::MenuShell::signal_move_selected" ref="29358f68b2c16afdab5147f7021368e8" args="()" -->
 
621
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_deactivate()</code> </dd></dl>
 
622
 
 
623
</div>
 
624
</div>
 
625
<a class="anchor" id="a29358f68b2c16afdab5147f7021368e8"></a><!-- doxytag: member="Gtk::MenuShell::signal_move_selected" ref="a29358f68b2c16afdab5147f7021368e8" args="()" -->
684
626
<div class="memitem">
685
627
<div class="memproto">
686
628
      <table class="memname">
687
629
        <tr>
688
630
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>&lt; gboolean,int &gt; Gtk::MenuShell::signal_move_selected </td>
689
631
          <td>(</td>
690
 
          <td class="paramname"> </td>
 
632
          <td class="paramname"></td>
691
633
          <td>&#160;)&#160;</td>
692
634
          <td></td>
693
635
        </tr>
694
636
      </table>
695
637
</div>
696
638
<div class="memdoc">
697
 
 
698
 
<p>
699
 
<dl class="user" compact><dt><b>Prototype:</b></dt><dd><code>gboolean on_my_move_selected(int distance)</code> </dd></dl>
700
 
 
701
 
</div>
702
 
</div><p>
703
 
<a class="anchor" name="fe3aa91d39c133487f5ee87afdf3e255"></a><!-- doxytag: member="Gtk::MenuShell::signal_selection_done" ref="fe3aa91d39c133487f5ee87afdf3e255" args="()" -->
 
639
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>gboolean on_my_move_selected(int distance)</code> </dd></dl>
 
640
 
 
641
</div>
 
642
</div>
 
643
<a class="anchor" id="afe3aa91d39c133487f5ee87afdf3e255"></a><!-- doxytag: member="Gtk::MenuShell::signal_selection_done" ref="afe3aa91d39c133487f5ee87afdf3e255" args="()" -->
704
644
<div class="memitem">
705
645
<div class="memproto">
706
646
      <table class="memname">
707
647
        <tr>
708
648
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>&lt; void &gt; Gtk::MenuShell::signal_selection_done </td>
709
649
          <td>(</td>
710
 
          <td class="paramname"> </td>
 
650
          <td class="paramname"></td>
711
651
          <td>&#160;)&#160;</td>
712
652
          <td></td>
713
653
        </tr>
714
654
      </table>
715
655
</div>
716
656
<div class="memdoc">
717
 
 
718
 
<p>
719
 
<dl class="user" compact><dt><b>Prototype:</b></dt><dd><code>void on_my_selection_done()</code> </dd></dl>
720
 
 
721
 
</div>
722
 
</div><p>
723
 
<hr><h2>Friends And Related Function Documentation</h2>
724
 
<a class="anchor" name="5a3342e817b330a6b353d25c37ea2359"></a><!-- doxytag: member="Gtk::MenuShell::wrap" ref="5a3342e817b330a6b353d25c37ea2359" args="(GtkMenuShell *object, bool take_copy=false)" -->
 
657
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_selection_done()</code> </dd></dl>
 
658
 
 
659
</div>
 
660
</div>
 
661
<hr/><h2>Friends And Related Function Documentation</h2>
 
662
<a class="anchor" id="a5a3342e817b330a6b353d25c37ea2359"></a><!-- doxytag: member="Gtk::MenuShell::wrap" ref="a5a3342e817b330a6b353d25c37ea2359" args="(GtkMenuShell *object, bool take_copy=false)" -->
725
663
<div class="memitem">
726
664
<div class="memproto">
727
665
      <table class="memname">
746
684
</div>
747
685
<div class="memdoc">
748
686
 
749
 
<p>
750
 
A <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <p>
751
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
687
<p>A <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
 
688
<dl><dt><b>Parameters:</b></dt><dd>
752
689
  <table border="0" cellspacing="2" cellpadding="0">
753
690
    <tr><td valign="top"></td><td valign="top"><em>object</em>&#160;</td><td>The C instance. </td></tr>
754
691
    <tr><td valign="top"></td><td valign="top"><em>take_copy</em>&#160;</td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
755
692
  </table>
 
693
  </dd>
756
694
</dl>
757
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
 
695
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
758
696
 
759
697
</div>
760
 
</div><p>
761
 
<hr>The documentation for this class was generated from the following file:<ul>
762
 
<li>gtkmm/menushell.h</ul>
763
 
</div>
764
 
<hr size="1"><address style="text-align: right;"><small>Generated on Sun Sep 6 18:45:30 2009 for gtkmm by&#160;
 
698
</div>
 
699
<hr/>The documentation for this class was generated from the following file:<ul>
 
700
<li>gtkmm/menushell.h</li>
 
701
</ul>
 
702
</div>
 
703
<hr size="1"/><address style="text-align: right;"><small>Generated on Mon Sep 21 16:34:38 2009 for gtkmm by&#160;
765
704
<a href="http://www.doxygen.org/index.html">
766
 
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 
705
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
767
706
</body>
768
707
</html>