forked from AuroraMiddleware/gtk
356df7f650
Thu Oct 23 21:55:10 2003 Soeren Sandmann <sandmann@daimi.au.dk> * gtk/gtktoolbar.c (gtk_toolbar_highlight_drop_location): Make this function take an index and a GtkToolItem. * tests/testtoolbar.c (main): Make "Show Arrow" default to true. Make one of the separators !draw and expand. Update for new highlight_drop_location() API. * gtk/gtktoolitem.[ch]: Remove "pack_end" property * gtk/gtktoolbar.h: Formatting fixes. * gtk/gtktoolbar.c: Remove "pack_end" child property. Allow separator tool items to expand. (logical_to_physical, physical_to_logical): Fix off-by-one errors (Fix #125472, Marco Pesenti Gritti) * gtk/gtkseparatortoolitem.[ch]: Add new "draw" property. (gtk_separator_tool_item_expose) only draw if "draw" is TRUE. Also return FALSE, not TRUE. (gtk_separator_too_item_{set|get}_property, (gtk_separator_tool_item_{set|get}_draw): new functions
213 lines
3.6 KiB
Plaintext
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>
|
|
|
|
|
|
<!-- ##### 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:
|
|
|
|
|
|
<!-- ##### 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>
|
|
|