1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
3 * GtkToolbar copyright (C) Federico Mena
5 * Copyright (C) 2002 Anders Carlsson <andersca@gnome.org>
6 * Copyright (C) 2002 James Henstridge <james@daa.com.au>
7 * Copyright (C) 2003 Soeren Sandmann <sandmann@daimi.au.dk>
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
12 * version 2 of the License, or (at your option) any later version.
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with this library; if not, write to the
21 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
22 * Boston, MA 02111-1307, USA.
26 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
27 * file for a list of people on the GTK+ Team. See the ChangeLog
28 * files for a list of changes. These files are distributed with
29 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
32 #ifndef __GTK_TOOLBAR_H__
33 #define __GTK_TOOLBAR_H__
36 #include <gtk/gtkcontainer.h>
37 #include <gtk/gtkenums.h>
38 #include <gtk/gtktooltips.h>
40 #include "gtktoolitem.h"
42 #ifndef GTK_DISABLE_DEPRECATED
44 /* Not needed, retained for compatibility -Yosh */
45 #include <gtk/gtkpixmap.h>
46 #include <gtk/gtksignal.h>
48 #endif /* GTK_DISABLE_DEPRECATED */
52 #define GTK_TYPE_TOOLBAR (gtk_toolbar_get_type ())
53 #define GTK_TOOLBAR(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_TOOLBAR, GtkToolbar))
54 #define GTK_TOOLBAR_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_TOOLBAR, GtkToolbarClass))
55 #define GTK_IS_TOOLBAR(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_TOOLBAR))
56 #define GTK_IS_TOOLBAR_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_TOOLBAR))
57 #define GTK_TOOLBAR_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_TOOLBAR, GtkToolbarClass))
59 #ifndef GTK_DISABLE_DEPRECATED
62 GTK_TOOLBAR_CHILD_SPACE,
63 GTK_TOOLBAR_CHILD_BUTTON,
64 GTK_TOOLBAR_CHILD_TOGGLEBUTTON,
65 GTK_TOOLBAR_CHILD_RADIOBUTTON,
66 GTK_TOOLBAR_CHILD_WIDGET
67 } GtkToolbarChildType;
69 typedef struct _GtkToolbarChild GtkToolbarChild;
71 struct _GtkToolbarChild
73 GtkToolbarChildType type;
81 GTK_TOOLBAR_SPACE_EMPTY,
82 GTK_TOOLBAR_SPACE_LINE
83 } GtkToolbarSpaceStyle;
85 #endif /* GTK_DISABLE_DEPRECATED */
87 typedef struct _GtkToolbar GtkToolbar;
88 typedef struct _GtkToolbarClass GtkToolbarClass;
89 typedef struct _GtkToolbarPrivate GtkToolbarPrivate;
93 GtkContainer container;
98 GtkOrientation orientation;
99 GtkToolbarStyle style;
100 GtkIconSize icon_size;
102 GtkTooltips *tooltips;
104 gint button_maxw; /* maximum width of homogeneous children */
105 gint button_maxh; /* maximum height of homogeneous children */
107 guint style_set_connection;
108 guint icon_size_connection;
111 guint icon_size_set : 1;
114 struct _GtkToolbarClass
116 GtkContainerClass parent_class;
119 void (* orientation_changed) (GtkToolbar *toolbar,
120 GtkOrientation orientation);
121 void (* style_changed) (GtkToolbar *toolbar,
122 GtkToolbarStyle style);
123 gboolean (* popup_context_menu) (GtkToolbar *toolbar,
128 /* Padding for future expansion */
129 void (*_gtk_reserved1) (void);
130 void (*_gtk_reserved2) (void);
131 void (*_gtk_reserved3) (void);
134 GType gtk_toolbar_get_type (void) G_GNUC_CONST;
135 GtkWidget* gtk_toolbar_new (void);
136 void gtk_toolbar_insert (GtkToolbar *toolbar,
139 gint gtk_toolbar_get_item_index (GtkToolbar *toolbar,
141 gint gtk_toolbar_get_n_items (GtkToolbar *toolbar);
142 GtkToolItem * gtk_toolbar_get_nth_item (GtkToolbar *toolbar,
144 gboolean gtk_toolbar_get_show_arrow (GtkToolbar *toolbar);
145 void gtk_toolbar_set_show_arrow (GtkToolbar *toolbar,
146 gboolean show_arrow);
147 GtkOrientation gtk_toolbar_get_orientation (GtkToolbar *toolbar);
148 void gtk_toolbar_set_orientation (GtkToolbar *toolbar,
149 GtkOrientation orientation);
150 gboolean gtk_toolbar_get_tooltips (GtkToolbar *toolbar);
151 void gtk_toolbar_set_tooltips (GtkToolbar *toolbar,
153 GtkToolbarStyle gtk_toolbar_get_style (GtkToolbar *toolbar);
154 void gtk_toolbar_set_style (GtkToolbar *toolbar,
155 GtkToolbarStyle style);
156 void gtk_toolbar_unset_style (GtkToolbar *toolbar);
157 GtkIconSize gtk_toolbar_get_icon_size (GtkToolbar *toolbar);
158 GtkReliefStyle gtk_toolbar_get_relief_style (GtkToolbar *toolbar);
159 gint gtk_toolbar_get_drop_index (GtkToolbar *toolbar,
162 void gtk_toolbar_set_drop_highlight_item (GtkToolbar *toolbar,
163 GtkToolItem *tool_item,
167 /* internal function */
168 gchar * _gtk_toolbar_elide_underscores (const gchar *original);
170 #ifndef GTK_DISABLE_DEPRECATED
171 void gtk_toolbar_set_icon_size (GtkToolbar *toolbar,
172 GtkIconSize icon_size);
173 void gtk_toolbar_unset_icon_size (GtkToolbar *toolbar);
175 /* Simple button items */
176 GtkWidget* gtk_toolbar_append_item (GtkToolbar *toolbar,
178 const char *tooltip_text,
179 const char *tooltip_private_text,
181 GtkSignalFunc callback,
183 GtkWidget* gtk_toolbar_prepend_item (GtkToolbar *toolbar,
185 const char *tooltip_text,
186 const char *tooltip_private_text,
188 GtkSignalFunc callback,
190 GtkWidget* gtk_toolbar_insert_item (GtkToolbar *toolbar,
192 const char *tooltip_text,
193 const char *tooltip_private_text,
195 GtkSignalFunc callback,
200 GtkWidget* gtk_toolbar_insert_stock (GtkToolbar *toolbar,
201 const gchar *stock_id,
202 const char *tooltip_text,
203 const char *tooltip_private_text,
204 GtkSignalFunc callback,
209 void gtk_toolbar_append_space (GtkToolbar *toolbar);
210 void gtk_toolbar_prepend_space (GtkToolbar *toolbar);
211 void gtk_toolbar_insert_space (GtkToolbar *toolbar,
213 void gtk_toolbar_remove_space (GtkToolbar *toolbar,
215 /* Any element type */
216 GtkWidget* gtk_toolbar_append_element (GtkToolbar *toolbar,
217 GtkToolbarChildType type,
220 const char *tooltip_text,
221 const char *tooltip_private_text,
223 GtkSignalFunc callback,
226 GtkWidget* gtk_toolbar_prepend_element (GtkToolbar *toolbar,
227 GtkToolbarChildType type,
230 const char *tooltip_text,
231 const char *tooltip_private_text,
233 GtkSignalFunc callback,
236 GtkWidget* gtk_toolbar_insert_element (GtkToolbar *toolbar,
237 GtkToolbarChildType type,
240 const char *tooltip_text,
241 const char *tooltip_private_text,
243 GtkSignalFunc callback,
247 /* Generic Widgets */
248 void gtk_toolbar_append_widget (GtkToolbar *toolbar,
250 const char *tooltip_text,
251 const char *tooltip_private_text);
252 void gtk_toolbar_prepend_widget (GtkToolbar *toolbar,
254 const char *tooltip_text,
255 const char *tooltip_private_text);
256 void gtk_toolbar_insert_widget (GtkToolbar *toolbar,
258 const char *tooltip_text,
259 const char *tooltip_private_text,
262 #endif /* GTK_DISABLE_DEPRECATED */
267 #endif /* __GTK_TOOLBAR_H__ */