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;
79
#endif /* GTK_DISABLE_DEPRECATED */
83
GTK_TOOLBAR_SPACE_EMPTY,
84
GTK_TOOLBAR_SPACE_LINE
85
} GtkToolbarSpaceStyle;
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;
105
gint button_maxw; /* maximum width of homogeneous children */
106
gint button_maxh; /* maximum height of homogeneous children */
108
guint _gtk_reserved1;
109
guint _gtk_reserved2;
112
guint icon_size_set : 1;
115
struct _GtkToolbarClass
117
GtkContainerClass parent_class;
120
void (* orientation_changed) (GtkToolbar *toolbar,
121
GtkOrientation orientation);
122
void (* style_changed) (GtkToolbar *toolbar,
123
GtkToolbarStyle style);
124
gboolean (* popup_context_menu) (GtkToolbar *toolbar,
129
/* Padding for future expansion */
130
void (*_gtk_reserved1) (void);
131
void (*_gtk_reserved2) (void);
132
void (*_gtk_reserved3) (void);
135
GType gtk_toolbar_get_type (void) G_GNUC_CONST;
136
GtkWidget* gtk_toolbar_new (void);
137
void gtk_toolbar_insert (GtkToolbar *toolbar,
140
gint gtk_toolbar_get_item_index (GtkToolbar *toolbar,
142
gint gtk_toolbar_get_n_items (GtkToolbar *toolbar);
143
GtkToolItem * gtk_toolbar_get_nth_item (GtkToolbar *toolbar,
145
gboolean gtk_toolbar_get_show_arrow (GtkToolbar *toolbar);
146
void gtk_toolbar_set_show_arrow (GtkToolbar *toolbar,
147
gboolean show_arrow);
148
GtkOrientation gtk_toolbar_get_orientation (GtkToolbar *toolbar);
149
void gtk_toolbar_set_orientation (GtkToolbar *toolbar,
150
GtkOrientation orientation);
151
gboolean gtk_toolbar_get_tooltips (GtkToolbar *toolbar);
152
void gtk_toolbar_set_tooltips (GtkToolbar *toolbar,
154
GtkToolbarStyle gtk_toolbar_get_style (GtkToolbar *toolbar);
155
void gtk_toolbar_set_style (GtkToolbar *toolbar,
156
GtkToolbarStyle style);
157
void gtk_toolbar_unset_style (GtkToolbar *toolbar);
158
GtkIconSize gtk_toolbar_get_icon_size (GtkToolbar *toolbar);
159
GtkReliefStyle gtk_toolbar_get_relief_style (GtkToolbar *toolbar);
160
gint gtk_toolbar_get_drop_index (GtkToolbar *toolbar,
163
void gtk_toolbar_set_drop_highlight_item (GtkToolbar *toolbar,
164
GtkToolItem *tool_item,
167
/* internal functions */
168
gchar * _gtk_toolbar_elide_underscores (const gchar *original);
169
void _gtk_toolbar_paint_space_line (GtkWidget *widget,
172
GtkAllocation *allocation);
173
gint _gtk_toolbar_get_default_space_size (void);
174
void _gtk_toolbar_rebuild_menu (GtkToolbar *toolbar);
178
#ifndef GTK_DISABLE_DEPRECATED
179
void gtk_toolbar_set_icon_size (GtkToolbar *toolbar,
180
GtkIconSize icon_size);
181
void gtk_toolbar_unset_icon_size (GtkToolbar *toolbar);
183
/* Simple button items */
184
GtkWidget* gtk_toolbar_append_item (GtkToolbar *toolbar,
186
const char *tooltip_text,
187
const char *tooltip_private_text,
189
GtkSignalFunc callback,
191
GtkWidget* gtk_toolbar_prepend_item (GtkToolbar *toolbar,
193
const char *tooltip_text,
194
const char *tooltip_private_text,
196
GtkSignalFunc callback,
198
GtkWidget* gtk_toolbar_insert_item (GtkToolbar *toolbar,
200
const char *tooltip_text,
201
const char *tooltip_private_text,
203
GtkSignalFunc callback,
208
GtkWidget* gtk_toolbar_insert_stock (GtkToolbar *toolbar,
209
const gchar *stock_id,
210
const char *tooltip_text,
211
const char *tooltip_private_text,
212
GtkSignalFunc callback,
217
void gtk_toolbar_append_space (GtkToolbar *toolbar);
218
void gtk_toolbar_prepend_space (GtkToolbar *toolbar);
219
void gtk_toolbar_insert_space (GtkToolbar *toolbar,
221
void gtk_toolbar_remove_space (GtkToolbar *toolbar,
223
/* Any element type */
224
GtkWidget* gtk_toolbar_append_element (GtkToolbar *toolbar,
225
GtkToolbarChildType type,
228
const char *tooltip_text,
229
const char *tooltip_private_text,
231
GtkSignalFunc callback,
234
GtkWidget* gtk_toolbar_prepend_element (GtkToolbar *toolbar,
235
GtkToolbarChildType type,
238
const char *tooltip_text,
239
const char *tooltip_private_text,
241
GtkSignalFunc callback,
244
GtkWidget* gtk_toolbar_insert_element (GtkToolbar *toolbar,
245
GtkToolbarChildType type,
248
const char *tooltip_text,
249
const char *tooltip_private_text,
251
GtkSignalFunc callback,
255
/* Generic Widgets */
256
void gtk_toolbar_append_widget (GtkToolbar *toolbar,
258
const char *tooltip_text,
259
const char *tooltip_private_text);
260
void gtk_toolbar_prepend_widget (GtkToolbar *toolbar,
262
const char *tooltip_text,
263
const char *tooltip_private_text);
264
void gtk_toolbar_insert_widget (GtkToolbar *toolbar,
266
const char *tooltip_text,
267
const char *tooltip_private_text,
270
#endif /* GTK_DISABLE_DEPRECATED */
275
#endif /* __GTK_TOOLBAR_H__ */