|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /usr/share/gtk-doc/html/gtk/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GtkToolbar</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="GTK+ Reference Manual">
<link rel="up" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="prev" href="GtkTearoffMenuItem.html" title="GtkTearoffMenuItem">
<link rel="next" href="GtkToolItem.html" title="GtkToolItem">
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="ch02.html" title="Widget Gallery">
<link rel="chapter" href="WindowWidgets.html" title="Windows">
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
<link rel="chapter" href="Ornaments.html" title="Ornaments">
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
<link rel="chapter" href="Printing.html" title="Printing">
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and
GtkComboBoxEntry">
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
<link rel="glossary" href="glossary.html" title="Glossary">
<link rel="index" href="ix01.html" title="Index">
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkTearoffMenuItem.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="MenusAndCombos.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ Reference Manual</th>
<td><a accesskey="n" href="GtkToolItem.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3306791" class="shortcut">Top</a>
 | 
<a href="#id3309712" class="shortcut">Description</a>
 | 
<a href="#id3309109" class="shortcut">Object Hierarchy</a>
 | 
<a href="#id3309163" class="shortcut">Implemented Interfaces</a>
 | 
<a href="#id3309186" class="shortcut">Properties</a>
 | 
<a href="#id3309306" class="shortcut">Child Properties</a>
 | 
<a href="#id3309357" class="shortcut">Style Properties</a>
 | 
<a href="#id3309476" class="shortcut">Signals</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="GtkToolbar"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id3306791"></a><span class="refentrytitle">GtkToolbar</span>
</h2>
<p>GtkToolbar — Create bars of buttons and other widgets</p>
</td>
<td valign="top" align="right"><img src="toolbar.png"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
#include <gtk/gtk.h>
<a href="GtkToolbar.html#GtkToolbar-struct">GtkToolbar</a>;
enum <a href="GtkToolbar.html#GtkToolbarChildType">GtkToolbarChildType</a>;
enum <a href="GtkToolbar.html#GtkToolbarSpaceStyle">GtkToolbarSpaceStyle</a>;
<a href="GtkToolbar.html#GtkToolbarChild">GtkToolbarChild</a>;
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkToolbar.html#gtk-toolbar-new">gtk_toolbar_new</a> (void);
void <a href="GtkToolbar.html#gtk-toolbar-insert">gtk_toolbar_insert</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *item,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> pos);
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> <a href="GtkToolbar.html#gtk-toolbar-get-item-index">gtk_toolbar_get_item_index</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *item);
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> <a href="GtkToolbar.html#gtk-toolbar-get-n-items">gtk_toolbar_get_n_items</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);
<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a>* <a href="GtkToolbar.html#gtk-toolbar-get-nth-item">gtk_toolbar_get_nth_item</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> n);
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> <a href="GtkToolbar.html#gtk-toolbar-get-drop-index">gtk_toolbar_get_drop_index</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> y);
void <a href="GtkToolbar.html#gtk-toolbar-set-drop-highlight-item">gtk_toolbar_set_drop_highlight_item</a>
(<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> index_);
void <a href="GtkToolbar.html#gtk-toolbar-set-show-arrow">gtk_toolbar_set_show_arrow</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> show_arrow);
void <a href="GtkToolbar.html#gtk-toolbar-set-orientation">gtk_toolbar_set_orientation</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a> orientation);
void <a href="GtkToolbar.html#gtk-toolbar-set-tooltips">gtk_toolbar_set_tooltips</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> enable);
void <a href="GtkToolbar.html#gtk-toolbar-unset-icon-size">gtk_toolbar_unset_icon_size</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="GtkToolbar.html#gtk-toolbar-get-show-arrow">gtk_toolbar_get_show_arrow</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);
<a href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a> <a href="GtkToolbar.html#gtk-toolbar-get-orientation">gtk_toolbar_get_orientation</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);
<a href="gtk-Standard-Enumerations.html#GtkToolbarStyle">GtkToolbarStyle</a> <a href="GtkToolbar.html#gtk-toolbar-get-style">gtk_toolbar_get_style</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);
<a href="gtk-Themeable-Stock-Images.html#GtkIconSize">GtkIconSize</a> <a href="GtkToolbar.html#gtk-toolbar-get-icon-size">gtk_toolbar_get_icon_size</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="GtkToolbar.html#gtk-toolbar-get-tooltips">gtk_toolbar_get_tooltips</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);
<a href="gtk-Standard-Enumerations.html#GtkReliefStyle">GtkReliefStyle</a> <a href="GtkToolbar.html#gtk-toolbar-get-relief-style">gtk_toolbar_get_relief_style</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkToolbar.html#gtk-toolbar-append-item">gtk_toolbar_append_item</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon,
<a href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkToolbar.html#gtk-toolbar-prepend-item">gtk_toolbar_prepend_item</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon,
<a href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkToolbar.html#gtk-toolbar-insert-item">gtk_toolbar_insert_item</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon,
<a href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> position);
void <a href="GtkToolbar.html#gtk-toolbar-append-space">gtk_toolbar_append_space</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);
void <a href="GtkToolbar.html#gtk-toolbar-prepend-space">gtk_toolbar_prepend_space</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);
void <a href="GtkToolbar.html#gtk-toolbar-insert-space">gtk_toolbar_insert_space</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> position);
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkToolbar.html#gtk-toolbar-append-element">gtk_toolbar_append_element</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkToolbar.html#GtkToolbarChildType">GtkToolbarChildType</a> type,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon,
<a href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkToolbar.html#gtk-toolbar-prepend-element">gtk_toolbar_prepend_element</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkToolbar.html#GtkToolbarChildType">GtkToolbarChildType</a> type,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon,
<a href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkToolbar.html#gtk-toolbar-insert-element">gtk_toolbar_insert_element</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkToolbar.html#GtkToolbarChildType">GtkToolbarChildType</a> type,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon,
<a href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> position);
void <a href="GtkToolbar.html#gtk-toolbar-append-widget">gtk_toolbar_append_widget</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
const char *tooltip_text,
const char *tooltip_private_text);
void <a href="GtkToolbar.html#gtk-toolbar-prepend-widget">gtk_toolbar_prepend_widget</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
const char *tooltip_text,
const char *tooltip_private_text);
void <a href="GtkToolbar.html#gtk-toolbar-insert-widget">gtk_toolbar_insert_widget</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
const char *tooltip_text,
const char *tooltip_private_text,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> position);
void <a href="GtkToolbar.html#gtk-toolbar-set-style">gtk_toolbar_set_style</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="gtk-Standard-Enumerations.html#GtkToolbarStyle">GtkToolbarStyle</a> style);
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkToolbar.html#gtk-toolbar-insert-stock">gtk_toolbar_insert_stock</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *stock_id,
const char *tooltip_text,
const char *tooltip_private_text,
<a href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> position);
void <a href="GtkToolbar.html#gtk-toolbar-set-icon-size">gtk_toolbar_set_icon_size</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="gtk-Themeable-Stock-Images.html#GtkIconSize">GtkIconSize</a> icon_size);
void <a href="GtkToolbar.html#gtk-toolbar-remove-space">gtk_toolbar_remove_space</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> position);
void <a href="GtkToolbar.html#gtk-toolbar-unset-style">gtk_toolbar_unset_style</a> (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3309109"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a
href="../gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
+----<a
href="../gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
>GInitiallyUnowned</a>
+----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
+----<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
+----<a href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
+----GtkToolbar
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3309163"></a><h2>Implemented Interfaces</h2>
<p>
GtkToolbar implements
AtkImplementorIface.</p>
</div>
<div class="refsect1" lang="en">
<a name="id3309186"></a><h2>Properties</h2>
<pre class="synopsis">
"<a href="GtkToolbar.html#GtkToolbar--icon-size">icon-size</a>" <a href="gtk-Themeable-Stock-Images.html#GtkIconSize">GtkIconSize</a> : Read / Write
"<a href="GtkToolbar.html#GtkToolbar--icon-size-set">icon-size-set</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkToolbar.html#GtkToolbar--orientation">orientation</a>" <a href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a> : Read / Write
"<a href="GtkToolbar.html#GtkToolbar--show-arrow">show-arrow</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkToolbar.html#GtkToolbar--toolbar-style">toolbar-style</a>" <a href="gtk-Standard-Enumerations.html#GtkToolbarStyle">GtkToolbarStyle</a> : Read / Write
"<a href="GtkToolbar.html#GtkToolbar--tooltips">tooltips</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3309306"></a><h2>Child Properties</h2>
<pre class="synopsis">
"<a href="GtkToolbar.html#GtkToolbar--expand">expand</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
"<a href="GtkToolbar.html#GtkToolbar--homogeneous">homogeneous</a>" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3309357"></a><h2>Style Properties</h2>
<pre class="synopsis">
"<a href="GtkToolbar.html#GtkToolbar--button-relief">button-relief</a>" <a href="gtk-Standard-Enumerations.html#GtkReliefStyle">GtkReliefStyle</a> : Read
"<a href="GtkToolbar.html#GtkToolbar--internal-padding">internal-padding</a>" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read
"<a href="GtkToolbar.html#GtkToolbar--max-child-expand">max-child-expand</a>" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read
"<a href="GtkToolbar.html#GtkToolbar--shadow-type">shadow-type</a>" <a href="gtk-Standard-Enumerations.html#GtkShadowType">GtkShadowType</a> : Read
"<a href="GtkToolbar.html#GtkToolbar--space-size">space-size</a>" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read
"<a href="GtkToolbar.html#GtkToolbar--space-style">space-style</a>" <a href="GtkToolbar.html#GtkToolbarSpaceStyle">GtkToolbarSpaceStyle</a> : Read
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3309476"></a><h2>Signals</h2>
<pre class="synopsis">
"<a href="GtkToolbar.html#GtkToolbar-focus-home-or-end">focus-home-or-end</a>"
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> user_function (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> focus_home,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last / Action
"<a href="GtkToolbar.html#GtkToolbar-move-focus">move-focus</a>"
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> user_function (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="gtk-Standard-Enumerations.html#GtkDirectionType">GtkDirectionType</a> *dir,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last / Action
"<a href="GtkToolbar.html#GtkToolbar-orientation-changed">orientation-changed</a>"
void user_function (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a> orientation,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run first
"<a href="GtkToolbar.html#GtkToolbar-popup-context-menu">popup-context-menu</a>"
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> user_function (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> y,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> button,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last
"<a href="GtkToolbar.html#GtkToolbar-style-changed">style-changed</a>"
void user_function (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="gtk-Standard-Enumerations.html#GtkToolbarStyle">GtkToolbarStyle</a> style,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run first
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3309712"></a><h2>Description</h2>
<p>
A toolbar is created with a call to <a href="GtkToolbar.html#gtk-toolbar-new"><code class="function">gtk_toolbar_new()</code></a>.
</p>
<p>
A toolbar can contain instances of a subclass of <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>. To add
a <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> to the a toolbar, use <a href="GtkToolbar.html#gtk-toolbar-insert"><code class="function">gtk_toolbar_insert()</code></a>. To remove
an item from the toolbar use <a href="GtkContainer.html#gtk-container-remove"><code class="function">gtk_container_remove()</code></a>. To add a button
to the toolbar, add an instance of <a href="GtkToolButton.html" title="GtkToolButton"><span class="type">GtkToolButton</span></a>.
</p>
<p>
Toolbar items can be visually grouped by adding instances of
<a href="GtkSeparatorToolItem.html" title="GtkSeparatorToolItem"><span class="type">GtkSeparatorToolItem</span></a> to the toolbar. If a <a href="GtkSeparatorToolItem.html" title="GtkSeparatorToolItem"><span class="type">GtkSeparatorToolItem</span></a> has
the "expand" property set to <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><span class="type">TRUE</span></a> and the "draw" property set to
<a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><span class="type">FALSE</span></a> the effect is to force all following items to the end of the
toolbar.
</p>
<p>
Creating a context menu for the toolbar can be done by connecting to
the <a href="GtkToolbar.html#GtkToolbar-popup-context-menu"><span class="type">GtkToolbar::popup-context-menu</span></a> signal.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3309844"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id3309854"></a><h3>
<a name="GtkToolbar-struct"></a>GtkToolbar</h3>
<a class="indexterm" name="id3309867"></a><pre class="programlisting">typedef struct {
gint num_children;
GList *children;
GtkOrientation orientation;
GtkToolbarStyle style;
GtkIconSize icon_size;
GtkTooltips *tooltips;
} GtkToolbar;
</pre>
<p>
The <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> struct only contains private data and should only be
accessed through the function described below.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3309895"></a><h3>
<a name="GtkToolbarChildType"></a>enum GtkToolbarChildType</h3>
<a class="indexterm" name="id3309911"></a><pre class="programlisting">typedef enum
{
GTK_TOOLBAR_CHILD_SPACE,
GTK_TOOLBAR_CHILD_BUTTON,
GTK_TOOLBAR_CHILD_TOGGLEBUTTON,
GTK_TOOLBAR_CHILD_RADIOBUTTON,
GTK_TOOLBAR_CHILD_WIDGET
} GtkToolbarChildType;
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkToolbarChildType</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
<a href="GtkToolbar.html#GtkToolbarChildType"><span class="type">GtkToolbarChildType</span></a> is used to set the type of new elements that are added
to a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><a name="GTK-TOOLBAR-CHILD-SPACE:CAPS"></a><code class="literal">GTK_TOOLBAR_CHILD_SPACE</code></span></td>
<td>a space in the style of the toolbar's <a href="GtkToolbar.html#GtkToolbarSpaceStyle"><span class="type">GtkToolbarSpaceStyle</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GTK-TOOLBAR-CHILD-BUTTON:CAPS"></a><code class="literal">GTK_TOOLBAR_CHILD_BUTTON</code></span></td>
<td>a <a href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GTK-TOOLBAR-CHILD-TOGGLEBUTTON:CAPS"></a><code class="literal">GTK_TOOLBAR_CHILD_TOGGLEBUTTON</code></span></td>
<td>a <a href="GtkToggleButton.html" title="GtkToggleButton"><span class="type">GtkToggleButton</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GTK-TOOLBAR-CHILD-RADIOBUTTON:CAPS"></a><code class="literal">GTK_TOOLBAR_CHILD_RADIOBUTTON</code></span></td>
<td>a <a href="GtkRadioButton.html" title="GtkRadioButton"><span class="type">GtkRadioButton</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GTK-TOOLBAR-CHILD-WIDGET:CAPS"></a><code class="literal">GTK_TOOLBAR_CHILD_WIDGET</code></span></td>
<td>a standard <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3310118"></a><h3>
<a name="GtkToolbarSpaceStyle"></a>enum GtkToolbarSpaceStyle</h3>
<a class="indexterm" name="id3310131"></a><pre class="programlisting">typedef enum
{
GTK_TOOLBAR_SPACE_EMPTY,
GTK_TOOLBAR_SPACE_LINE
} GtkToolbarSpaceStyle;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3310147"></a><h3>
<a name="GtkToolbarChild"></a>GtkToolbarChild</h3>
<a class="indexterm" name="id3310162"></a><pre class="programlisting">typedef struct {
GtkToolbarChildType type;
GtkWidget *widget;
GtkWidget *icon;
GtkWidget *label;
} GtkToolbarChild;
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GtkToolbarChild</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3310192"></a><h3>
<a name="gtk-toolbar-new"></a>gtk_toolbar_new ()</h3>
<a class="indexterm" name="id3310204"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_toolbar_new (void);</pre>
<p>
Creates a new toolbar.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the newly-created toolbar.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3310244"></a><h3>
<a name="gtk-toolbar-insert"></a>gtk_toolbar_insert ()</h3>
<a class="indexterm" name="id3310259"></a><pre class="programlisting">void gtk_toolbar_insert (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *item,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> pos);</pre>
<p>
Insert a <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> into the toolbar at position <em class="parameter"><code>pos</code></em>. If <em class="parameter"><code>pos</code></em> is
0 the item is prepended to the start of the toolbar. If <em class="parameter"><code>pos</code></em> is
negative, the item is appended to the end of the toolbar.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>item</code></em> :</span></td>
<td> a <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>pos</code></em> :</span></td>
<td> the position of the new item
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3310398"></a><h3>
<a name="gtk-toolbar-get-item-index"></a>gtk_toolbar_get_item_index ()</h3>
<a class="indexterm" name="id3310414"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> gtk_toolbar_get_item_index (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *item);</pre>
<p>
Returns the position of <em class="parameter"><code>item</code></em> on the toolbar, starting from 0.
It is an error if <em class="parameter"><code>item</code></em> is not a child of the toolbar.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>item</code></em> :</span></td>
<td> a <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> that is a child of <em class="parameter"><code>toolbar</code></em>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the position of item on the toolbar.
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3310535"></a><h3>
<a name="gtk-toolbar-get-n-items"></a>gtk_toolbar_get_n_items ()</h3>
<a class="indexterm" name="id3310551"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> gtk_toolbar_get_n_items (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);</pre>
<p>
Returns the number of items on the toolbar.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the number of items on the toolbar
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3310624"></a><h3>
<a name="gtk-toolbar-get-nth-item"></a>gtk_toolbar_get_nth_item ()</h3>
<a class="indexterm" name="id3310639"></a><pre class="programlisting"><a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a>* gtk_toolbar_get_nth_item (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> n);</pre>
<p>
Returns the <em class="parameter"><code>n</code></em>'th item on <em class="parameter"><code>toolbar</code></em>, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if the
toolbar does not contain an <em class="parameter"><code>n</code></em>'th item.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>n</code></em> :</span></td>
<td> A position on the toolbar
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> The <em class="parameter"><code>n</code></em>'th <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> on <em class="parameter"><code>toolbar</code></em>, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if there
isn't an <em class="parameter"><code>n</code></em>'th item.
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3310802"></a><h3>
<a name="gtk-toolbar-get-drop-index"></a>gtk_toolbar_get_drop_index ()</h3>
<a class="indexterm" name="id3310818"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> gtk_toolbar_get_drop_index (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> y);</pre>
<p>
Returns the position corresponding to the indicated point on
<em class="parameter"><code>toolbar</code></em>. This is useful when dragging items to the toolbar:
this function returns the position a new item should be
inserted.
</p>
<p>
<em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em> are in <em class="parameter"><code>toolbar</code></em> coordinates.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
<td> x coordinate of a point on the toolbar
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
<td> y coordinate of a point on the toolbar
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> The position corresponding to the point (<em class="parameter"><code>x</code></em>, <em class="parameter"><code>y</code></em>) on the toolbar.
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3310974"></a><h3>
<a name="gtk-toolbar-set-drop-highlight-item"></a>gtk_toolbar_set_drop_highlight_item ()</h3>
<a class="indexterm" name="id3310991"></a><pre class="programlisting">void gtk_toolbar_set_drop_highlight_item
(<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkToolItem.html" title="GtkToolItem">GtkToolItem</a> *tool_item,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> index_);</pre>
<p>
Highlights <em class="parameter"><code>toolbar</code></em> to give an idea of what it would look like
if <em class="parameter"><code>item</code></em> was added to <em class="parameter"><code>toolbar</code></em> at the position indicated by <em class="parameter"><code>index_</code></em>.
If <em class="parameter"><code>item</code></em> is <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>, highlighting is turned off. In that case <em class="parameter"><code>index_</code></em>
is ignored.
</p>
<p>
The <em class="parameter"><code>tool_item</code></em> passed to this function must not be part of any widget
hierarchy. When an item is set as drop highlight item it can not
added to any widget hierarchy or used as highlight item for another
toolbar.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tool_item</code></em> :</span></td>
<td> a <a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a>, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> to turn of highlighting
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>index_</code></em> :</span></td>
<td> a position on <em class="parameter"><code>toolbar</code></em>
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3311181"></a><h3>
<a name="gtk-toolbar-set-show-arrow"></a>gtk_toolbar_set_show_arrow ()</h3>
<a class="indexterm" name="id3311197"></a><pre class="programlisting">void gtk_toolbar_set_show_arrow (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> show_arrow);</pre>
<p>
Sets whether to show an overflow menu when
<em class="parameter"><code>toolbar</code></em> doesn't have room for all items on it. If <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>,
items that there are not room are available through an
overflow menu.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>show_arrow</code></em> :</span></td>
<td> Whether to show an overflow menu
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3311299"></a><h3>
<a name="gtk-toolbar-set-orientation"></a>gtk_toolbar_set_orientation ()</h3>
<a class="indexterm" name="id3311313"></a><pre class="programlisting">void gtk_toolbar_set_orientation (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a> orientation);</pre>
<p>
Sets whether a toolbar should appear horizontally or vertically.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>orientation</code></em> :</span></td>
<td> a new <a href="gtk-Standard-Enumerations.html#GtkOrientation"><span class="type">GtkOrientation</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3311401"></a><h3>
<a name="gtk-toolbar-set-tooltips"></a>gtk_toolbar_set_tooltips ()</h3>
<a class="indexterm" name="id3311414"></a><pre class="programlisting">void gtk_toolbar_set_tooltips (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> enable);</pre>
<p>
Sets if the tooltips of a toolbar should be active or not.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>enable</code></em> :</span></td>
<td> set to <a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> to disable the tooltips, or <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> to enable them.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3311514"></a><h3>
<a name="gtk-toolbar-unset-icon-size"></a>gtk_toolbar_unset_icon_size ()</h3>
<a class="indexterm" name="id3311530"></a><pre class="programlisting">void gtk_toolbar_unset_icon_size (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_unset_icon_size</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Unsets toolbar icon size set with <a href="GtkToolbar.html#gtk-toolbar-set-icon-size"><code class="function">gtk_toolbar_set_icon_size()</code></a>, so that
user preferences will be used to determine the icon size.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3311612"></a><h3>
<a name="gtk-toolbar-get-show-arrow"></a>gtk_toolbar_get_show_arrow ()</h3>
<a class="indexterm" name="id3311628"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gtk_toolbar_get_show_arrow (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);</pre>
<p>
Returns whether the toolbar has an overflow menu.
See <a href="GtkToolbar.html#gtk-toolbar-set-show-arrow"><code class="function">gtk_toolbar_set_show_arrow()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the toolbar has an overflow menu.
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3311722"></a><h3>
<a name="gtk-toolbar-get-orientation"></a>gtk_toolbar_get_orientation ()</h3>
<a class="indexterm" name="id3311735"></a><pre class="programlisting"><a href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a> gtk_toolbar_get_orientation (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);</pre>
<p>
Retrieves the current orientation of the toolbar. See
<a href="GtkToolbar.html#gtk-toolbar-set-orientation"><code class="function">gtk_toolbar_set_orientation()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the orientation
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3311815"></a><h3>
<a name="gtk-toolbar-get-style"></a>gtk_toolbar_get_style ()</h3>
<a class="indexterm" name="id3311828"></a><pre class="programlisting"><a href="gtk-Standard-Enumerations.html#GtkToolbarStyle">GtkToolbarStyle</a> gtk_toolbar_get_style (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);</pre>
<p>
Retrieves whether the toolbar has text, icons, or both . See
<a href="GtkToolbar.html#gtk-toolbar-set-style"><code class="function">gtk_toolbar_set_style()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the current style of <em class="parameter"><code>toolbar</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3311913"></a><h3>
<a name="gtk-toolbar-get-icon-size"></a>gtk_toolbar_get_icon_size ()</h3>
<a class="indexterm" name="id3311927"></a><pre class="programlisting"><a href="gtk-Themeable-Stock-Images.html#GtkIconSize">GtkIconSize</a> gtk_toolbar_get_icon_size (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);</pre>
<p>
Retrieves the icon size for the toolbar. See <a href="GtkToolbar.html#gtk-toolbar-set-icon-size"><code class="function">gtk_toolbar_set_icon_size()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the current icon size for the icons on the toolbar.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3312006"></a><h3>
<a name="gtk-toolbar-get-tooltips"></a>gtk_toolbar_get_tooltips ()</h3>
<a class="indexterm" name="id3312019"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> gtk_toolbar_get_tooltips (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);</pre>
<p>
Retrieves whether tooltips are enabled. See
<a href="GtkToolbar.html#gtk-toolbar-set-tooltips"><code class="function">gtk_toolbar_set_tooltips()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if tooltips are enabled
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3312108"></a><h3>
<a name="gtk-toolbar-get-relief-style"></a>gtk_toolbar_get_relief_style ()</h3>
<a class="indexterm" name="id3312124"></a><pre class="programlisting"><a href="gtk-Standard-Enumerations.html#GtkReliefStyle">GtkReliefStyle</a> gtk_toolbar_get_relief_style (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);</pre>
<p>
Returns the relief style of buttons on <em class="parameter"><code>toolbar</code></em>. See
<a href="GtkButton.html#gtk-button-set-relief"><code class="function">gtk_button_set_relief()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> The relief style of buttons on <em class="parameter"><code>toolbar</code></em>.
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3312220"></a><h3>
<a name="gtk-toolbar-append-item"></a>gtk_toolbar_append_item ()</h3>
<a class="indexterm" name="id3312235"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_toolbar_append_item (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon,
<a href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_append_item</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Inserts a new item into the toolbar. You must specify the position
in the toolbar where it will be inserted.
</p>
<p>
<em class="parameter"><code>callback</code></em> must be a pointer to a function taking a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> and a gpointer as
arguments. Use the <a href="gtk-Types.html#GTK-SIGNAL-FUNC:CAPS"><code class="function">GTK_SIGNAL_FUNC()</code></a> to cast the function to <a href="gtk-Types.html#GtkSignalFunc"><span class="type">GtkSignalFunc</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>text</code></em> :</span></td>
<td> give your toolbar button a label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></td>
<td> a string that appears when the user holds the mouse over this item.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></td>
<td> use with <a href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>icon</code></em> :</span></td>
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that should be used as the button's icon.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td> the function to be executed when the button is pressed.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> a pointer to any data you wish to be passed to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the new toolbar item as a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3312513"></a><h3>
<a name="gtk-toolbar-prepend-item"></a>gtk_toolbar_prepend_item ()</h3>
<a class="indexterm" name="id3312528"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_toolbar_prepend_item (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon,
<a href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_prepend_item</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Adds a new button to the beginning (top or left edges) of the given toolbar.
</p>
<p>
<em class="parameter"><code>callback</code></em> must be a pointer to a function taking a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> and a gpointer as
arguments. Use the <a href="gtk-Types.html#GTK-SIGNAL-FUNC:CAPS"><code class="function">GTK_SIGNAL_FUNC()</code></a> to cast the function to <a href="gtk-Types.html#GtkSignalFunc"><span class="type">GtkSignalFunc</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>text</code></em> :</span></td>
<td> give your toolbar button a label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></td>
<td> a string that appears when the user holds the mouse over this item.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></td>
<td> use with <a href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>icon</code></em> :</span></td>
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that should be used as the button's icon.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td> the function to be executed when the button is pressed.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> a pointer to any data you wish to be passed to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the new toolbar item as a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3312805"></a><h3>
<a name="gtk-toolbar-insert-item"></a>gtk_toolbar_insert_item ()</h3>
<a class="indexterm" name="id3312821"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_toolbar_insert_item (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon,
<a href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> position);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_insert_item</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Inserts a new item into the toolbar. You must specify the position in the
toolbar where it will be inserted.
</p>
<p>
<em class="parameter"><code>callback</code></em> must be a pointer to a function taking a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> and a gpointer as
arguments. Use the <a href="gtk-Types.html#GTK-SIGNAL-FUNC:CAPS"><code class="function">GTK_SIGNAL_FUNC()</code></a> to cast the function to <a href="gtk-Types.html#GtkSignalFunc"><span class="type">GtkSignalFunc</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>text</code></em> :</span></td>
<td> give your toolbar button a label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></td>
<td> a string that appears when the user holds the mouse over this item.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></td>
<td> use with <a href="GtkTipsQuery.html" title="GtkTipsQuery"><span class="type">GtkTipsQuery</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>icon</code></em> :</span></td>
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that should be used as the button's icon.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td> the function to be executed when the button is pressed.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> a pointer to any data you wish to be passed to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>position</code></em> :</span></td>
<td> the number of widgets to insert this item after.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the new toolbar item as a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3313120"></a><h3>
<a name="gtk-toolbar-append-space"></a>gtk_toolbar_append_space ()</h3>
<a class="indexterm" name="id3313136"></a><pre class="programlisting">void gtk_toolbar_append_space (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_append_space</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Adds a new space to the end of the toolbar.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3313206"></a><h3>
<a name="gtk-toolbar-prepend-space"></a>gtk_toolbar_prepend_space ()</h3>
<a class="indexterm" name="id3313222"></a><pre class="programlisting">void gtk_toolbar_prepend_space (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_prepend_space</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Adds a new space to the beginning of the toolbar.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3313292"></a><h3>
<a name="gtk-toolbar-insert-space"></a>gtk_toolbar_insert_space ()</h3>
<a class="indexterm" name="id3313307"></a><pre class="programlisting">void gtk_toolbar_insert_space (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> position);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_insert_space</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Inserts a new space in the toolbar at the specified position.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>position</code></em> :</span></td>
<td> the number of widgets after which a space should be inserted.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3313401"></a><h3>
<a name="gtk-toolbar-append-element"></a>gtk_toolbar_append_element ()</h3>
<a class="indexterm" name="id3313417"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_toolbar_append_element (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkToolbar.html#GtkToolbarChildType">GtkToolbarChildType</a> type,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon,
<a href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_append_element</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Adds a new element to the end of a toolbar.
</p>
<p>
If <em class="parameter"><code>type</code></em> == <a href="GtkToolbar.html#GTK-TOOLBAR-CHILD-WIDGET:CAPS"><code class="literal">GTK_TOOLBAR_CHILD_WIDGET</code></a>, <em class="parameter"><code>widget</code></em> is used as the new element.
If <em class="parameter"><code>type</code></em> == <a href="GtkToolbar.html#GTK-TOOLBAR-CHILD-RADIOBUTTON:CAPS"><code class="literal">GTK_TOOLBAR_CHILD_RADIOBUTTON</code></a>, <em class="parameter"><code>widget</code></em> is used to determine
the radio group for the new element. In all other cases, <em class="parameter"><code>widget</code></em> must
be <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>.
</p>
<p>
<em class="parameter"><code>callback</code></em> must be a pointer to a function taking a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> and a gpointer as
arguments. Use the <a href="gtk-Types.html#GTK-SIGNAL-FUNC:CAPS"><code class="function">GTK_SIGNAL_FUNC()</code></a> to cast the function to <a href="gtk-Types.html#GtkSignalFunc"><span class="type">GtkSignalFunc</span></a>.</p>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>type</code></em> :</span></td>
<td> a value of type <a href="GtkToolbar.html#GtkToolbarChildType"><span class="type">GtkToolbarChildType</span></a> that determines what <em class="parameter"><code>widget</code></em> will be.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>text</code></em> :</span></td>
<td> the element's label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></td>
<td> the element's tooltip.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></td>
<td> used for context-sensitive help about this toolbar element.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>icon</code></em> :</span></td>
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that provides pictorial representation of the element's function.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td> the function to be executed when the button is pressed.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> any data you wish to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the new toolbar element as a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3313833"></a><h3>
<a name="gtk-toolbar-prepend-element"></a>gtk_toolbar_prepend_element ()</h3>
<a class="indexterm" name="id3313850"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_toolbar_prepend_element (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkToolbar.html#GtkToolbarChildType">GtkToolbarChildType</a> type,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon,
<a href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_prepend_element</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Adds a new element to the beginning of a toolbar.
</p>
<p>
If <em class="parameter"><code>type</code></em> == <a href="GtkToolbar.html#GTK-TOOLBAR-CHILD-WIDGET:CAPS"><code class="literal">GTK_TOOLBAR_CHILD_WIDGET</code></a>, <em class="parameter"><code>widget</code></em> is used as the new element.
If <em class="parameter"><code>type</code></em> == <a href="GtkToolbar.html#GTK-TOOLBAR-CHILD-RADIOBUTTON:CAPS"><code class="literal">GTK_TOOLBAR_CHILD_RADIOBUTTON</code></a>, <em class="parameter"><code>widget</code></em> is used to determine
the radio group for the new element. In all other cases, <em class="parameter"><code>widget</code></em> must
be <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>.
</p>
<p>
<em class="parameter"><code>callback</code></em> must be a pointer to a function taking a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> and a gpointer as
arguments. Use the <a href="gtk-Types.html#GTK-SIGNAL-FUNC:CAPS"><code class="function">GTK_SIGNAL_FUNC()</code></a> to cast the function to <a href="gtk-Types.html#GtkSignalFunc"><span class="type">GtkSignalFunc</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>type</code></em> :</span></td>
<td> a value of type <a href="GtkToolbar.html#GtkToolbarChildType"><span class="type">GtkToolbarChildType</span></a> that determines what <em class="parameter"><code>widget</code></em> will be.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>text</code></em> :</span></td>
<td> the element's label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></td>
<td> the element's tooltip.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></td>
<td> used for context-sensitive help about this toolbar element.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>icon</code></em> :</span></td>
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that provides pictorial representation of the element's function.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td> the function to be executed when the button is pressed.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> any data you wish to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the new toolbar element as a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3314261"></a><h3>
<a name="gtk-toolbar-insert-element"></a>gtk_toolbar_insert_element ()</h3>
<a class="indexterm" name="id3314277"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_toolbar_insert_element (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkToolbar.html#GtkToolbarChildType">GtkToolbarChildType</a> type,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
const char *text,
const char *tooltip_text,
const char *tooltip_private_text,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *icon,
<a href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> position);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_insert_element</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Inserts a new element in the toolbar at the given position.
</p>
<p>
If <em class="parameter"><code>type</code></em> == <a href="GtkToolbar.html#GTK-TOOLBAR-CHILD-WIDGET:CAPS"><code class="literal">GTK_TOOLBAR_CHILD_WIDGET</code></a>, <em class="parameter"><code>widget</code></em> is used as the new element.
If <em class="parameter"><code>type</code></em> == <a href="GtkToolbar.html#GTK-TOOLBAR-CHILD-RADIOBUTTON:CAPS"><code class="literal">GTK_TOOLBAR_CHILD_RADIOBUTTON</code></a>, <em class="parameter"><code>widget</code></em> is used to determine
the radio group for the new element. In all other cases, <em class="parameter"><code>widget</code></em> must
be <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>.
</p>
<p>
<em class="parameter"><code>callback</code></em> must be a pointer to a function taking a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> and a gpointer as
arguments. Use the <a href="gtk-Types.html#GTK-SIGNAL-FUNC:CAPS"><code class="function">GTK_SIGNAL_FUNC()</code></a> to cast the function to <a href="gtk-Types.html#GtkSignalFunc"><span class="type">GtkSignalFunc</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>type</code></em> :</span></td>
<td> a value of type <a href="GtkToolbar.html#GtkToolbarChildType"><span class="type">GtkToolbarChildType</span></a> that determines what <em class="parameter"><code>widget</code></em>
will be.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>text</code></em> :</span></td>
<td> the element's label.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></td>
<td> the element's tooltip.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></td>
<td> used for context-sensitive help about this toolbar element.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>icon</code></em> :</span></td>
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> that provides pictorial representation of the element's function.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td> the function to be executed when the button is pressed.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> any data you wish to pass to the callback.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>position</code></em> :</span></td>
<td> the number of widgets to insert this element after.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the new toolbar element as a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3314711"></a><h3>
<a name="gtk-toolbar-append-widget"></a>gtk_toolbar_append_widget ()</h3>
<a class="indexterm" name="id3314727"></a><pre class="programlisting">void gtk_toolbar_append_widget (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
const char *tooltip_text,
const char *tooltip_private_text);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_append_widget</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Adds a widget to the end of the given toolbar.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to add to the toolbar.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></td>
<td> the element's tooltip.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></td>
<td> used for context-sensitive help about this toolbar element.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3314872"></a><h3>
<a name="gtk-toolbar-prepend-widget"></a>gtk_toolbar_prepend_widget ()</h3>
<a class="indexterm" name="id3314888"></a><pre class="programlisting">void gtk_toolbar_prepend_widget (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
const char *tooltip_text,
const char *tooltip_private_text);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_prepend_widget</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Adds a widget to the beginning of the given toolbar.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to add to the toolbar.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></td>
<td> the element's tooltip.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></td>
<td> used for context-sensitive help about this toolbar element.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3315033"></a><h3>
<a name="gtk-toolbar-insert-widget"></a>gtk_toolbar_insert_widget ()</h3>
<a class="indexterm" name="id3315049"></a><pre class="programlisting">void gtk_toolbar_insert_widget (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget,
const char *tooltip_text,
const char *tooltip_private_text,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> position);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_insert_widget</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Inserts a widget in the toolbar at the given position.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>widget</code></em> :</span></td>
<td> a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> to add to the toolbar.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></td>
<td> the element's tooltip.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></td>
<td> used for context-sensitive help about this toolbar element.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>position</code></em> :</span></td>
<td> the number of widgets to insert this widget after.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3315216"></a><h3>
<a name="gtk-toolbar-set-style"></a>gtk_toolbar_set_style ()</h3>
<a class="indexterm" name="id3315229"></a><pre class="programlisting">void gtk_toolbar_set_style (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="gtk-Standard-Enumerations.html#GtkToolbarStyle">GtkToolbarStyle</a> style);</pre>
<p>
Alters the view of <em class="parameter"><code>toolbar</code></em> to display either icons only, text only, or both.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>style</code></em> :</span></td>
<td> the new style for <em class="parameter"><code>toolbar</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3315321"></a><h3>
<a name="gtk-toolbar-insert-stock"></a>gtk_toolbar_insert_stock ()</h3>
<a class="indexterm" name="id3315337"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_toolbar_insert_stock (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *stock_id,
const char *tooltip_text,
const char *tooltip_private_text,
<a href="gtk-Types.html#GtkSignalFunc">GtkSignalFunc</a> callback,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> position);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_insert_stock</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Inserts a stock item at the specified position of the toolbar. If
<em class="parameter"><code>stock_id</code></em> is not a known stock item ID, it's inserted verbatim,
except that underscores used to mark mnemonics are removed.
</p>
<p>
<em class="parameter"><code>callback</code></em> must be a pointer to a function taking a <a href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> and a gpointer as
arguments. Use the <a href="gtk-Types.html#GTK-SIGNAL-FUNC:CAPS"><code class="function">GTK_SIGNAL_FUNC()</code></a> to cast the function to <a href="gtk-Types.html#GtkSignalFunc"><span class="type">GtkSignalFunc</span></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> A <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>stock_id</code></em> :</span></td>
<td> The id of the stock item you want to insert
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_text</code></em> :</span></td>
<td> The text in the tooltip of the toolbar button
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>tooltip_private_text</code></em> :</span></td>
<td> The private text of the tooltip
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td> The callback called when the toolbar button is clicked.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td> user data passed to callback
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>position</code></em> :</span></td>
<td> The position the button shall be inserted at.
-1 means at the end.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the inserted widget
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3315598"></a><h3>
<a name="gtk-toolbar-set-icon-size"></a>gtk_toolbar_set_icon_size ()</h3>
<a class="indexterm" name="id3315614"></a><pre class="programlisting">void gtk_toolbar_set_icon_size (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="gtk-Themeable-Stock-Images.html#GtkIconSize">GtkIconSize</a> icon_size);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_set_icon_size</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This function sets the size of stock icons in the toolbar. You
can call it both before you add the icons and after they've been
added. The size you set will override user preferences for the default
icon size.
</p>
<p>
This should only be used for special-purpose toolbars, normal
application toolbars should respect the user preferences for the
size of icons.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> A <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>icon_size</code></em> :</span></td>
<td> The <a href="gtk-Themeable-Stock-Images.html#GtkIconSize"><span class="type">GtkIconSize</span></a> that stock icons in the toolbar shall have.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3315723"></a><h3>
<a name="gtk-toolbar-remove-space"></a>gtk_toolbar_remove_space ()</h3>
<a class="indexterm" name="id3315738"></a><pre class="programlisting">void gtk_toolbar_remove_space (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> position);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_toolbar_remove_space</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Removes a space from the specified position.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>position</code></em> :</span></td>
<td> the index of the space to remove.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3315830"></a><h3>
<a name="gtk-toolbar-unset-style"></a>gtk_toolbar_unset_style ()</h3>
<a class="indexterm" name="id3315844"></a><pre class="programlisting">void gtk_toolbar_unset_style (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar);</pre>
<p>
Unsets a toolbar style set with <a href="GtkToolbar.html#gtk-toolbar-set-style"><code class="function">gtk_toolbar_set_style()</code></a>, so that
user preferences will be used to determine the toolbar style.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> a <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a>
</td>
</tr></tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3315914"></a><h2>Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3315925"></a><h3>
<a name="GtkToolbar--icon-size"></a>The "<code class="literal">icon-size</code>" property</h3>
<a class="indexterm" name="id3315942"></a><pre class="programlisting"> "icon-size" <a href="gtk-Themeable-Stock-Images.html#GtkIconSize">GtkIconSize</a> : Read / Write</pre>
<p>
The size of the icons in a toolbar is normally determined by
the toolbar-icon-size setting. When this property is set, it
overrides the setting.
</p>
<p>
This should only be used for special-purpose toolbars, normal
application toolbars should respect the user preferences for the
size of icons.</p>
<p>
</p>
<p>Default value: GTK_ICON_SIZE_LARGE_TOOLBAR</p>
<p>Since 2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3315985"></a><h3>
<a name="GtkToolbar--icon-size-set"></a>The "<code class="literal">icon-size-set</code>" property</h3>
<a class="indexterm" name="id3316001"></a><pre class="programlisting"> "icon-size-set" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>
Is <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the icon-size property has been set.</p>
<p>
</p>
<p>Default value: FALSE</p>
<p>Since 2.10
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316048"></a><h3>
<a name="GtkToolbar--orientation"></a>The "<code class="literal">orientation</code>" property</h3>
<a class="indexterm" name="id3316064"></a><pre class="programlisting"> "orientation" <a href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a> : Read / Write</pre>
<p>The orientation of the toolbar.</p>
<p>Default value: GTK_ORIENTATION_HORIZONTAL</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316092"></a><h3>
<a name="GtkToolbar--show-arrow"></a>The "<code class="literal">show-arrow</code>" property</h3>
<a class="indexterm" name="id3316108"></a><pre class="programlisting"> "show-arrow" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>If an arrow should be shown if the toolbar doesn't fit.</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316135"></a><h3>
<a name="GtkToolbar--toolbar-style"></a>The "<code class="literal">toolbar-style</code>" property</h3>
<a class="indexterm" name="id3316152"></a><pre class="programlisting"> "toolbar-style" <a href="gtk-Standard-Enumerations.html#GtkToolbarStyle">GtkToolbarStyle</a> : Read / Write</pre>
<p>How to draw the toolbar.</p>
<p>Default value: GTK_TOOLBAR_ICONS</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316179"></a><h3>
<a name="GtkToolbar--tooltips"></a>The "<code class="literal">tooltips</code>" property</h3>
<a class="indexterm" name="id3316195"></a><pre class="programlisting"> "tooltips" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>
If the tooltips of the toolbar should be active or not.</p>
<p>
</p>
<p>Default value: TRUE</p>
<p>Since 2.8
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3316232"></a><h2>Child Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3316242"></a><h3>
<a name="GtkToolbar--expand"></a>The "<code class="literal">expand</code>" child property</h3>
<a class="indexterm" name="id3316259"></a><pre class="programlisting"> "expand" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether the item should receive extra space when the toolbar grows.</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316286"></a><h3>
<a name="GtkToolbar--homogeneous"></a>The "<code class="literal">homogeneous</code>" child property</h3>
<a class="indexterm" name="id3316302"></a><pre class="programlisting"> "homogeneous" <a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> : Read / Write</pre>
<p>Whether the item should be the same size as other homogeneous items.</p>
<p>Default value: TRUE</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3316331"></a><h2>Style Property Details</h2>
<div class="refsect2" lang="en">
<a name="id3316342"></a><h3>
<a name="GtkToolbar--button-relief"></a>The "<code class="literal">button-relief</code>" style property</h3>
<a class="indexterm" name="id3316358"></a><pre class="programlisting"> "button-relief" <a href="gtk-Standard-Enumerations.html#GtkReliefStyle">GtkReliefStyle</a> : Read</pre>
<p>Type of bevel around toolbar buttons.</p>
<p>Default value: GTK_RELIEF_NONE</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316386"></a><h3>
<a name="GtkToolbar--internal-padding"></a>The "<code class="literal">internal-padding</code>" style property</h3>
<a class="indexterm" name="id3316403"></a><pre class="programlisting"> "internal-padding" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read</pre>
<p>Amount of border space between the toolbar shadow and the buttons.</p>
<p>Allowed values: >= 0</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316434"></a><h3>
<a name="GtkToolbar--max-child-expand"></a>The "<code class="literal">max-child-expand</code>" style property</h3>
<a class="indexterm" name="id3316451"></a><pre class="programlisting"> "max-child-expand" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read</pre>
<p>Maximum amount of space an expandable item will be given.</p>
<p>Allowed values: >= 0</p>
<p>Default value: 2147483647</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316483"></a><h3>
<a name="GtkToolbar--shadow-type"></a>The "<code class="literal">shadow-type</code>" style property</h3>
<a class="indexterm" name="id3316499"></a><pre class="programlisting"> "shadow-type" <a href="gtk-Standard-Enumerations.html#GtkShadowType">GtkShadowType</a> : Read</pre>
<p>Style of bevel around the toolbar.</p>
<p>Default value: GTK_SHADOW_OUT</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316526"></a><h3>
<a name="GtkToolbar--space-size"></a>The "<code class="literal">space-size</code>" style property</h3>
<a class="indexterm" name="id3316542"></a><pre class="programlisting"> "space-size" <a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> : Read</pre>
<p>Size of spacers.</p>
<p>Allowed values: >= 0</p>
<p>Default value: 12</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316572"></a><h3>
<a name="GtkToolbar--space-style"></a>The "<code class="literal">space-style</code>" style property</h3>
<a class="indexterm" name="id3316588"></a><pre class="programlisting"> "space-style" <a href="GtkToolbar.html#GtkToolbarSpaceStyle">GtkToolbarSpaceStyle</a> : Read</pre>
<p>Whether spacers are vertical lines or just blank.</p>
<p>Default value: GTK_TOOLBAR_SPACE_LINE</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3316617"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id3316628"></a><h3>
<a name="GtkToolbar-focus-home-or-end"></a>The "focus-home-or-end" signal</h3>
<a class="indexterm" name="id3316639"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> user_function (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> focus_home,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last / Action</pre>
<p>
A keybinding signal used internally by GTK+. This signal can't
be used in application code</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> the <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> which emitted the signal
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>focus_home</code></em> :</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the first item should be focused
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the signal was handled, <a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> if not
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316783"></a><h3>
<a name="GtkToolbar-move-focus"></a>The "move-focus" signal</h3>
<a class="indexterm" name="id3316794"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> user_function (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="gtk-Standard-Enumerations.html#GtkDirectionType">GtkDirectionType</a> *dir,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last / Action</pre>
<p>
A keybinding signal used internally by GTK+. This signal can't
be used in application code.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> the <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> which emitted the signal
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>dir</code></em> :</span></td>
<td> a <span class="type">GtkDirection</span>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the signal was handled, <a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> if not
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3316936"></a><h3>
<a name="GtkToolbar-orientation-changed"></a>The "orientation-changed" signal</h3>
<a class="indexterm" name="id3316948"></a><pre class="programlisting">void user_function (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="gtk-Standard-Enumerations.html#GtkOrientation">GtkOrientation</a> orientation,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run first</pre>
<p>
Emitted when the orientation of the toolbar changes.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> the object which emitted the signal
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>orientation</code></em> :</span></td>
<td> the new <a href="gtk-Standard-Enumerations.html#GtkOrientation"><span class="type">GtkOrientation</span></a> of the toolbar
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3317050"></a><h3>
<a name="GtkToolbar-popup-context-menu"></a>The "popup-context-menu" signal</h3>
<a class="indexterm" name="id3317061"></a><pre class="programlisting"><a
href="../glib/glib-Basic-Types.html#gboolean"
>gboolean</a> user_function (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> y,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> button,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last</pre>
<p>
Emitted when the user right-clicks the toolbar or uses the
keybinding to display a popup menu.
</p>
<p>
Application developers should handle this signal if they want
to display a context menu on the toolbar. The context-menu should
appear at the coordinates given by <em class="parameter"><code>x</code></em> and <em class="parameter"><code>y</code></em>. The mouse button
number is given by the <em class="parameter"><code>button</code></em> parameter. If the menu was popped
up using the keybaord, <em class="parameter"><code>button</code></em> is -1.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> the <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> which emitted the signal
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
<td> the x coordinate of the point where the menu should appear
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
<td> the y coordinate of the point where the menu should appear
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>button</code></em> :</span></td>
<td> the mouse button the user pressed, or -1
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> return <a
href="../glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the signal was handled, <a
href="../glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> if not
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3317270"></a><h3>
<a name="GtkToolbar-style-changed"></a>The "style-changed" signal</h3>
<a class="indexterm" name="id3317281"></a><pre class="programlisting">void user_function (<a href="GtkToolbar.html" title="GtkToolbar">GtkToolbar</a> *toolbar,
<a href="gtk-Standard-Enumerations.html#GtkToolbarStyle">GtkToolbarStyle</a> style,
<a
href="../glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run first</pre>
<p>
Emitted when the style of the toolbar changes.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>toolbar</code></em> :</span></td>
<td> The <a href="GtkToolbar.html" title="GtkToolbar"><span class="type">GtkToolbar</span></a> which emitted the signal
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>style</code></em> :</span></td>
<td> the new <a href="gtk-Standard-Enumerations.html#GtkToolbarStyle"><span class="type">GtkToolbarStyle</span></a> of the toolbar
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3317394"></a><h2>See Also</h2>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><a href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a></span></td>
<td><p>Base class of widgets that can be added to a toolbar.</p></td>
</tr></tbody>
</table></div>
<p>
</p>
</div>
</div>
</body>
</html>