<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" >
<head><meta content="text/html;charset=&quot;utf-8&quot;" http-equiv="Content-type"/><link href="faldoc.css" rel="stylesheet" type="text/css"/><title> - Class GtkMenuToolButton</title></head><body class="faldoc"><ul class="navi_top"><li class="top"><a href="index.html">Top: Table of contents</a></li>
<li class="up"><a href="gtk.html">Up: The Falcon GTK Binding module</a></li>
<li class="prev"><a href="gtk_GtkMenuShell.html">Previous: Class GtkMenuShell</a></li>
<li class="next"><a href="gtk_GtkMessageDialog.html">Next: Class GtkMessageDialog</a></li>
<li class="clear"></li>
</ul><div id="page_body"><h1><span class="toc_number">10.87</span>Class GtkMenuToolButton</h1><p class="brief">A GtkToolItem containing a button with an additional dropdown menu </p>
<pre class="prototype">Class GtkMenuToolButton( icon_widget, label )</pre>
<table class="prototype">
<tbody><tr class="param"><td class="name">icon_widget</td><td class="content"> a widget that will be used as icon widget, or NULL. </td></tr>
<tr class="param"><td class="name">label</td><td class="content"> a string that will be used as label, or NULL. </td></tr>
</tbody>
</table>
<p>A GtkMenuToolButton is a GtkToolItem that contains a button and a small additional button with an arrow. When clicked, the arrow button pops up a dropdown menu. </p>
<table class="members">
<tbody><tr class="member_type"><td class="member_type" colspan="2">Methods</td></tr>
<tr><td><a href="#get_menu">get_menu</a></td><td>Gets the GtkMenu associated with GtkMenuToolButton. </td></tr>
<tr><td><a href="#new_from_stock">new_from_stock</a></td><td>Creates a new GtkMenuToolButton. </td></tr>
<tr><td><a href="#set_arrow_tooltip_markup">set_arrow_tooltip_markup</a></td><td>Sets the tooltip markup text to be used as tooltip for the arrow button which pops up the menu. </td></tr>
<tr><td><a href="#set_arrow_tooltip_text">set_arrow_tooltip_text</a></td><td>Sets the tooltip text to be used as tooltip for the arrow button which pops up the menu. </td></tr>
<tr><td><a href="#set_menu">set_menu</a></td><td>Sets the GtkMenu that is popped up when the user clicks on the arrow. </td></tr>
<tr><td><a href="#signal_show_menu">signal_show_menu</a></td><td>The show-menu signal is emitted before the menu is shown. </td></tr>
</tbody>
</table>
<h2>Methods</h2><h3><a name="get_menu">get_menu</a></h3><p class="brief">Gets the GtkMenu associated with GtkMenuToolButton. </p>
<pre class="prototype">GtkMenuToolButton.get_menu()</pre>
<table class="prototype">
<tbody><tr class="return"><td class="name">Return</td><td class="content">the GtkMenu associated with GtkMenuToolButton </td></tr>
</tbody>
</table>
<h3><a name="new_from_stock">new_from_stock</a></h3><p class="brief">Creates a new GtkMenuToolButton. </p>
<pre class="prototype">GtkMenuToolButton.new_from_stock( stock_id )</pre>
<table class="prototype">
<tbody><tr class="param"><td class="name">stock_id</td><td class="content"> the name of a stock item </td></tr>
<tr class="return"><td class="name">Return</td><td class="content">the new GtkMenuToolButton </td></tr>
</tbody>
</table>
<p>The new GtkMenuToolButton will contain an icon and label from the stock item indicated by stock_id. </p>
<h3><a name="set_arrow_tooltip_markup">set_arrow_tooltip_markup</a></h3><p class="brief">Sets the tooltip markup text to be used as tooltip for the arrow button which pops up the menu. </p>
<pre class="prototype">GtkMenuToolButton.set_arrow_tooltip_markup( markup )</pre>
<table class="prototype">
<tbody><tr class="param"><td class="name">markup</td><td class="content"> markup text to be used as tooltip text for button's arrow button </td></tr>
</tbody>
</table>
<p>See gtk_tool_item_set_tooltip() for setting a tooltip on the whole GtkMenuToolButton. </p>
<h3><a name="set_arrow_tooltip_text">set_arrow_tooltip_text</a></h3><p class="brief">Sets the tooltip text to be used as tooltip for the arrow button which pops up the menu. </p>
<pre class="prototype">GtkMenuToolButton.set_arrow_tooltip_text( text )</pre>
<table class="prototype">
<tbody><tr class="param"><td class="name">text</td><td class="content"> text to be used as tooltip text for button's arrow button </td></tr>
</tbody>
</table>
<p>See gtk_tool_item_set_tooltip() for setting a tooltip on the whole GtkMenuToolButton. </p>
<h3><a name="set_menu">set_menu</a></h3><p class="brief">Sets the GtkMenu that is popped up when the user clicks on the arrow. </p>
<pre class="prototype">GtkMenuToolButton.set_menu( menu )</pre>
<table class="prototype">
<tbody><tr class="param"><td class="name">menu</td><td class="content"> the GtkMenu associated with GtkMenuToolButton, or nil. </td></tr>
</tbody>
</table>
<p>If menu is NULL, the arrow button becomes insensitive. </p>
<h3><a name="signal_show_menu">signal_show_menu</a></h3><p class="brief">The show-menu signal is emitted before the menu is shown. </p>
<pre class="prototype">GtkMenuToolButton.signal_show_menu()</pre>
<p>It can be used to populate the menu on demand, using gtk_menu_tool_button_get_menu(). </p>
<p>Note that even if you populate the menu dynamically in this way, you must set an empty menu on the GtkMenuToolButton beforehand, since the arrow is made insensitive if the menu is not set. </p>
</div><ul class="navi_bottom"><li class="top"><a href="index.html">Top: Table of contents</a></li>
<li class="up"><a href="gtk.html">Up: The Falcon GTK Binding module</a></li>
<li class="prev"><a href="gtk_GtkMenuShell.html">Previous: Class GtkMenuShell</a></li>
<li class="next"><a href="gtk_GtkMessageDialog.html">Next: Class GtkMessageDialog</a></li>
<li class="clear"></li>
</ul><div class="signature">Made with <a href="faldoc 3.0">http://www.falconpl.org</a></div></body></html>
