gtk2/docs/reference/gtk/tmpl/gtkmenutoolbutton.sgml

137 lines
2.7 KiB
Plaintext
Raw Normal View History

<!-- ##### SECTION Title ##### -->
GtkMenuToolButton
<!-- ##### SECTION Short_Description ##### -->
2004-10-11 20:15:30 +00:00
A GtkToolItem containing a button with an additional dropdown menu
<!-- ##### 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
create a new #GtkMenuToolButton containing a stock item.
</para>
<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 &lt;child&gt; 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>
<!-- ##### SECTION See_Also ##### -->
<para>
<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>
</para>
2005-05-05 19:49:30 +00:00
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### SECTION Image ##### -->
<!-- ##### STRUCT GtkMenuToolButton ##### -->
<para>
The #GtkMenuToolButton struct contains only private data and
should only be accessed through the functions described below.
</para>
<!-- ##### SIGNAL GtkMenuToolButton::show-menu ##### -->
<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:
<!-- ##### 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: