2004-09-27 18:37:33 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GtkMenuToolButton
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2004-10-11 20:15:30 +00:00
|
|
|
A GtkToolItem containing a button with an additional dropdown menu
|
2004-09-27 18:37:33 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
|
|
|
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.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
Use gtk_menu_tool_button_new() to create a new
|
2005-05-05 19:49:30 +00:00
|
|
|
#GtkMenuToolButton. Use gtk_menu_tool_button_new_from_stock() to
|
2004-09-27 18:37:33 +00:00
|
|
|
create a new #GtkMenuToolButton containing a stock item.
|
|
|
|
</para>
|
2011-01-09 04:10:40 +00:00
|
|
|
<refsect2 id="GtkMenuToolButton-BUILDER-UI">
|
|
|
|
<title>GtkMenuToolButton as GtkBuildable</title>
|
|
|
|
<para>
|
|
|
|
The GtkMenuToolButton implementation of the GtkBuildable interface
|
|
|
|
supports adding a menu by specifying "menu" as the "type"
|
|
|
|
attribute of a <child> element.
|
|
|
|
</para>
|
|
|
|
<example>
|
|
|
|
<title>A UI definition fragment with menus</title>
|
|
|
|
<programlisting><![CDATA[
|
|
|
|
<object class="GtkMenuToolButton">
|
|
|
|
<child type="menu">
|
|
|
|
<object class="GtkMenu"/>
|
|
|
|
</child>
|
|
|
|
</object>
|
|
|
|
]]></programlisting>
|
|
|
|
</example>
|
|
|
|
</refsect2>
|
2004-09-27 18:37:33 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
2009-07-28 08:21:49 +00:00
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
|
|
<term>#GtkToolbar</term>
|
|
|
|
<listitem><para>The toolbar widget</para></listitem>
|
|
|
|
<term>#GtkToolButton</term>
|
|
|
|
<listitem>
|
|
|
|
<para>
|
|
|
|
The parent class of #GtkMenuToolButton. The properties
|
|
|
|
"label_widget", "label", "icon_widget", and "stock_id" on
|
|
|
|
#GtkToolButton determine the label and icon used on
|
|
|
|
#GtkMenuToolButton<!-- -->s.
|
|
|
|
</para>
|
|
|
|
</listitem>
|
|
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
2004-09-27 18:37:33 +00:00
|
|
|
</para>
|
|
|
|
|
2005-05-05 19:49:30 +00:00
|
|
|
<!-- ##### SECTION Stability_Level ##### -->
|
|
|
|
|
|
|
|
|
2010-05-08 05:18:53 +00:00
|
|
|
<!-- ##### SECTION Image ##### -->
|
|
|
|
|
|
|
|
|
2004-09-27 18:37:33 +00:00
|
|
|
<!-- ##### STRUCT GtkMenuToolButton ##### -->
|
|
|
|
<para>
|
|
|
|
The #GtkMenuToolButton struct contains only private data and
|
|
|
|
should only be accessed through the functions described below.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
2004-10-05 14:19:54 +00:00
|
|
|
<!-- ##### SIGNAL GtkMenuToolButton::show-menu ##### -->
|
2004-09-27 18:37:33 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@menutoolbutton: the object which received the signal.
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkMenuToolButton:menu ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_menu_tool_button_new ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@icon_widget:
|
|
|
|
@label:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_menu_tool_button_new_from_stock ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@stock_id:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_menu_tool_button_set_menu ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@button:
|
|
|
|
@menu:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_menu_tool_button_get_menu ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@button:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2007-07-20 23:16:43 +00:00
|
|
|
<!-- ##### FUNCTION gtk_menu_tool_button_set_arrow_tooltip_text ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@button:
|
|
|
|
@text:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_menu_tool_button_set_arrow_tooltip_markup ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@button:
|
|
|
|
@markup:
|
|
|
|
|
|
|
|
|