2003-07-13 20:51:14 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GtkToolItem
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2003-08-04 21:13:55 +00:00
|
|
|
#GtkToolItem is the base class of widgets that can be added to
|
|
|
|
#GtkToolbar.
|
2003-07-13 20:51:14 +00:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2003-08-04 21:13:55 +00:00
|
|
|
#GtkToolItem<!-- -->s are widgets that can appear on a toolbar. To
|
|
|
|
create a toolbar item that contain something else than a button, use
|
|
|
|
gtk_tool_item_new(). Use gtk_container_add() to add a child
|
|
|
|
widget to the tool item.
|
|
|
|
</para>
|
|
|
|
<para>
|
|
|
|
For toolbar items that contain buttons, see the #GtkToolButton,
|
|
|
|
#GtkToggleToolButton and #GtkRadioToolButton classes.
|
|
|
|
</para>
|
|
|
|
See the #GtkToolbar class for a description of the toolbar widget.
|
|
|
|
<para>
|
2003-07-13 20:51:14 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
|
2003-08-04 21:13:55 +00:00
|
|
|
<varlistentry>
|
|
|
|
<term>#GtkToolbar</term>
|
|
|
|
<listitem><para>The toolbar widget</para></listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>#GtkToolButton</term>
|
|
|
|
<listitem><para>A subclass of #GtkToolItem that displays buttons on
|
|
|
|
the toolbar</para></listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
<term>#GtkSeparatorToolItem</term>
|
|
|
|
<listitem><para>A subclass of #GtkToolItem that separates groups of
|
|
|
|
items on a toolbar</para></listitem>
|
|
|
|
</varlistentry>
|
|
|
|
|
2003-07-13 20:51:14 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GtkToolItem ##### -->
|
|
|
|
<para>
|
2003-08-04 21:13:55 +00:00
|
|
|
The GtkToolItem struct contains only private data. It should only be
|
|
|
|
accessed through the functions described below.
|
2003-07-13 20:51:14 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tool_item_new ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tool_item_set_homogeneous ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tool_item:
|
|
|
|
@homogeneous:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tool_item_get_homogeneous ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tool_item:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tool_item_set_expand ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tool_item:
|
|
|
|
@expand:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tool_item_get_expand ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tool_item:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tool_item_set_tooltip ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tool_item:
|
|
|
|
@tooltips:
|
|
|
|
@tip_text:
|
|
|
|
@tip_private:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tool_item_set_use_drag_window ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@toolitem:
|
|
|
|
@use_drag_window:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tool_item_get_use_drag_window ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@toolitem:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tool_item_set_visible_horizontal ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@toolitem:
|
|
|
|
@visible_horizontal:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tool_item_get_visible_horizontal ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@toolitem:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tool_item_set_visible_vertical ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@toolitem:
|
2003-08-04 21:13:55 +00:00
|
|
|
@visible_vertical:
|
2003-07-13 20:51:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_tool_item_get_visible_vertical ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@toolitem:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tool_item_set_is_important ##### -->
|
2003-07-13 20:51:14 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tool_item:
|
2003-10-24 22:16:07 +00:00
|
|
|
@is_important:
|
2003-07-13 20:51:14 +00:00
|
|
|
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tool_item_get_is_important ##### -->
|
2003-07-13 20:51:14 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tool_item:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tool_item_get_icon_size ##### -->
|
2003-07-13 20:51:14 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tool_item:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tool_item_get_orientation ##### -->
|
2003-07-13 20:51:14 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tool_item:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tool_item_get_toolbar_style ##### -->
|
2003-07-13 20:51:14 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tool_item:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tool_item_get_relief_style ##### -->
|
2003-07-13 20:51:14 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@tool_item:
|
2003-10-24 22:16:07 +00:00
|
|
|
@Returns:
|
2003-07-13 20:51:14 +00:00
|
|
|
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tool_item_retrieve_proxy_menu_item ##### -->
|
2003-07-28 16:08:20 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
@tool_item:
|
2003-07-28 16:08:20 +00:00
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tool_item_get_proxy_menu_item ##### -->
|
2003-07-28 16:08:20 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
@tool_item:
|
|
|
|
@menu_item_id:
|
|
|
|
@Returns:
|
2003-08-04 21:13:55 +00:00
|
|
|
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
<!-- ##### FUNCTION gtk_tool_item_set_proxy_menu_item ##### -->
|
2003-07-28 16:08:20 +00:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2003-10-24 22:16:07 +00:00
|
|
|
@tool_item:
|
|
|
|
@menu_item_id:
|
|
|
|
@menu_item:
|
2003-07-28 16:08:20 +00:00
|
|
|
|
|
|
|
|
2004-02-21 17:05:32 +00:00
|
|
|
<!-- ##### SIGNAL GtkToolItem::create-menu-proxy ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@toolitem: the object which received the signal.
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
<!-- ##### SIGNAL GtkToolItem::set-tooltip ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@toolitem: the object which received the signal.
|
|
|
|
@arg1:
|
|
|
|
@arg2:
|
|
|
|
@arg3:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
<!-- ##### SIGNAL GtkToolItem::toolbar-reconfigured ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@toolitem: the object which received the signal.
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkToolItem:is-important ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkToolItem:visible-horizontal ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkToolItem:visible-vertical ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|