← Back to branch summary

~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/GtkMenu.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2010-06-11 12:19:30 UTC
  • mfrom: (1.11.6 upstream)
  • mto: This revision was merged to the branch mainline in revision 175.
  • Revision ID: james.westby@ubuntu.com-20100611121930-n4pklvkoqdsg12vm
Tags: 2.21.2-1
* New upstream development release:
  + debian/rules,
    debian/libgtk2.0-0.symbols:
    - Update for new API symbols.
  + debian/patches/070_mandatory-relibtoolize.patch:
    - Regenerated for the new version.
  + debian/control.in:
    - Update GLib (build-) dependency to >= 2.25.8.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkMenu.html
55
55
                    <a class="link" href="GtkMenu.html#GtkMenu-struct" title="GtkMenu">GtkMenu</a>;
56
56
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a>*          <a class="link" href="GtkMenu.html#gtk-menu-new" title="gtk_menu_new ()">gtk_menu_new</a>                        (<em class="parameter"><code><span class="type">void</span></code></em>);
57
57
<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-screen" title="gtk_menu_set_screen ()">gtk_menu_set_screen</a>                 (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
58
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);
 
58
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);
59
59
#define             <a class="link" href="GtkMenu.html#gtk-menu-append" title="gtk_menu_append()">gtk_menu_append</a>                     (menu,
60
60
                                                         child)
61
61
#define             <a class="link" href="GtkMenu.html#gtk-menu-prepend" title="gtk_menu_prepend()">gtk_menu_prepend</a>                    (menu,
65
65
                                                         pos)
66
66
<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-reorder-child" title="gtk_menu_reorder_child ()">gtk_menu_reorder_child</a>              (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
67
67
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
68
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);
 
68
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);
69
69
<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-attach" title="gtk_menu_attach ()">gtk_menu_attach</a>                     (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
70
70
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
71
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> left_attach</code></em>,
72
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> right_attach</code></em>,
73
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> top_attach</code></em>,
74
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> bottom_attach</code></em>);
 
71
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> left_attach</code></em>,
 
72
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> right_attach</code></em>,
 
73
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> top_attach</code></em>,
 
74
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> bottom_attach</code></em>);
75
75
<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-popup" title="gtk_menu_popup ()">gtk_menu_popup</a>                      (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
76
76
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_shell</code></em>,
77
77
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_item</code></em>,
78
78
                                                         <em class="parameter"><code><a class="link" href="GtkMenu.html#GtkMenuPositionFunc" title="GtkMenuPositionFunc ()"><span class="type">GtkMenuPositionFunc</span></a> func</code></em>,
79
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
80
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> button</code></em>,
81
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> activate_time</code></em>);
 
79
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
 
80
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> button</code></em>,
 
81
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> activate_time</code></em>);
82
82
<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-accel-group" title="gtk_menu_set_accel_group ()">gtk_menu_set_accel_group</a>            (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
83
83
                                                         <em class="parameter"><code><a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> *accel_group</code></em>);
84
84
<a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="returnvalue">GtkAccelGroup</span></a>*      <a class="link" href="GtkMenu.html#gtk-menu-get-accel-group" title="gtk_menu_get_accel_group ()">gtk_menu_get_accel_group</a>            (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
85
85
<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-accel-path" title="gtk_menu_set_accel_path ()">gtk_menu_set_accel_path</a>             (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
86
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *accel_path</code></em>);
87
 
const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        <a class="link" href="GtkMenu.html#gtk-menu-get-accel-path" title="gtk_menu_get_accel_path ()">gtk_menu_get_accel_path</a>             (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
 
86
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *accel_path</code></em>);
 
87
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        <a class="link" href="GtkMenu.html#gtk-menu-get-accel-path" title="gtk_menu_get_accel_path ()">gtk_menu_get_accel_path</a>             (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
88
88
<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-title" title="gtk_menu_set_title ()">gtk_menu_set_title</a>                  (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
89
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>);
90
 
const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="GtkMenu.html#gtk-menu-get-title" title="gtk_menu_get_title ()">gtk_menu_get_title</a>                  (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
 
89
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>);
 
90
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="GtkMenu.html#gtk-menu-get-title" title="gtk_menu_get_title ()">gtk_menu_get_title</a>                  (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
91
91
<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-monitor" title="gtk_menu_set_monitor ()">gtk_menu_set_monitor</a>                (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
92
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> monitor_num</code></em>);
93
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkMenu.html#gtk-menu-get-monitor" title="gtk_menu_get_monitor ()">gtk_menu_get_monitor</a>                (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
94
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkMenu.html#gtk-menu-get-tearoff-state" title="gtk_menu_get_tearoff_state ()">gtk_menu_get_tearoff_state</a>          (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
 
92
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> monitor_num</code></em>);
 
93
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkMenu.html#gtk-menu-get-monitor" title="gtk_menu_get_monitor ()">gtk_menu_get_monitor</a>                (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
 
94
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkMenu.html#gtk-menu-get-tearoff-state" title="gtk_menu_get_tearoff_state ()">gtk_menu_get_tearoff_state</a>          (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
95
95
<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-reserve-toggle-size" title="gtk_menu_set_reserve_toggle_size ()">gtk_menu_set_reserve_toggle_size</a>    (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
96
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> reserve_toggle_size</code></em>);
97
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkMenu.html#gtk-menu-get-reserve-toggle-size" title="gtk_menu_get_reserve_toggle_size ()">gtk_menu_get_reserve_toggle_size</a>    (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
 
96
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> reserve_toggle_size</code></em>);
 
97
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkMenu.html#gtk-menu-get-reserve-toggle-size" title="gtk_menu_get_reserve_toggle_size ()">gtk_menu_get_reserve_toggle_size</a>    (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
98
98
 
99
99
<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-popdown" title="gtk_menu_popdown ()">gtk_menu_popdown</a>                    (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
100
100
<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-reposition" title="gtk_menu_reposition ()">gtk_menu_reposition</a>                 (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
101
101
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a>*          <a class="link" href="GtkMenu.html#gtk-menu-get-active" title="gtk_menu_get_active ()">gtk_menu_get_active</a>                 (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
102
102
<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-active" title="gtk_menu_set_active ()">gtk_menu_set_active</a>                 (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
103
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index_</code></em>);
 
103
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index_</code></em>);
104
104
<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-set-tearoff-state" title="gtk_menu_set_tearoff_state ()">gtk_menu_set_tearoff_state</a>          (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
105
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> torn_off</code></em>);
 
105
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> torn_off</code></em>);
106
106
<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-attach-to-widget" title="gtk_menu_attach_to_widget ()">gtk_menu_attach_to_widget</a>           (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
107
107
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *attach_widget</code></em>,
108
108
                                                         <em class="parameter"><code><a class="link" href="GtkMenu.html#GtkMenuDetachFunc" title="GtkMenuDetachFunc ()"><span class="type">GtkMenuDetachFunc</span></a> detacher</code></em>);
109
109
<span class="returnvalue">void</span>                <a class="link" href="GtkMenu.html#gtk-menu-detach" title="gtk_menu_detach ()">gtk_menu_detach</a>                     (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
110
110
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a>*          <a class="link" href="GtkMenu.html#gtk-menu-get-attach-widget" title="gtk_menu_get_attach_widget ()">gtk_menu_get_attach_widget</a>          (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
111
 
<a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a>*              <a class="link" href="GtkMenu.html#gtk-menu-get-for-attach-widget" title="gtk_menu_get_for_attach_widget ()">gtk_menu_get_for_attach_widget</a>      (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);
 
111
<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a>*              <a class="link" href="GtkMenu.html#gtk-menu-get-for-attach-widget" title="gtk_menu_get_for_attach_widget ()">gtk_menu_get_for_attach_widget</a>      (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);
112
112
<span class="returnvalue">void</span>                (<a class="link" href="GtkMenu.html#GtkMenuPositionFunc" title="GtkMenuPositionFunc ()">*GtkMenuPositionFunc</a>)              (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
113
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>,
114
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>,
115
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *push_in</code></em>,
116
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
 
113
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>,
 
114
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>,
 
115
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *push_in</code></em>,
 
116
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
117
117
<span class="returnvalue">void</span>                (<a class="link" href="GtkMenu.html#GtkMenuDetachFunc" title="GtkMenuDetachFunc ()">*GtkMenuDetachFunc</a>)                (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *attach_widget</code></em>,
118
118
                                                         <em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);
119
119
</pre>
121
121
<div class="refsect1" title="Object Hierarchy">
122
122
<a name="GtkMenu.object-hierarchy"></a><h2>Object Hierarchy</h2>
123
123
<pre class="synopsis">
124
 
  <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
125
 
   +----<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
 
124
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
125
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
126
126
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
127
127
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
128
128
                     +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
141
141
<a name="GtkMenu.properties"></a><h2>Properties</h2>
142
142
<pre class="synopsis">
143
143
  "<a class="link" href="GtkMenu.html#GtkMenu--accel-group" title='The "accel-group" property'>accel-group</a>"              <a class="link" href="gtk-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a>*        : Read / Write
144
 
  "<a class="link" href="GtkMenu.html#GtkMenu--accel-path" title='The "accel-path" property'>accel-path</a>"               <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
145
 
  "<a class="link" href="GtkMenu.html#GtkMenu--active" title='The "active" property'>active</a>"                   <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 
144
  "<a class="link" href="GtkMenu.html#GtkMenu--accel-path" title='The "accel-path" property'>accel-path</a>"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
 
145
  "<a class="link" href="GtkMenu.html#GtkMenu--active" title='The "active" property'>active</a>"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
146
146
  "<a class="link" href="GtkMenu.html#GtkMenu--attach-widget" title='The "attach-widget" property'>attach-widget</a>"            <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Read / Write
147
 
  "<a class="link" href="GtkMenu.html#GtkMenu--monitor" title='The "monitor" property'>monitor</a>"                  <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
148
 
  "<a class="link" href="GtkMenu.html#GtkMenu--reserve-toggle-size" title='The "reserve-toggle-size" property'>reserve-toggle-size</a>"      <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
149
 
  "<a class="link" href="GtkMenu.html#GtkMenu--tearoff-state" title='The "tearoff-state" property'>tearoff-state</a>"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
150
 
  "<a class="link" href="GtkMenu.html#GtkMenu--tearoff-title" title='The "tearoff-title" property'>tearoff-title</a>"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
 
147
  "<a class="link" href="GtkMenu.html#GtkMenu--monitor" title='The "monitor" property'>monitor</a>"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 
148
  "<a class="link" href="GtkMenu.html#GtkMenu--reserve-toggle-size" title='The "reserve-toggle-size" property'>reserve-toggle-size</a>"      <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
149
  "<a class="link" href="GtkMenu.html#GtkMenu--tearoff-state" title='The "tearoff-state" property'>tearoff-state</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
150
  "<a class="link" href="GtkMenu.html#GtkMenu--tearoff-title" title='The "tearoff-title" property'>tearoff-title</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
151
151
</pre>
152
152
</div>
153
153
<div class="refsect1" title="Child Properties">
154
154
<a name="GtkMenu.child-properties"></a><h2>Child Properties</h2>
155
155
<pre class="synopsis">
156
 
  "<a class="link" href="GtkMenu.html#GtkMenu--c-bottom-attach" title='The "bottom-attach" child property'>bottom-attach</a>"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
157
 
  "<a class="link" href="GtkMenu.html#GtkMenu--c-left-attach" title='The "left-attach" child property'>left-attach</a>"              <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
158
 
  "<a class="link" href="GtkMenu.html#GtkMenu--c-right-attach" title='The "right-attach" child property'>right-attach</a>"             <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
159
 
  "<a class="link" href="GtkMenu.html#GtkMenu--c-top-attach" title='The "top-attach" child property'>top-attach</a>"               <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 
156
  "<a class="link" href="GtkMenu.html#GtkMenu--c-bottom-attach" title='The "bottom-attach" child property'>bottom-attach</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 
157
  "<a class="link" href="GtkMenu.html#GtkMenu--c-left-attach" title='The "left-attach" child property'>left-attach</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 
158
  "<a class="link" href="GtkMenu.html#GtkMenu--c-right-attach" title='The "right-attach" child property'>right-attach</a>"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
 
159
  "<a class="link" href="GtkMenu.html#GtkMenu--c-top-attach" title='The "top-attach" child property'>top-attach</a>"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
160
160
</pre>
161
161
</div>
162
162
<div class="refsect1" title="Style Properties">
163
163
<a name="GtkMenu.style-properties"></a><h2>Style Properties</h2>
164
164
<pre class="synopsis">
165
165
  "<a class="link" href="GtkMenu.html#GtkMenu--s-arrow-placement" title='The "arrow-placement" style property'>arrow-placement</a>"          <a class="link" href="gtk-Standard-Enumerations.html#GtkArrowPlacement" title="enum GtkArrowPlacement"><span class="type">GtkArrowPlacement</span></a>     : Read
166
 
  "<a class="link" href="GtkMenu.html#GtkMenu--s-arrow-scaling" title='The "arrow-scaling" style property'>arrow-scaling</a>"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read
167
 
  "<a class="link" href="GtkMenu.html#GtkMenu--s-double-arrows" title='The "double-arrows" style property'>double-arrows</a>"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read
168
 
  "<a class="link" href="GtkMenu.html#GtkMenu--s-horizontal-offset" title='The "horizontal-offset" style property'>horizontal-offset</a>"        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
169
 
  "<a class="link" href="GtkMenu.html#GtkMenu--s-horizontal-padding" title='The "horizontal-padding" style property'>horizontal-padding</a>"       <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
170
 
  "<a class="link" href="GtkMenu.html#GtkMenu--s-vertical-offset" title='The "vertical-offset" style property'>vertical-offset</a>"          <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
171
 
  "<a class="link" href="GtkMenu.html#GtkMenu--s-vertical-padding" title='The "vertical-padding" style property'>vertical-padding</a>"         <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 
166
  "<a class="link" href="GtkMenu.html#GtkMenu--s-arrow-scaling" title='The "arrow-scaling" style property'>arrow-scaling</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read
 
167
  "<a class="link" href="GtkMenu.html#GtkMenu--s-double-arrows" title='The "double-arrows" style property'>double-arrows</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read
 
168
  "<a class="link" href="GtkMenu.html#GtkMenu--s-horizontal-offset" title='The "horizontal-offset" style property'>horizontal-offset</a>"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 
169
  "<a class="link" href="GtkMenu.html#GtkMenu--s-horizontal-padding" title='The "horizontal-padding" style property'>horizontal-padding</a>"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 
170
  "<a class="link" href="GtkMenu.html#GtkMenu--s-vertical-offset" title='The "vertical-offset" style property'>vertical-offset</a>"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 
171
  "<a class="link" href="GtkMenu.html#GtkMenu--s-vertical-padding" title='The "vertical-padding" style property'>vertical-padding</a>"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
172
172
</pre>
173
173
</div>
174
174
<div class="refsect1" title="Signals">
199
199
can pop up a menu when the 3rd mouse button is pressed.
200
200
</p>
201
201
<div class="example">
202
 
<a name="id1043185"></a><p class="title"><b>Example 29. Connecting the popup signal handler.</b></p>
 
202
<a name="id919096"></a><p class="title"><b>Example 29. Connecting the popup signal handler.</b></p>
203
203
<div class="example-contents">
204
204
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
205
205
    <tbody>
208
208
2
209
209
3</pre></td>
210
210
        <td class="listing_code"><pre class="programlisting"><span class="comment">/* connect our handler which will popup the menu */</span>
211
 
<span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">window</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"button_press_event"</span><span class="symbol">,</span>
212
 
<span class="normal">   </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">my_popup_handler</span><span class="symbol">),</span><span class="normal"> menu</span><span class="symbol">);</span></pre></td>
 
211
<span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">window</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"button_press_event"</span><span class="symbol">,</span>
 
212
<span class="normal">    </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">my_popup_handler</span><span class="symbol">),</span><span class="normal"> menu</span><span class="symbol">);</span></pre></td>
213
213
      </tr>
214
214
    </tbody>
215
215
  </table>
217
217
 
218
218
</div>
219
219
<br class="example-break"><div class="example">
220
 
<a name="id1043200"></a><p class="title"><b>Example 30. Signal handler which displays a popup menu.</b></p>
 
220
<a name="id919112"></a><p class="title"><b>Example 30. Signal handler which displays a popup menu.</b></p>
221
221
<div class="example-contents">
222
222
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
223
223
    <tbody>
246
246
22
247
247
23
248
248
24</pre></td>
249
 
        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a></span>
250
 
<span class="function">my_popup_handler</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GtkWidget.html">GtkWidget</a> </span><span class="symbol">*</span><span class="normal">widget</span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/gdk/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> </span><span class="symbol">*</span><span class="normal">event</span><span class="symbol">)</span>
 
249
        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a></span>
 
250
<span class="function">my_popup_handler</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">widget</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">GdkEvent</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">event</span><span class="symbol">)</span>
251
251
<span class="cbracket">{</span>
252
 
<span class="normal">  <a href="GtkMenu.html">GtkMenu</a> </span><span class="symbol">*</span><span class="normal">menu</span><span class="symbol">;</span>
253
 
<span class="normal">  <a href="/usr/share/gtk-doc/html/gdk/gdk-Event-Structures.html#GdkEventButton">GdkEventButton</a> </span><span class="symbol">*</span><span class="normal">event_button</span><span class="symbol">;</span>
254
 
<span class="normal">  </span><span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget </span><span class="symbol">!=</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
255
 
<span class="normal">  </span><span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_IS_MENU</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">),</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
256
 
<span class="normal">  </span><span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event </span><span class="symbol">!=</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
 
252
<span class="normal">  </span><span class="usertype">GtkMenu</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">menu</span><span class="symbol">;</span>
 
253
<span class="normal">  </span><span class="usertype">GdkEventButton</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">event_button</span><span class="symbol">;</span>
 
254
<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget </span><span class="symbol">!=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
 
255
<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_IS_MENU</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">),</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
 
256
<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-return-val-if-fail">g_return_val_if_fail</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event </span><span class="symbol">!=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
257
257
<span class="normal">  </span><span class="comment">/* The "widget" is the menu that was supplied when</span>
258
258
<span class="comment">   * g_signal_connect_swapped() was called.</span>
259
259
<span class="comment">   */</span>
260
260
<span class="normal">  menu </span><span class="symbol">=</span><span class="normal"> </span><span class="function">GTK_MENU</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">);</span>
261
 
<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event</span><span class="symbol">-&gt;</span><span class="normal">type </span><span class="symbol">==</span><span class="normal"> <a href="/usr/share/gtk-doc/html/gdk/gdk-Events.html#GDK-BUTTON-PRESS:CAPS">GDK_BUTTON_PRESS</a></span><span class="symbol">)</span>
 
261
<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event</span><span class="symbol">-&gt;</span><span class="normal">type </span><span class="symbol">==</span><span class="normal"> <a href="http://library.gnome.org/devel/gdk/unstable/gdk-Events.html#GDK-BUTTON-PRESS:CAPS">GDK_BUTTON_PRESS</a></span><span class="symbol">)</span>
262
262
<span class="normal">    </span><span class="cbracket">{</span>
263
 
<span class="normal">      event_button </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="/usr/share/gtk-doc/html/gdk/gdk-Event-Structures.html#GdkEventButton">GdkEventButton</a> </span><span class="symbol">*)</span><span class="normal"> event</span><span class="symbol">;</span>
 
263
<span class="normal">      event_button </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="http://library.gnome.org/devel/gdk/unstable/gdk-Event-Structures.html#GdkEventButton">GdkEventButton</a> </span><span class="symbol">*)</span><span class="normal"> event</span><span class="symbol">;</span>
264
264
<span class="normal">      </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">event_button</span><span class="symbol">-&gt;</span><span class="normal">button </span><span class="symbol">==</span><span class="normal"> </span><span class="number">3</span><span class="symbol">)</span>
265
 
<span class="normal">   </span><span class="cbracket">{</span>
266
 
<span class="normal">     </span><span class="function"><a href="GtkMenu.html#gtk-menu-popup">gtk_menu_popup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">menu</span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span>
267
 
<span class="normal">                     event_button</span><span class="symbol">-&gt;</span><span class="normal">button</span><span class="symbol">,</span><span class="normal"> event_button</span><span class="symbol">-&gt;</span><span class="normal">time</span><span class="symbol">);</span>
268
 
<span class="normal">     </span><span class="keyword">return</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">;</span>
269
 
<span class="normal">   </span><span class="cbracket">}</span>
270
 
<span class="normal">    </span><span class="cbracket">}</span>
271
 
<span class="normal">  </span><span class="keyword">return</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">;</span>
 
265
<span class="normal">    </span><span class="cbracket">{</span>
 
266
<span class="normal">      </span><span class="function"><a href="GtkMenu.html#gtk-menu-popup">gtk_menu_popup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">menu</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span>
 
267
<span class="normal">              event_button</span><span class="symbol">-&gt;</span><span class="normal">button</span><span class="symbol">,</span><span class="normal"> event_button</span><span class="symbol">-&gt;</span><span class="normal">time</span><span class="symbol">);</span>
 
268
<span class="normal">      </span><span class="keyword">return</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">;</span>
 
269
<span class="normal">    </span><span class="cbracket">}</span>
 
270
<span class="normal">    </span><span class="cbracket">}</span>
 
271
<span class="normal">  </span><span class="keyword">return</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">;</span>
272
272
<span class="cbracket">}</span></pre></td>
273
273
      </tr>
274
274
    </tbody>
308
308
<div class="refsect2" title="gtk_menu_set_screen ()">
309
309
<a name="gtk-menu-set-screen"></a><h3>gtk_menu_set_screen ()</h3>
310
310
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_set_screen                 (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
311
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
 
311
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk/unstable/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
312
312
<p>
313
 
Sets the <a href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"><span class="type">GdkScreen</span></a> on which the menu will be displayed.
 
313
Sets the <a href="http://library.gnome.org/devel/gdk/unstable/GdkScreen.html"><span class="type">GdkScreen</span></a> on which the menu will be displayed.
314
314
</p>
315
315
<div class="variablelist"><table border="0">
316
316
<col align="left" valign="top">
322
322
</tr>
323
323
<tr>
324
324
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
325
 
<td> a <a href="/usr/share/gtk-doc/html/gdk/GdkScreen.html"><span class="type">GdkScreen</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the screen should be
 
325
<td> a <a href="http://library.gnome.org/devel/gdk/unstable/GdkScreen.html"><span class="type">GdkScreen</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the screen should be
326
326
         determined by the widget the menu is attached to. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
327
327
</td>
328
328
</tr>
426
426
<a name="gtk-menu-reorder-child"></a><h3>gtk_menu_reorder_child ()</h3>
427
427
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_reorder_child              (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
428
428
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
429
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
 
429
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> position</code></em>);</pre>
430
430
<p>
431
431
Moves a <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> to a new position within the <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>.
432
432
</p>
457
457
<a name="gtk-menu-attach"></a><h3>gtk_menu_attach ()</h3>
458
458
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_attach                     (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
459
459
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
460
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> left_attach</code></em>,
461
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> right_attach</code></em>,
462
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> top_attach</code></em>,
463
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> bottom_attach</code></em>);</pre>
 
460
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> left_attach</code></em>,
 
461
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> right_attach</code></em>,
 
462
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> top_attach</code></em>,
 
463
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> bottom_attach</code></em>);</pre>
464
464
<p>
465
465
Adds a new <a class="link" href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> to a (table) menu. The number of 'cells' that
466
466
an item will occupy is specified by <em class="parameter"><code>left_attach</code></em>, <em class="parameter"><code>right_attach</code></em>,
515
515
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_shell</code></em>,
516
516
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *parent_menu_item</code></em>,
517
517
                                                         <em class="parameter"><code><a class="link" href="GtkMenu.html#GtkMenuPositionFunc" title="GtkMenuPositionFunc ()"><span class="type">GtkMenuPositionFunc</span></a> func</code></em>,
518
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
519
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> button</code></em>,
520
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> activate_time</code></em>);</pre>
 
518
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
 
519
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> button</code></em>,
 
520
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> activate_time</code></em>);</pre>
521
521
<p>
522
522
Displays a menu and makes it available for selection.  Applications can use
523
523
this function to display context-sensitive menus, and will typically supply
524
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the <em class="parameter"><code>parent_menu_shell</code></em>, <em class="parameter"><code>parent_menu_item</code></em>, <em class="parameter"><code>func</code></em> and <em class="parameter"><code>data</code></em> 
 
524
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the <em class="parameter"><code>parent_menu_shell</code></em>, <em class="parameter"><code>parent_menu_item</code></em>, <em class="parameter"><code>func</code></em> and <em class="parameter"><code>data</code></em> 
525
525
parameters. The default menu positioning function will position the menu
526
526
at the current mouse cursor position.
527
527
</p>
549
549
</tr>
550
550
<tr>
551
551
<td><p><span class="term"><em class="parameter"><code>parent_menu_shell</code></em> :</span></p></td>
552
 
<td> the menu shell containing the triggering menu item, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
552
<td> the menu shell containing the triggering menu item, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
553
553
</td>
554
554
</tr>
555
555
<tr>
556
556
<td><p><span class="term"><em class="parameter"><code>parent_menu_item</code></em> :</span></p></td>
557
 
<td> the menu item whose activation triggered the popup, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
557
<td> the menu item whose activation triggered the popup, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
558
558
</td>
559
559
</tr>
560
560
<tr>
561
561
<td><p><span class="term"><em class="parameter"><code>func</code></em> :</span></p></td>
562
 
<td> a user supplied function used to position the menu, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
562
<td> a user supplied function used to position the menu, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
563
563
</td>
564
564
</tr>
565
565
<tr>
635
635
<div class="refsect2" title="gtk_menu_set_accel_path ()">
636
636
<a name="gtk-menu-set-accel-path"></a><h3>gtk_menu_set_accel_path ()</h3>
637
637
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_set_accel_path             (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
638
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *accel_path</code></em>);</pre>
 
638
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *accel_path</code></em>);</pre>
639
639
<p>
640
640
Sets an accelerator path for this menu from which accelerator paths
641
641
for its immediate children, its menu items, can be constructed.
654
654
and their default setups can be found at <a class="link" href="gtk-Accelerator-Maps.html#gtk-accel-map-add-entry" title="gtk_accel_map_add_entry ()"><code class="function">gtk_accel_map_add_entry()</code></a>.
655
655
</p>
656
656
<p>
657
 
Note that <em class="parameter"><code>accel_path</code></em> string will be stored in a <a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a>. Therefore, if you
 
657
Note that <em class="parameter"><code>accel_path</code></em> string will be stored in a <a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#GQuark"><span class="type">GQuark</span></a>. Therefore, if you
658
658
pass a static string, you can save some memory by interning it first with 
659
 
<a href="/usr/share/gtk-doc/html/glib/glib-Quarks.html#g-intern-static-string"><code class="function">g_intern_static_string()</code></a>.
 
659
<a href="http://library.gnome.org/devel/glib/unstable/glib-Quarks.html#g-intern-static-string"><code class="function">g_intern_static_string()</code></a>.
660
660
</p>
661
661
<div class="variablelist"><table border="0">
662
662
<col align="left" valign="top">
677
677
<hr>
678
678
<div class="refsect2" title="gtk_menu_get_accel_path ()">
679
679
<a name="gtk-menu-get-accel-path"></a><h3>gtk_menu_get_accel_path ()</h3>
680
 
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        gtk_menu_get_accel_path             (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
 
680
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        gtk_menu_get_accel_path             (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
681
681
<p>
682
682
Retrieves the accelerator path set on the menu.
683
683
</p>
703
703
<div class="refsect2" title="gtk_menu_set_title ()">
704
704
<a name="gtk-menu-set-title"></a><h3>gtk_menu_set_title ()</h3>
705
705
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_set_title                  (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
706
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>);</pre>
 
706
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>);</pre>
707
707
<p>
708
708
Sets the title string for the menu.  The title is displayed when the menu
709
 
is shown as a tearoff menu.  If <em class="parameter"><code>title</code></em> is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the menu will see if it is
 
709
is shown as a tearoff menu.  If <em class="parameter"><code>title</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the menu will see if it is
710
710
attached to a parent menu item, and if so it will try to use the same text as
711
711
that menu item's label.
712
712
</p>
729
729
<hr>
730
730
<div class="refsect2" title="gtk_menu_get_title ()">
731
731
<a name="gtk-menu-get-title"></a><h3>gtk_menu_get_title ()</h3>
732
 
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_menu_get_title                  (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
 
732
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gtk_menu_get_title                  (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
733
733
<p>
734
734
Returns the title of the menu. See <a class="link" href="GtkMenu.html#gtk-menu-set-title" title="gtk_menu_set_title ()"><code class="function">gtk_menu_set_title()</code></a>.
735
735
</p>
743
743
</tr>
744
744
<tr>
745
745
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
746
 
<td> the title of the menu, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the menu has no
 
746
<td> the title of the menu, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the menu has no
747
747
title set on it. This string is owned by the widget and should
748
748
not be modified or freed.
749
749
</td>
755
755
<div class="refsect2" title="gtk_menu_set_monitor ()">
756
756
<a name="gtk-menu-set-monitor"></a><h3>gtk_menu_set_monitor ()</h3>
757
757
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_set_monitor                (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
758
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> monitor_num</code></em>);</pre>
 
758
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> monitor_num</code></em>);</pre>
759
759
<p>
760
760
Informs GTK+ on which monitor a menu should be popped up. 
761
 
See <a href="/usr/share/gtk-doc/html/gdk/GdkScreen.html#gdk-screen-get-monitor-geometry"><code class="function">gdk_screen_get_monitor_geometry()</code></a>.
 
761
See <a href="http://library.gnome.org/devel/gdk/unstable/GdkScreen.html#gdk-screen-get-monitor-geometry"><code class="function">gdk_screen_get_monitor_geometry()</code></a>.
762
762
</p>
763
763
<p>
764
764
This function should be called from a <a class="link" href="GtkMenu.html#GtkMenuPositionFunc" title="GtkMenuPositionFunc ()"><span class="type">GtkMenuPositionFunc</span></a> if the
788
788
<hr>
789
789
<div class="refsect2" title="gtk_menu_get_monitor ()">
790
790
<a name="gtk-menu-get-monitor"></a><h3>gtk_menu_get_monitor ()</h3>
791
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_menu_get_monitor                (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
 
791
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_menu_get_monitor                (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
792
792
<p>
793
793
Retrieves the number of the monitor on which to show the menu.
794
794
</p>
814
814
<hr>
815
815
<div class="refsect2" title="gtk_menu_get_tearoff_state ()">
816
816
<a name="gtk-menu-get-tearoff-state"></a><h3>gtk_menu_get_tearoff_state ()</h3>
817
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_menu_get_tearoff_state          (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
 
817
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_menu_get_tearoff_state          (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
818
818
<p>
819
819
Returns whether the menu is torn off. See
820
820
<a class="link" href="GtkMenu.html#gtk-menu-set-tearoff-state" title="gtk_menu_set_tearoff_state ()"><code class="function">gtk_menu_set_tearoff_state()</code></a>.
829
829
</tr>
830
830
<tr>
831
831
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
832
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the menu is currently torn off.
 
832
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the menu is currently torn off.
833
833
</td>
834
834
</tr>
835
835
</tbody>
839
839
<div class="refsect2" title="gtk_menu_set_reserve_toggle_size ()">
840
840
<a name="gtk-menu-set-reserve-toggle-size"></a><h3>gtk_menu_set_reserve_toggle_size ()</h3>
841
841
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_set_reserve_toggle_size    (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
842
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> reserve_toggle_size</code></em>);</pre>
 
842
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> reserve_toggle_size</code></em>);</pre>
843
843
<p>
844
844
Sets whether the menu should reserve space for drawing toggles 
845
845
or icons, regardless of their actual presence.
864
864
<hr>
865
865
<div class="refsect2" title="gtk_menu_get_reserve_toggle_size ()">
866
866
<a name="gtk-menu-get-reserve-toggle-size"></a><h3>gtk_menu_get_reserve_toggle_size ()</h3>
867
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_menu_get_reserve_toggle_size    (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
 
867
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_menu_get_reserve_toggle_size    (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>);</pre>
868
868
<p>
869
869
Returns whether the menu reserves space for toggles and
870
870
icons, regardless of their actual presence.
948
948
<div class="refsect2" title="gtk_menu_set_active ()">
949
949
<a name="gtk-menu-set-active"></a><h3>gtk_menu_set_active ()</h3>
950
950
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_set_active                 (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
951
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index_</code></em>);</pre>
 
951
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index_</code></em>);</pre>
952
952
<p>
953
953
Selects the specified menu item within the menu.  This is used by the
954
954
<a class="link" href="GtkOptionMenu.html" title="GtkOptionMenu"><span class="type">GtkOptionMenu</span></a> and should not be used by anyone else.
974
974
<div class="refsect2" title="gtk_menu_set_tearoff_state ()">
975
975
<a name="gtk-menu-set-tearoff-state"></a><h3>gtk_menu_set_tearoff_state ()</h3>
976
976
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_menu_set_tearoff_state          (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
977
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> torn_off</code></em>);</pre>
 
977
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> torn_off</code></em>);</pre>
978
978
<p>
979
979
Changes the tearoff state of the menu.  A menu is normally displayed
980
980
as drop down menu which persists as long as the menu is active.  It can
991
991
</tr>
992
992
<tr>
993
993
<td><p><span class="term"><em class="parameter"><code>torn_off</code></em> :</span></p></td>
994
 
<td>If <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, menu is displayed as a tearoff menu.
 
994
<td>If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, menu is displayed as a tearoff menu.
995
995
</td>
996
996
</tr>
997
997
</tbody>
1073
1073
<hr>
1074
1074
<div class="refsect2" title="gtk_menu_get_for_attach_widget ()">
1075
1075
<a name="gtk-menu-get-for-attach-widget"></a><h3>gtk_menu_get_for_attach_widget ()</h3>
1076
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a>*              gtk_menu_get_for_attach_widget      (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);</pre>
 
1076
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a>*              gtk_menu_get_for_attach_widget      (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);</pre>
1077
1077
<p>
1078
1078
Returns a list of the menus which are attached to this widget.
1079
1079
This list is owned by GTK+ and must not be modified.
1099
1099
<div class="refsect2" title="GtkMenuPositionFunc ()">
1100
1100
<a name="GtkMenuPositionFunc"></a><h3>GtkMenuPositionFunc ()</h3>
1101
1101
<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkMenuPositionFunc)              (<em class="parameter"><code><a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> *menu</code></em>,
1102
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>,
1103
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>,
1104
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *push_in</code></em>,
1105
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 
1102
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *x</code></em>,
 
1103
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *y</code></em>,
 
1104
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *push_in</code></em>,
 
1105
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
1106
1106
<p>
1107
1107
A user function supplied when calling <a class="link" href="GtkMenu.html#gtk-menu-popup" title="gtk_menu_popup ()"><code class="function">gtk_menu_popup()</code></a> which controls the
1108
1108
positioning of the menu when it is displayed.  The function sets the <em class="parameter"><code>x</code></em>
1120
1120
</tr>
1121
1121
<tr>
1122
1122
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
1123
 
<td>address of the <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> representing the horizontal position where the
 
1123
<td>address of the <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> representing the horizontal position where the
1124
1124
menu shall be drawn.  This is an output parameter.
1125
1125
</td>
1126
1126
</tr>
1127
1127
<tr>
1128
1128
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
1129
 
<td>address of the <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> representing the vertical position where the
 
1129
<td>address of the <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> representing the vertical position where the
1130
1130
menu shall be drawn.  This is an output parameter.
1131
1131
</td>
1132
1132
</tr>
1133
1133
<tr>
1134
1134
<td><p><span class="term"><em class="parameter"><code>push_in</code></em> :</span></p></td>
1135
1135
<td>This parameter controls how menus placed outside the monitor are handled.
1136
 
        If this is set to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> and part of the menu is outside the monitor then
 
1136
        If this is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> and part of the menu is outside the monitor then
1137
1137
        GTK+ pushes the window into the visible area, effectively modifying the
1138
1138
        popup position.
1139
1139
        Note that moving and possibly resizing the menu around will alter the
1192
1192
<hr>
1193
1193
<div class="refsect2" title='The "accel-path" property'>
1194
1194
<a name="GtkMenu--accel-path"></a><h3>The <code class="literal">"accel-path"</code> property</h3>
1195
 
<pre class="programlisting">  "accel-path"               <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 
1195
<pre class="programlisting">  "accel-path"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
1196
1196
<p>
1197
1197
An accel path used to conveniently construct accel paths of child items.
1198
1198
</p>
1202
1202
<hr>
1203
1203
<div class="refsect2" title='The "active" property'>
1204
1204
<a name="GtkMenu--active"></a><h3>The <code class="literal">"active"</code> property</h3>
1205
 
<pre class="programlisting">  "active"                   <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 
1205
<pre class="programlisting">  "active"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
1206
1206
<p>
1207
1207
The index of the currently selected menu item, or -1 if no
1208
1208
menu item is selected.
1225
1225
<hr>
1226
1226
<div class="refsect2" title='The "monitor" property'>
1227
1227
<a name="GtkMenu--monitor"></a><h3>The <code class="literal">"monitor"</code> property</h3>
1228
 
<pre class="programlisting">  "monitor"                  <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 
1228
<pre class="programlisting">  "monitor"                  <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
1229
1229
<p>
1230
1230
The monitor the menu will be popped up on.
1231
1231
</p>
1236
1236
<hr>
1237
1237
<div class="refsect2" title='The "reserve-toggle-size" property'>
1238
1238
<a name="GtkMenu--reserve-toggle-size"></a><h3>The <code class="literal">"reserve-toggle-size"</code> property</h3>
1239
 
<pre class="programlisting">  "reserve-toggle-size"      <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
1239
<pre class="programlisting">  "reserve-toggle-size"      <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1240
1240
<p>
1241
1241
A boolean that indicates whether the menu reserves space for
1242
1242
toggles and icons, regardless of their actual presence.
1253
1253
<hr>
1254
1254
<div class="refsect2" title='The "tearoff-state" property'>
1255
1255
<a name="GtkMenu--tearoff-state"></a><h3>The <code class="literal">"tearoff-state"</code> property</h3>
1256
 
<pre class="programlisting">  "tearoff-state"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
1256
<pre class="programlisting">  "tearoff-state"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1257
1257
<p>
1258
1258
A boolean that indicates whether the menu is torn-off.
1259
1259
</p>
1263
1263
<hr>
1264
1264
<div class="refsect2" title='The "tearoff-title" property'>
1265
1265
<a name="GtkMenu--tearoff-title"></a><h3>The <code class="literal">"tearoff-title"</code> property</h3>
1266
 
<pre class="programlisting">  "tearoff-title"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 
1266
<pre class="programlisting">  "tearoff-title"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
1267
1267
<p>A title that may be displayed by the window manager when this menu is torn-off.</p>
1268
1268
<p>Default value: NULL</p>
1269
1269
</div>
1272
1272
<a name="GtkMenu.child-property-details"></a><h2>Child Property Details</h2>
1273
1273
<div class="refsect2" title='The "bottom-attach" child property'>
1274
1274
<a name="GtkMenu--c-bottom-attach"></a><h3>The <code class="literal">"bottom-attach"</code> child property</h3>
1275
 
<pre class="programlisting">  "bottom-attach"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 
1275
<pre class="programlisting">  "bottom-attach"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
1276
1276
<p>The row number to attach the bottom of the child to.</p>
1277
1277
<p>Allowed values: &gt;= G_MAXULONG</p>
1278
1278
<p>Default value: -1</p>
1280
1280
<hr>
1281
1281
<div class="refsect2" title='The "left-attach" child property'>
1282
1282
<a name="GtkMenu--c-left-attach"></a><h3>The <code class="literal">"left-attach"</code> child property</h3>
1283
 
<pre class="programlisting">  "left-attach"              <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 
1283
<pre class="programlisting">  "left-attach"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
1284
1284
<p>The column number to attach the left side of the child to.</p>
1285
1285
<p>Allowed values: &gt;= G_MAXULONG</p>
1286
1286
<p>Default value: -1</p>
1288
1288
<hr>
1289
1289
<div class="refsect2" title='The "right-attach" child property'>
1290
1290
<a name="GtkMenu--c-right-attach"></a><h3>The <code class="literal">"right-attach"</code> child property</h3>
1291
 
<pre class="programlisting">  "right-attach"             <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 
1291
<pre class="programlisting">  "right-attach"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
1292
1292
<p>The column number to attach the right side of the child to.</p>
1293
1293
<p>Allowed values: &gt;= G_MAXULONG</p>
1294
1294
<p>Default value: -1</p>
1296
1296
<hr>
1297
1297
<div class="refsect2" title='The "top-attach" child property'>
1298
1298
<a name="GtkMenu--c-top-attach"></a><h3>The <code class="literal">"top-attach"</code> child property</h3>
1299
 
<pre class="programlisting">  "top-attach"               <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 
1299
<pre class="programlisting">  "top-attach"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
1300
1300
<p>The row number to attach the top of the child to.</p>
1301
1301
<p>Allowed values: &gt;= G_MAXULONG</p>
1302
1302
<p>Default value: -1</p>
1316
1316
<hr>
1317
1317
<div class="refsect2" title='The "arrow-scaling" style property'>
1318
1318
<a name="GtkMenu--s-arrow-scaling"></a><h3>The <code class="literal">"arrow-scaling"</code> style property</h3>
1319
 
<pre class="programlisting">  "arrow-scaling"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read</pre>
 
1319
<pre class="programlisting">  "arrow-scaling"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read</pre>
1320
1320
<p>Arbitrary constant to scale down the size of the scroll arrow.</p>
1321
1321
<p>Allowed values: [0,1]</p>
1322
1322
<p>Default value: 0.7</p>
1324
1324
<hr>
1325
1325
<div class="refsect2" title='The "double-arrows" style property'>
1326
1326
<a name="GtkMenu--s-double-arrows"></a><h3>The <code class="literal">"double-arrows"</code> style property</h3>
1327
 
<pre class="programlisting">  "double-arrows"            <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read</pre>
 
1327
<pre class="programlisting">  "double-arrows"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read</pre>
1328
1328
<p>When scrolling, always show both arrows.</p>
1329
1329
<p>Default value: TRUE</p>
1330
1330
</div>
1331
1331
<hr>
1332
1332
<div class="refsect2" title='The "horizontal-offset" style property'>
1333
1333
<a name="GtkMenu--s-horizontal-offset"></a><h3>The <code class="literal">"horizontal-offset"</code> style property</h3>
1334
 
<pre class="programlisting">  "horizontal-offset"        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 
1334
<pre class="programlisting">  "horizontal-offset"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
1335
1335
<p>When the menu is a submenu, position it this number of pixels offset horizontally.</p>
1336
1336
<p>Default value: -2</p>
1337
1337
</div>
1338
1338
<hr>
1339
1339
<div class="refsect2" title='The "horizontal-padding" style property'>
1340
1340
<a name="GtkMenu--s-horizontal-padding"></a><h3>The <code class="literal">"horizontal-padding"</code> style property</h3>
1341
 
<pre class="programlisting">  "horizontal-padding"       <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 
1341
<pre class="programlisting">  "horizontal-padding"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
1342
1342
<p>Extra space at the left and right edges of the menu.</p>
1343
1343
<p>Allowed values: &gt;= 0</p>
1344
1344
<p>Default value: 0</p>
1346
1346
<hr>
1347
1347
<div class="refsect2" title='The "vertical-offset" style property'>
1348
1348
<a name="GtkMenu--s-vertical-offset"></a><h3>The <code class="literal">"vertical-offset"</code> style property</h3>
1349
 
<pre class="programlisting">  "vertical-offset"          <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 
1349
<pre class="programlisting">  "vertical-offset"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
1350
1350
<p>When the menu is a submenu, position it this number of pixels offset vertically.</p>
1351
1351
<p>Default value: 0</p>
1352
1352
</div>
1353
1353
<hr>
1354
1354
<div class="refsect2" title='The "vertical-padding" style property'>
1355
1355
<a name="GtkMenu--s-vertical-padding"></a><h3>The <code class="literal">"vertical-padding"</code> style property</h3>
1356
 
<pre class="programlisting">  "vertical-padding"         <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
 
1356
<pre class="programlisting">  "vertical-padding"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
1357
1357
<p>Extra space at the top and bottom of the menu.</p>
1358
1358
<p>Allowed values: &gt;= 0</p>
1359
1359
<p>Default value: 1</p>
1365
1365
<a name="GtkMenu-move-scroll"></a><h3>The <code class="literal">"move-scroll"</code> signal</h3>
1366
1366
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a>      *menu,
1367
1367
                                                        <a class="link" href="gtk-Standard-Enumerations.html#GtkScrollType" title="enum GtkScrollType"><span class="type">GtkScrollType</span></a> arg1,
1368
 
                                                        <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>      user_data)      : Run Last / Action</pre>
 
1368
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>      user_data)      : Run Last / Action</pre>
1369
1369
<p>
1370
1370
</p>
1371
1371
<div class="variablelist"><table border="0">