gtk2/docs/reference/gtk/tmpl/gtktoolbutton.sgml
Owen Taylor 85c05a86c0 === Released 2.3.1 ===
Mon Dec  8 10:54:44 2003  Owen Taylor  <otaylor@redhat.com>

        * === Released 2.3.1 ===

        * NEWS: Updates for 2.3.1

        * configure.in: Version 2.3.1, interface age 0, binary age 301.

        * gtk/gtkmenuitem.c (gtk_menu_item_can_activate_accel):
        Rename from gtk_menu_item_real_can_activate_accel() to
        match GTK+ convention, improve comment.

        * gtk/gtkwidget.c: Document gtk_widget_can_activate_accel(),
        can ::can-activate-accel signal.

        * gtk/gtkwidget.c (closure_accel_activate): Fix spelling
        in comment.

        * gtk/gtkmenu.c (gtk_menu_real_can_activate_accel): Clean
        up comment.

        * gtk/gtkcellview{,menuitem}.[ch]: Move GET_PRIVATE() macros
        into the .c file.

Mon Dec  8 12:09:21 2003  Owen Taylor  <otaylor@redhat.com>

        * gtk/gtkicontheme.c (find_builtin_icon): Fix a
        missing 'else'. (#128816, Jorn Baayen)
2003-12-08 22:55:03 +00:00

213 lines
3.6 KiB
Plaintext

<!-- ##### SECTION Title ##### -->
GtkToolButton
<!-- ##### SECTION Short_Description ##### -->
A #GtkToolItem subclass that displays buttons
<!-- ##### SECTION Long_Description ##### -->
<para>
#GtkToolButton<!-- -->s are #GtkToolItems containing buttons.
</para>
<para>
Use gtk_tool_button_new() to create a new #GtkToolButton. Use
gtk_tool_button_new_with_stock() to create a #GtkToolButton
containing a stock item.
</para>
<para>
The label of a #GtkToolButton is determined by the properties
"label_widget", "label", and "stock_id". If "label_widget" is
non-%NULL, then that widget is used as the label. Otherwise, if
"label" is non-%NULL, that string is used as the label. Otherwise, if
"stock_id" is non-%NULL, the label is determined by the stock
item. Otherwise, the button does not have a label.
</para>
<para>
The icon of a #GtkToolButton is determined by the properties
"icon_widget" and "stock_id". If "icon_widget" is non-%NULL, then
that widget is used as the icon. Otherwise, if "stock_id" is
non-%NULL, the icon is determined by the stock item. Otherwise,
the button does not have a label.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
<variablelist>
<varlistentry>
<term>#GtkToolbar</term>
<listitem><para>The toolbar widget</para></listitem>
</varlistentry>
<varlistentry>
<term>#GtkToggleToolButton</term>
<listitem><para>A subclass of #GtkToolButton that displays toggle
buttons on the toolbar</para></listitem>
</varlistentry>
<varlistentry>
<term>#GtkRadioToolButton</term>
<listitem><para>A subclass of #GtkToolButton that displays radio
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>
</variablelist>
</para>
<!-- ##### STRUCT GtkToolButton ##### -->
<para>
The #GtkToolButton struct contains only private. It should only be
accessed with the function described below.
</para>
<!-- ##### SIGNAL GtkToolButton::clicked ##### -->
<para>
</para>
@toolbutton: the object which received the signal.
<!-- ##### ARG GtkToolButton:icon-widget ##### -->
<para>
</para>
<!-- ##### ARG GtkToolButton:label ##### -->
<para>
</para>
<!-- ##### ARG GtkToolButton:label-widget ##### -->
<para>
</para>
<!-- ##### ARG GtkToolButton:stock-id ##### -->
<para>
</para>
<!-- ##### ARG GtkToolButton:use-underline ##### -->
<para>
</para>
<!-- ##### FUNCTION gtk_tool_button_new ##### -->
<para>
</para>
@icon_widget:
@label:
@Returns:
<!-- ##### FUNCTION gtk_tool_button_new_from_stock ##### -->
<para>
</para>
@stock_id:
@Returns:
<!-- ##### FUNCTION gtk_tool_button_set_label ##### -->
<para>
</para>
@button:
@label:
<!-- ##### FUNCTION gtk_tool_button_get_label ##### -->
<para>
</para>
@button:
@Returns:
<!-- ##### FUNCTION gtk_tool_button_set_use_underline ##### -->
<para>
</para>
@button:
@use_underline:
<!-- ##### FUNCTION gtk_tool_button_get_use_underline ##### -->
<para>
</para>
@button:
@Returns:
<!-- ##### FUNCTION gtk_tool_button_set_stock_id ##### -->
<para>
</para>
@button:
@stock_id:
<!-- ##### FUNCTION gtk_tool_button_get_stock_id ##### -->
<para>
</para>
@button:
@Returns:
<!-- ##### FUNCTION gtk_tool_button_set_icon_widget ##### -->
<para>
</para>
@button:
@icon_widget:
<!-- ##### FUNCTION gtk_tool_button_get_icon_widget ##### -->
<para>
</para>
@button:
@Returns:
<!-- ##### FUNCTION gtk_tool_button_set_label_widget ##### -->
<para>
</para>
@button:
@label_widget:
<!-- ##### FUNCTION gtk_tool_button_get_label_widget ##### -->
<para>
</para>
@button:
@Returns: