<html> <head><title>Gtk-- Reference: Gtk::Menu</title></head> <body bgcolor="#F0F0F0" text="#000000" link="#0000FF" vlink="#000077" alink="#FF0000"> <table align=center border=0 cellspacing=10> <tr> <td><a href="class_index.html">Class Index</a></td> <td><a href="cross_index.html">Cross Index</a></td> <td><a href="name_index.html">Namespace Index</a></td> </table> <h1 align=center>Class Gtk::Menu</h1><p> <b> A drop down menu widget.</b><br> Contained in: <a href="Gtk.html">Gtk</a><br> Derived from: <a href="Gtk%3A%3AMenuShell.html">Gtk::MenuShell</a> <br> Derived by: <i>none</i> <p> #include <gtk--/menu.h> <p> <hr noshade> <table border=0> <tr><td colspan=3><h3>public function member index:</h3></td> <tr valign=top><td align=right><tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1890"><tt><font color=blue><b>Menu</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1909"><tt><font color=blue><b>detach</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3AAccelGroup.html"><tt><font color=navy><b>AccelGroup</b></font></tt></a>*</tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1902"><tt><font color=blue><b>ensure_uline_accel_group</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3AAccelGroup.html"><tt><font color=navy><b>AccelGroup</b></font></tt></a>*</tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1900"><tt><font color=blue><b>get_accel_group</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3AMenuItem.html"><tt><font color=navy><b>MenuItem</b></font></tt></a>*</tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1895"><tt><font color=blue><b>get_active</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3AWidget.html"><tt><font color=navy><b>Widget</b></font></tt></a>*</tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1908"><tt><font color=blue><b>get_attach_widget</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><a href="Gtk%3A%3AAccelGroup.html"><tt><font color=navy><b>AccelGroup</b></font></tt></a>*</tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1901"><tt><font color=blue><b>get_uline_accel_group</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>GtkMenu</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1886"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>const</tt> <tt><font color=navy>GtkMenu</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1887"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1888"><tt><font color=blue><b>isA</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1904"><tt><font color=blue><b>is_torn_off</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1894"><tt><font color=blue><b>popdown</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1891"><tt><font color=blue><b>popup</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AMenuShell.html"><tt><font color=navy><b>MenuShell</b></font></tt></a>& <tt><font color=blue>parent_menu_shell</font></tt>, <a href="Gtk%3A%3AMenuItem.html"><tt><font color=navy><b>MenuItem</b></font></tt></a>& <tt><font color=blue>parent_menu_item</font></tt>, <tt><font color=navy>GtkMenuPositionFunc</font></tt> <tt><font color=blue>func</font></tt>, <tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>, <tt><font color=purple>guint</font></tt> <tt><font color=blue>button</font></tt>, <tt><font color=purple>guint32</font></tt> <tt><font color=blue>activate_time</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1892"><tt><font color=blue><b>popup</b></font></tt></a></td><td><tt>(<tt><font color=navy>GtkMenuPositionFunc</font></tt> <tt><font color=blue>func</font></tt>, <tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>, <tt><font color=purple>guint</font></tt> <tt><font color=blue>button</font></tt>, <tt><font color=purple>guint32</font></tt> <tt><font color=blue>activate_time</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1893"><tt><font color=blue><b>popup</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>button</font></tt>, <tt><font color=purple>guint32</font></tt> <tt><font color=blue>activate_time</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1906"><tt><font color=blue><b>reorder_child</b></font></tt></a></td><td><tt>(<tt>const</tt> <a href="Gtk%3A%3AMenuItem.html"><tt><font color=navy><b>MenuItem</b></font></tt></a>& <tt><font color=blue>child</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>position</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1897"><tt><font color=blue><b>reposition</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1898"><tt><font color=blue><b>set_accel_group</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AAccelGroup.html"><tt><font color=navy><b>AccelGroup</b></font></tt></a>* <tt><font color=blue>accel_group</font></tt>=0)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1899"><tt><font color=blue><b>set_accel_group</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AAccelGroup.html"><tt><font color=navy><b>AccelGroup</b></font></tt></a>& <tt><font color=blue>accel_group</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1896"><tt><font color=blue><b>set_active</b></font></tt></a></td><td><tt>(<tt><font color=purple>gint</font></tt> <tt><font color=blue>index</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1903"><tt><font color=blue><b>set_tearoff_state</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>torn_off</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1905"><tt><font color=blue><b>set_title</b></font></tt></a></td><td><tt>(<tt>const</tt> <a href="Gtk%3A%3Anstring.html"><tt><font color=navy><b>nstring</b></font></tt></a>& <tt><font color=blue>title</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> </tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1889"><tt><font color=blue><b>~Menu</b></font></tt></a></td><td><tt>()</tt>;</td> <tr><td> </td><tr><td colspan=3><h3>protected function member index:</h3></td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AMenu.html#1907"><tt><font color=blue><b>attach_to_widget</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AWidget.html"><tt><font color=navy><b>Widget</b></font></tt></a>& <tt><font color=blue>widget</font></tt>, <tt><font color=navy>GtkMenuDetachFunc</font></tt> <tt><font color=blue>detacher</font></tt>)</tt>;</td> <tr><td> </td></table> <hr noshade> <h2>Description:</h2> A <tt><font color=navy><b>Gtk::Menu</b></font></tt> is a <tt><font color=navy><b>Gtk::MenuShell</b></font></tt> that implements a drop down menu consisting of a list of <tt><font color=navy><b>Gtk::MenuItem</b></font></tt> objects which can be navigated and activated by the user to perform application functions. <P> A <tt><font color=navy><b>Gtk::Menu</b></font></tt> is most commonly dropped down by activating a <tt><font color=navy><b>Gtk::MenuItem</b></font></tt> in a <tt><font color=navy><b>Gtk::MenuBar</b></font></tt> or popped up by activating a <tt><font color=navy><b>Gtk::MenuItem</b></font></tt> in another <tt><font color=navy><b>Gtk::Menu</b></font></tt>. <P> A <tt><font color=navy><b>Gtk::Menu</b></font></tt> can also be popped up by activating a <tt><font color=navy><b>Gtk::OptionMenu</b></font></tt>. Other composite widgets such as the <tt><font color=navy><b>Gtk::Notebook</b></font></tt> can pop up a <tt><font color=navy><b>Gtk::Menu</b></font></tt> as well. <P> Applications can display a <tt><font color=navy><b>Gtk::Menu</b></font></tt> as a popup menu by calling the <tt><font color=blue><b></b></font></tt> function.<br> <p> <hr noshade> <h2>Function Member Descriptions:</h2> <a name="1886"><font size=+1><b>Gtk::Menu::gtkobj</b></font></a> - Returns the underlaying gtk+ object.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=navy>GtkMenu</font></tt>*</tt> <a href="Gtk%3A%3AMenu.html#1886"><tt><font color=blue><b>gtkobj</b></font></tt></a><tt>()</tt>;<br><br> <a name="1888"><font size=+1><b>Gtk::Menu::isA</b></font></a> - Returns true if object is this type.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> <a href="Gtk%3A%3AMenu.html#1888"><tt><font color=blue><b>isA</b></font></tt></a><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;<br><br> <a name="1894"><font size=+1><b>Gtk::Menu::popdown</b></font></a> - Hides the menu away<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AMenu.html#1894"><tt><font color=blue><b>popdown</b></font></tt></a><tt>()</tt>;<br><br> <a name="1891"><font size=+1><b>Gtk::Menu::popup</b></font></a> - Display the menu on screen<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AMenu.html#1891"><tt><font color=blue><b>popup</b></font></tt></a><tt>(<a href="Gtk%3A%3AMenuShell.html"><tt><font color=navy><b>MenuShell</b></font></tt></a>& <tt><font color=blue>parent_menu_shell</font></tt>, <a href="Gtk%3A%3AMenuItem.html"><tt><font color=navy><b>MenuItem</b></font></tt></a>& <tt><font color=blue>parent_menu_item</font></tt>, <tt><font color=navy>GtkMenuPositionFunc</font></tt> <tt><font color=blue>func</font></tt>, <tt><font color=purple>gpointer</font></tt> <tt><font color=blue>data</font></tt>, <tt><font color=purple>guint</font></tt> <tt><font color=blue>button</font></tt>, <tt><font color=purple>guint32</font></tt> <tt><font color=blue>activate_time</font></tt>)</tt>;<br><br> <a name="1893"><font size=+1><b>Gtk::Menu::popup</b></font></a> - popup a floating menu<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AMenu.html#1893"><tt><font color=blue><b>popup</b></font></tt></a><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>button</font></tt>, <tt><font color=purple>guint32</font></tt> <tt><font color=blue>activate_time</font></tt>)</tt>;<br><br> <hr noshade> </html>