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, 2004 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 #undef GTK_DISABLE_DEPRECATED
36 #include "gtktoolbar.h"
37 #include "gtktoolshell.h"
38 #include "gtkradiotoolbutton.h"
39 #include "gtkseparatortoolitem.h"
41 #include "gtkradiobutton.h"
42 #include "gtktoolbar.h"
43 #include "gtkbindings.h"
44 #include <gdk/gdkkeysyms.h>
45 #include "gtkmarshalers.h"
49 #include "gtkprivate.h"
55 #include "gtkseparatormenuitem.h"
59 typedef struct _ToolbarContent ToolbarContent;
61 #define DEFAULT_IPADDING 0
63 #define DEFAULT_SPACE_SIZE 12
64 #define DEFAULT_SPACE_STYLE GTK_TOOLBAR_SPACE_LINE
65 #define SPACE_LINE_DIVISION 10.0
66 #define SPACE_LINE_START 2.0
67 #define SPACE_LINE_END 8.0
69 #define DEFAULT_ICON_SIZE GTK_ICON_SIZE_LARGE_TOOLBAR
70 #define DEFAULT_TOOLBAR_STYLE GTK_TOOLBAR_BOTH
71 #define DEFAULT_ANIMATION_STATE TRUE
73 #define MAX_HOMOGENEOUS_N_CHARS 13 /* Items that are wider than this do not participate
74 * in the homogeneous game. In units of
75 * pango_font_get_estimated_char_width().
77 #define SLIDE_SPEED 600.0 /* How fast the items slide, in pixels per second */
78 #define ACCEL_THRESHOLD 0.18 /* After how much time in seconds will items start speeding up */
80 #define MIXED_API_WARNING \
81 "Mixing deprecated and non-deprecated GtkToolbar API is not allowed"
95 /* Child properties */
99 CHILD_PROP_HOMOGENEOUS
130 struct _GtkToolbarPrivate
135 GtkWidget * arrow_button;
138 GdkWindow * event_window;
140 GtkSettings * settings;
142 GtkToolItem * highlight_tool_item;
143 gint max_homogeneous_pixels;
147 gulong settings_connection;
149 guint show_arrow : 1;
151 guint is_sliding : 1;
152 guint need_rebuild : 1; /* whether the overflow menu should be regenerated */
156 static void gtk_toolbar_set_property (GObject *object,
160 static void gtk_toolbar_get_property (GObject *object,
164 static gint gtk_toolbar_expose (GtkWidget *widget,
165 GdkEventExpose *event);
166 static void gtk_toolbar_realize (GtkWidget *widget);
167 static void gtk_toolbar_unrealize (GtkWidget *widget);
168 static void gtk_toolbar_size_request (GtkWidget *widget,
169 GtkRequisition *requisition);
170 static void gtk_toolbar_size_allocate (GtkWidget *widget,
171 GtkAllocation *allocation);
172 static void gtk_toolbar_style_set (GtkWidget *widget,
173 GtkStyle *prev_style);
174 static gboolean gtk_toolbar_focus (GtkWidget *widget,
175 GtkDirectionType dir);
176 static void gtk_toolbar_move_focus (GtkWidget *widget,
177 GtkDirectionType dir);
178 static void gtk_toolbar_screen_changed (GtkWidget *widget,
179 GdkScreen *previous_screen);
180 static void gtk_toolbar_map (GtkWidget *widget);
181 static void gtk_toolbar_unmap (GtkWidget *widget);
182 static void gtk_toolbar_set_child_property (GtkContainer *container,
187 static void gtk_toolbar_get_child_property (GtkContainer *container,
192 static void gtk_toolbar_finalize (GObject *object);
193 static void gtk_toolbar_show_all (GtkWidget *widget);
194 static void gtk_toolbar_hide_all (GtkWidget *widget);
195 static void gtk_toolbar_add (GtkContainer *container,
197 static void gtk_toolbar_remove (GtkContainer *container,
199 static void gtk_toolbar_forall (GtkContainer *container,
200 gboolean include_internals,
201 GtkCallback callback,
202 gpointer callback_data);
203 static GType gtk_toolbar_child_type (GtkContainer *container);
204 static void gtk_toolbar_orientation_changed (GtkToolbar *toolbar,
205 GtkOrientation orientation);
206 static void gtk_toolbar_real_style_changed (GtkToolbar *toolbar,
207 GtkToolbarStyle style);
208 static gboolean gtk_toolbar_focus_home_or_end (GtkToolbar *toolbar,
209 gboolean focus_home);
210 static gboolean gtk_toolbar_button_press (GtkWidget *toolbar,
211 GdkEventButton *event);
212 static gboolean gtk_toolbar_arrow_button_press (GtkWidget *button,
213 GdkEventButton *event,
214 GtkToolbar *toolbar);
215 static void gtk_toolbar_arrow_button_clicked (GtkWidget *button,
216 GtkToolbar *toolbar);
217 static void gtk_toolbar_update_button_relief (GtkToolbar *toolbar);
218 static gboolean gtk_toolbar_popup_menu (GtkWidget *toolbar);
219 static GtkWidget *internal_insert_element (GtkToolbar *toolbar,
220 GtkToolbarChildType type,
223 const char *tooltip_text,
224 const char *tooltip_private_text,
226 GtkSignalFunc callback,
230 static void gtk_toolbar_reconfigured (GtkToolbar *toolbar);
231 static gboolean gtk_toolbar_check_new_api (GtkToolbar *toolbar);
232 static gboolean gtk_toolbar_check_old_api (GtkToolbar *toolbar);
234 static GtkReliefStyle get_button_relief (GtkToolbar *toolbar);
235 static gint get_internal_padding (GtkToolbar *toolbar);
236 static gint get_max_child_expand (GtkToolbar *toolbar);
237 static GtkShadowType get_shadow_type (GtkToolbar *toolbar);
238 static gint get_space_size (GtkToolbar *toolbar);
239 static GtkToolbarSpaceStyle get_space_style (GtkToolbar *toolbar);
241 /* methods on ToolbarContent 'class' */
242 static ToolbarContent *toolbar_content_new_tool_item (GtkToolbar *toolbar,
244 gboolean is_placeholder,
246 static ToolbarContent *toolbar_content_new_compatibility (GtkToolbar *toolbar,
247 GtkToolbarChildType type,
252 static void toolbar_content_remove (ToolbarContent *content,
253 GtkToolbar *toolbar);
254 static void toolbar_content_free (ToolbarContent *content);
255 static void toolbar_content_expose (ToolbarContent *content,
256 GtkContainer *container,
257 GdkEventExpose *expose);
258 static gboolean toolbar_content_visible (ToolbarContent *content,
259 GtkToolbar *toolbar);
260 static void toolbar_content_size_request (ToolbarContent *content,
262 GtkRequisition *requisition);
263 static gboolean toolbar_content_is_homogeneous (ToolbarContent *content,
264 GtkToolbar *toolbar);
265 static gboolean toolbar_content_is_placeholder (ToolbarContent *content);
266 static gboolean toolbar_content_disappearing (ToolbarContent *content);
267 static ItemState toolbar_content_get_state (ToolbarContent *content);
268 static gboolean toolbar_content_child_visible (ToolbarContent *content);
269 static void toolbar_content_get_goal_allocation (ToolbarContent *content,
270 GtkAllocation *allocation);
271 static void toolbar_content_get_allocation (ToolbarContent *content,
272 GtkAllocation *allocation);
273 static void toolbar_content_set_start_allocation (ToolbarContent *content,
274 GtkAllocation *new_start_allocation);
275 static void toolbar_content_get_start_allocation (ToolbarContent *content,
276 GtkAllocation *start_allocation);
277 static gboolean toolbar_content_get_expand (ToolbarContent *content);
278 static void toolbar_content_set_goal_allocation (ToolbarContent *content,
279 GtkAllocation *allocation);
280 static void toolbar_content_set_child_visible (ToolbarContent *content,
283 static void toolbar_content_size_allocate (ToolbarContent *content,
284 GtkAllocation *allocation);
285 static void toolbar_content_set_state (ToolbarContent *content,
286 ItemState new_state);
287 static GtkWidget * toolbar_content_get_widget (ToolbarContent *content);
288 static void toolbar_content_set_disappearing (ToolbarContent *content,
289 gboolean disappearing);
290 static void toolbar_content_set_size_request (ToolbarContent *content,
293 static void toolbar_content_toolbar_reconfigured (ToolbarContent *content,
294 GtkToolbar *toolbar);
295 static GtkWidget * toolbar_content_retrieve_menu_item (ToolbarContent *content);
296 static gboolean toolbar_content_has_proxy_menu_item (ToolbarContent *content);
297 static gboolean toolbar_content_is_separator (ToolbarContent *content);
298 static void toolbar_content_show_all (ToolbarContent *content);
299 static void toolbar_content_hide_all (ToolbarContent *content);
300 static void toolbar_content_set_expand (ToolbarContent *content,
303 static void toolbar_tool_shell_iface_init (GtkToolShellIface *iface);
304 static GtkIconSize toolbar_get_icon_size (GtkToolShell *shell);
305 static GtkOrientation toolbar_get_orientation (GtkToolShell *shell);
306 static GtkToolbarStyle toolbar_get_style (GtkToolShell *shell);
307 static GtkReliefStyle toolbar_get_relief_style (GtkToolShell *shell);
308 static void toolbar_rebuild_menu (GtkToolShell *shell);
310 #define GTK_TOOLBAR_GET_PRIVATE(o) \
311 (G_TYPE_INSTANCE_GET_PRIVATE ((o), GTK_TYPE_TOOLBAR, GtkToolbarPrivate))
313 static guint toolbar_signals [LAST_SIGNAL] = { 0 };
315 G_DEFINE_TYPE_WITH_CODE (GtkToolbar, gtk_toolbar, GTK_TYPE_CONTAINER,
316 G_IMPLEMENT_INTERFACE (GTK_TYPE_TOOL_SHELL, toolbar_tool_shell_iface_init))
319 add_arrow_bindings (GtkBindingSet *binding_set,
321 GtkDirectionType dir)
323 guint keypad_keysym = keysym - GDK_Left + GDK_KP_Left;
325 gtk_binding_entry_add_signal (binding_set, keysym, 0,
327 GTK_TYPE_DIRECTION_TYPE, dir);
328 gtk_binding_entry_add_signal (binding_set, keypad_keysym, 0,
330 GTK_TYPE_DIRECTION_TYPE, dir);
334 add_ctrl_tab_bindings (GtkBindingSet *binding_set,
335 GdkModifierType modifiers,
336 GtkDirectionType direction)
338 gtk_binding_entry_add_signal (binding_set,
339 GDK_Tab, GDK_CONTROL_MASK | modifiers,
341 GTK_TYPE_DIRECTION_TYPE, direction);
342 gtk_binding_entry_add_signal (binding_set,
343 GDK_KP_Tab, GDK_CONTROL_MASK | modifiers,
345 GTK_TYPE_DIRECTION_TYPE, direction);
349 toolbar_tool_shell_iface_init (GtkToolShellIface *iface)
351 iface->get_icon_size = toolbar_get_icon_size;
352 iface->get_orientation = toolbar_get_orientation;
353 iface->get_style = toolbar_get_style;
354 iface->get_relief_style = toolbar_get_relief_style;
355 iface->rebuild_menu = toolbar_rebuild_menu;
359 gtk_toolbar_class_init (GtkToolbarClass *klass)
361 GObjectClass *gobject_class;
362 GtkWidgetClass *widget_class;
363 GtkContainerClass *container_class;
364 GtkBindingSet *binding_set;
366 gobject_class = (GObjectClass *)klass;
367 widget_class = (GtkWidgetClass *)klass;
368 container_class = (GtkContainerClass *)klass;
370 gobject_class->set_property = gtk_toolbar_set_property;
371 gobject_class->get_property = gtk_toolbar_get_property;
372 gobject_class->finalize = gtk_toolbar_finalize;
374 widget_class->button_press_event = gtk_toolbar_button_press;
375 widget_class->expose_event = gtk_toolbar_expose;
376 widget_class->size_request = gtk_toolbar_size_request;
377 widget_class->size_allocate = gtk_toolbar_size_allocate;
378 widget_class->style_set = gtk_toolbar_style_set;
379 widget_class->focus = gtk_toolbar_focus;
381 /* need to override the base class function via override_class_closure,
382 * because the signal slot is not available in GtkWidgetClass
384 g_signal_override_class_closure (g_signal_lookup ("move_focus",
387 g_cclosure_new (G_CALLBACK (gtk_toolbar_move_focus),
390 widget_class->screen_changed = gtk_toolbar_screen_changed;
391 widget_class->realize = gtk_toolbar_realize;
392 widget_class->unrealize = gtk_toolbar_unrealize;
393 widget_class->map = gtk_toolbar_map;
394 widget_class->unmap = gtk_toolbar_unmap;
395 widget_class->popup_menu = gtk_toolbar_popup_menu;
396 widget_class->show_all = gtk_toolbar_show_all;
397 widget_class->hide_all = gtk_toolbar_hide_all;
399 container_class->add = gtk_toolbar_add;
400 container_class->remove = gtk_toolbar_remove;
401 container_class->forall = gtk_toolbar_forall;
402 container_class->child_type = gtk_toolbar_child_type;
403 container_class->get_child_property = gtk_toolbar_get_child_property;
404 container_class->set_child_property = gtk_toolbar_set_child_property;
406 klass->orientation_changed = gtk_toolbar_orientation_changed;
407 klass->style_changed = gtk_toolbar_real_style_changed;
410 * GtkToolbar::orientation-changed:
411 * @toolbar: the object which emitted the signal
412 * @orientation: the new #GtkOrientation of the toolbar
414 * Emitted when the orientation of the toolbar changes.
416 toolbar_signals[ORIENTATION_CHANGED] =
417 g_signal_new (I_("orientation-changed"),
418 G_OBJECT_CLASS_TYPE (klass),
420 G_STRUCT_OFFSET (GtkToolbarClass, orientation_changed),
422 g_cclosure_marshal_VOID__ENUM,
424 GTK_TYPE_ORIENTATION);
426 * GtkToolbar::style-changed:
427 * @toolbar: The #GtkToolbar which emitted the signal
428 * @style: the new #GtkToolbarStyle of the toolbar
430 * Emitted when the style of the toolbar changes.
432 toolbar_signals[STYLE_CHANGED] =
433 g_signal_new (I_("style-changed"),
434 G_OBJECT_CLASS_TYPE (klass),
436 G_STRUCT_OFFSET (GtkToolbarClass, style_changed),
438 g_cclosure_marshal_VOID__ENUM,
440 GTK_TYPE_TOOLBAR_STYLE);
442 * GtkToolbar::popup-context-menu:
443 * @toolbar: the #GtkToolbar which emitted the signal
444 * @x: the x coordinate of the point where the menu should appear
445 * @y: the y coordinate of the point where the menu should appear
446 * @button: the mouse button the user pressed, or -1
448 * Emitted when the user right-clicks the toolbar or uses the
449 * keybinding to display a popup menu.
451 * Application developers should handle this signal if they want
452 * to display a context menu on the toolbar. The context-menu should
453 * appear at the coordinates given by @x and @y. The mouse button
454 * number is given by the @button parameter. If the menu was popped
455 * up using the keybaord, @button is -1.
457 * Return value: return %TRUE if the signal was handled, %FALSE if not
459 toolbar_signals[POPUP_CONTEXT_MENU] =
460 g_signal_new (I_("popup_context_menu"),
461 G_OBJECT_CLASS_TYPE (klass),
463 G_STRUCT_OFFSET (GtkToolbarClass, popup_context_menu),
464 _gtk_boolean_handled_accumulator, NULL,
465 _gtk_marshal_BOOLEAN__INT_INT_INT,
467 G_TYPE_INT, G_TYPE_INT,
471 * GtkToolbar::focus-home-or-end:
472 * @toolbar: the #GtkToolbar which emitted the signal
473 * @focus_home: %TRUE if the first item should be focused
475 * A keybinding signal used internally by GTK+. This signal can't
476 * be used in application code
478 * Return value: %TRUE if the signal was handled, %FALSE if not
480 toolbar_signals[FOCUS_HOME_OR_END] =
481 _gtk_binding_signal_new (I_("focus_home_or_end"),
482 G_OBJECT_CLASS_TYPE (klass),
483 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
484 G_CALLBACK (gtk_toolbar_focus_home_or_end),
486 _gtk_marshal_BOOLEAN__BOOLEAN,
491 g_object_class_install_property (gobject_class,
493 g_param_spec_enum ("orientation",
495 P_("The orientation of the toolbar"),
496 GTK_TYPE_ORIENTATION,
497 GTK_ORIENTATION_HORIZONTAL,
498 GTK_PARAM_READWRITE));
500 g_object_class_install_property (gobject_class,
502 g_param_spec_enum ("toolbar-style",
504 P_("How to draw the toolbar"),
505 GTK_TYPE_TOOLBAR_STYLE,
506 DEFAULT_TOOLBAR_STYLE,
507 GTK_PARAM_READWRITE));
508 g_object_class_install_property (gobject_class,
510 g_param_spec_boolean ("show-arrow",
512 P_("If an arrow should be shown if the toolbar doesn't fit"),
514 GTK_PARAM_READWRITE));
518 * GtkToolbar:tooltips:
520 * If the tooltips of the toolbar should be active or not.
524 g_object_class_install_property (gobject_class,
526 g_param_spec_boolean ("tooltips",
528 P_("If the tooltips of the toolbar should be active or not"),
530 GTK_PARAM_READWRITE));
534 * GtkToolbar:icon-size:
536 * The size of the icons in a toolbar is normally determined by
537 * the toolbar-icon-size setting. When this property is set, it
538 * overrides the setting.
540 * This should only be used for special-purpose toolbars, normal
541 * application toolbars should respect the user preferences for the
546 g_object_class_install_property (gobject_class,
548 g_param_spec_enum ("icon-size",
550 P_("Size of icons in this toolbar"),
553 GTK_PARAM_READWRITE));
556 * GtkToolbar:icon-size-set:
558 * Is %TRUE if the icon-size property has been set.
562 g_object_class_install_property (gobject_class,
564 g_param_spec_boolean ("icon-size-set",
566 P_("Whether the icon-size property has been set"),
568 GTK_PARAM_READWRITE));
570 /* child properties */
571 gtk_container_class_install_child_property (container_class,
573 g_param_spec_boolean ("expand",
575 P_("Whether the item should receive extra space when the toolbar grows"),
577 GTK_PARAM_READWRITE));
579 gtk_container_class_install_child_property (container_class,
580 CHILD_PROP_HOMOGENEOUS,
581 g_param_spec_boolean ("homogeneous",
583 P_("Whether the item should be the same size as other homogeneous items"),
585 GTK_PARAM_READWRITE));
587 /* style properties */
588 gtk_widget_class_install_style_property (widget_class,
589 g_param_spec_int ("space-size",
591 P_("Size of spacers"),
595 GTK_PARAM_READABLE));
597 gtk_widget_class_install_style_property (widget_class,
598 g_param_spec_int ("internal-padding",
599 P_("Internal padding"),
600 P_("Amount of border space between the toolbar shadow and the buttons"),
604 GTK_PARAM_READABLE));
606 gtk_widget_class_install_style_property (widget_class,
607 g_param_spec_int ("max-child-expand",
608 P_("Maximum child expand"),
609 P_("Maximum amount of space an expandable item will be given"),
613 GTK_PARAM_READABLE));
615 gtk_widget_class_install_style_property (widget_class,
616 g_param_spec_enum ("space-style",
618 P_("Whether spacers are vertical lines or just blank"),
619 GTK_TYPE_TOOLBAR_SPACE_STYLE,
621 GTK_PARAM_READABLE));
623 gtk_widget_class_install_style_property (widget_class,
624 g_param_spec_enum ("button-relief",
626 P_("Type of bevel around toolbar buttons"),
627 GTK_TYPE_RELIEF_STYLE,
629 GTK_PARAM_READABLE));
630 gtk_widget_class_install_style_property (widget_class,
631 g_param_spec_enum ("shadow-type",
633 P_("Style of bevel around the toolbar"),
634 GTK_TYPE_SHADOW_TYPE,
636 GTK_PARAM_READABLE));
638 gtk_settings_install_property (g_param_spec_enum ("gtk-toolbar-style",
640 P_("Whether default toolbars have text only, text and icons, icons only, etc."),
641 GTK_TYPE_TOOLBAR_STYLE,
642 DEFAULT_TOOLBAR_STYLE,
643 GTK_PARAM_READWRITE));
645 gtk_settings_install_property (g_param_spec_enum ("gtk-toolbar-icon-size",
646 P_("Toolbar icon size"),
647 P_("Size of icons in default toolbars"),
650 GTK_PARAM_READWRITE));
652 binding_set = gtk_binding_set_by_class (klass);
654 add_arrow_bindings (binding_set, GDK_Left, GTK_DIR_LEFT);
655 add_arrow_bindings (binding_set, GDK_Right, GTK_DIR_RIGHT);
656 add_arrow_bindings (binding_set, GDK_Up, GTK_DIR_UP);
657 add_arrow_bindings (binding_set, GDK_Down, GTK_DIR_DOWN);
659 gtk_binding_entry_add_signal (binding_set, GDK_KP_Home, 0,
660 "focus_home_or_end", 1,
661 G_TYPE_BOOLEAN, TRUE);
662 gtk_binding_entry_add_signal (binding_set, GDK_Home, 0,
663 "focus_home_or_end", 1,
664 G_TYPE_BOOLEAN, TRUE);
665 gtk_binding_entry_add_signal (binding_set, GDK_KP_End, 0,
666 "focus_home_or_end", 1,
667 G_TYPE_BOOLEAN, FALSE);
668 gtk_binding_entry_add_signal (binding_set, GDK_End, 0,
669 "focus_home_or_end", 1,
670 G_TYPE_BOOLEAN, FALSE);
672 add_ctrl_tab_bindings (binding_set, 0, GTK_DIR_TAB_FORWARD);
673 add_ctrl_tab_bindings (binding_set, GDK_SHIFT_MASK, GTK_DIR_TAB_BACKWARD);
675 g_type_class_add_private (gobject_class, sizeof (GtkToolbarPrivate));
679 gtk_toolbar_init (GtkToolbar *toolbar)
681 GtkToolbarPrivate *priv;
683 GTK_WIDGET_UNSET_FLAGS (toolbar, GTK_CAN_FOCUS);
684 GTK_WIDGET_SET_FLAGS (toolbar, GTK_NO_WINDOW);
686 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
688 toolbar->orientation = GTK_ORIENTATION_HORIZONTAL;
689 toolbar->style = DEFAULT_TOOLBAR_STYLE;
690 toolbar->icon_size = DEFAULT_ICON_SIZE;
691 priv->animation = DEFAULT_ANIMATION_STATE;
692 toolbar->tooltips = gtk_tooltips_new ();
693 g_object_ref_sink (toolbar->tooltips);
695 priv->arrow_button = gtk_toggle_button_new ();
696 g_signal_connect (priv->arrow_button, "button_press_event",
697 G_CALLBACK (gtk_toolbar_arrow_button_press), toolbar);
698 g_signal_connect (priv->arrow_button, "clicked",
699 G_CALLBACK (gtk_toolbar_arrow_button_clicked), toolbar);
700 gtk_button_set_relief (GTK_BUTTON (priv->arrow_button),
701 get_button_relief (toolbar));
703 priv->api_mode = DONT_KNOW;
705 gtk_button_set_focus_on_click (GTK_BUTTON (priv->arrow_button), FALSE);
707 priv->arrow = gtk_arrow_new (GTK_ARROW_DOWN, GTK_SHADOW_NONE);
708 gtk_widget_set_name (priv->arrow, "gtk-toolbar-arrow");
709 gtk_widget_show (priv->arrow);
710 gtk_container_add (GTK_CONTAINER (priv->arrow_button), priv->arrow);
712 gtk_widget_set_parent (priv->arrow_button, GTK_WIDGET (toolbar));
714 /* which child position a drop will occur at */
716 priv->show_arrow = TRUE;
717 priv->settings = NULL;
719 priv->max_homogeneous_pixels = -1;
721 priv->timer = g_timer_new ();
725 gtk_toolbar_set_property (GObject *object,
730 GtkToolbar *toolbar = GTK_TOOLBAR (object);
734 case PROP_ORIENTATION:
735 gtk_toolbar_set_orientation (toolbar, g_value_get_enum (value));
737 case PROP_TOOLBAR_STYLE:
738 gtk_toolbar_set_style (toolbar, g_value_get_enum (value));
740 case PROP_SHOW_ARROW:
741 gtk_toolbar_set_show_arrow (toolbar, g_value_get_boolean (value));
744 gtk_toolbar_set_tooltips (toolbar, g_value_get_boolean (value));
747 gtk_toolbar_set_icon_size (toolbar, g_value_get_enum (value));
749 case PROP_ICON_SIZE_SET:
750 if (g_value_get_boolean (value))
751 toolbar->icon_size_set = TRUE;
753 gtk_toolbar_unset_icon_size (toolbar);
756 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
762 gtk_toolbar_get_property (GObject *object,
767 GtkToolbar *toolbar = GTK_TOOLBAR (object);
768 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
772 case PROP_ORIENTATION:
773 g_value_set_enum (value, toolbar->orientation);
775 case PROP_TOOLBAR_STYLE:
776 g_value_set_enum (value, toolbar->style);
778 case PROP_SHOW_ARROW:
779 g_value_set_boolean (value, priv->show_arrow);
782 g_value_set_boolean (value, gtk_toolbar_get_tooltips (toolbar));
785 g_value_set_enum (value, gtk_toolbar_get_icon_size (toolbar));
787 case PROP_ICON_SIZE_SET:
788 g_value_set_boolean (value, toolbar->icon_size_set);
791 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
797 gtk_toolbar_map (GtkWidget *widget)
799 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (widget);
801 GTK_WIDGET_CLASS (gtk_toolbar_parent_class)->map (widget);
803 if (priv->event_window)
804 gdk_window_show_unraised (priv->event_window);
808 gtk_toolbar_unmap (GtkWidget *widget)
810 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (widget);
812 if (priv->event_window)
813 gdk_window_hide (priv->event_window);
815 GTK_WIDGET_CLASS (gtk_toolbar_parent_class)->unmap (widget);
819 gtk_toolbar_realize (GtkWidget *widget)
821 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
822 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
824 GdkWindowAttr attributes;
825 gint attributes_mask;
828 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
830 border_width = GTK_CONTAINER (widget)->border_width;
832 attributes.wclass = GDK_INPUT_ONLY;
833 attributes.window_type = GDK_WINDOW_CHILD;
834 attributes.x = widget->allocation.x + border_width;
835 attributes.y = widget->allocation.y + border_width;
836 attributes.width = widget->allocation.width - border_width * 2;
837 attributes.height = widget->allocation.height - border_width * 2;
838 attributes.event_mask = gtk_widget_get_events (widget);
839 attributes.event_mask |= (GDK_BUTTON_PRESS_MASK |
840 GDK_BUTTON_RELEASE_MASK |
841 GDK_ENTER_NOTIFY_MASK |
842 GDK_LEAVE_NOTIFY_MASK);
844 attributes_mask = GDK_WA_X | GDK_WA_Y;
846 widget->window = gtk_widget_get_parent_window (widget);
847 g_object_ref (widget->window);
848 widget->style = gtk_style_attach (widget->style, widget->window);
850 priv->event_window = gdk_window_new (gtk_widget_get_parent_window (widget),
851 &attributes, attributes_mask);
852 gdk_window_set_user_data (priv->event_window, toolbar);
856 gtk_toolbar_unrealize (GtkWidget *widget)
858 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (widget);
860 if (priv->event_window)
862 gdk_window_set_user_data (priv->event_window, NULL);
863 gdk_window_destroy (priv->event_window);
864 priv->event_window = NULL;
867 if (GTK_WIDGET_CLASS (gtk_toolbar_parent_class)->unrealize)
868 GTK_WIDGET_CLASS (gtk_toolbar_parent_class)->unrealize (widget);
872 gtk_toolbar_expose (GtkWidget *widget,
873 GdkEventExpose *event)
875 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
876 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
881 border_width = GTK_CONTAINER (widget)->border_width;
883 if (GTK_WIDGET_DRAWABLE (widget))
885 gtk_paint_box (widget->style,
887 GTK_WIDGET_STATE (widget),
888 get_shadow_type (toolbar),
889 &event->area, widget, "toolbar",
890 border_width + widget->allocation.x,
891 border_width + widget->allocation.y,
892 widget->allocation.width - 2 * border_width,
893 widget->allocation.height - 2 * border_width);
896 for (list = priv->content; list != NULL; list = list->next)
898 ToolbarContent *content = list->data;
900 toolbar_content_expose (content, GTK_CONTAINER (widget), event);
903 gtk_container_propagate_expose (GTK_CONTAINER (widget),
911 gtk_toolbar_size_request (GtkWidget *widget,
912 GtkRequisition *requisition)
914 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
915 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
917 gint max_child_height;
918 gint max_child_width;
919 gint max_homogeneous_child_width;
920 gint max_homogeneous_child_height;
921 gint homogeneous_size;
923 gint pack_front_size;
925 GtkRequisition arrow_requisition;
927 max_homogeneous_child_width = 0;
928 max_homogeneous_child_height = 0;
930 max_child_height = 0;
931 for (list = priv->content; list != NULL; list = list->next)
933 GtkRequisition requisition;
934 ToolbarContent *content = list->data;
936 if (!toolbar_content_visible (content, toolbar))
939 toolbar_content_size_request (content, toolbar, &requisition);
941 max_child_width = MAX (max_child_width, requisition.width);
942 max_child_height = MAX (max_child_height, requisition.height);
944 if (toolbar_content_is_homogeneous (content, toolbar))
946 max_homogeneous_child_width = MAX (max_homogeneous_child_width, requisition.width);
947 max_homogeneous_child_height = MAX (max_homogeneous_child_height, requisition.height);
951 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
952 homogeneous_size = max_homogeneous_child_width;
954 homogeneous_size = max_homogeneous_child_height;
957 for (list = priv->content; list != NULL; list = list->next)
959 ToolbarContent *content = list->data;
962 if (!toolbar_content_visible (content, toolbar))
965 if (toolbar_content_is_homogeneous (content, toolbar))
967 size = homogeneous_size;
971 GtkRequisition requisition;
973 toolbar_content_size_request (content, toolbar, &requisition);
975 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
976 size = requisition.width;
978 size = requisition.height;
981 pack_front_size += size;
984 if (priv->show_arrow && priv->api_mode == NEW_API)
986 gtk_widget_size_request (priv->arrow_button, &arrow_requisition);
988 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
989 long_req = arrow_requisition.width;
991 long_req = arrow_requisition.height;
993 /* There is no point requesting space for the arrow if that would take
994 * up more space than all the items combined
996 long_req = MIN (long_req, pack_front_size);
1000 arrow_requisition.height = 0;
1001 arrow_requisition.width = 0;
1003 long_req = pack_front_size;
1006 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
1008 requisition->width = long_req;
1009 requisition->height = MAX (max_child_height, arrow_requisition.height);
1013 requisition->height = long_req;
1014 requisition->width = MAX (max_child_width, arrow_requisition.width);
1018 ipadding = get_internal_padding (toolbar);
1020 requisition->width += 2 * (ipadding + GTK_CONTAINER (toolbar)->border_width);
1021 requisition->height += 2 * (ipadding + GTK_CONTAINER (toolbar)->border_width);
1023 if (get_shadow_type (toolbar) != GTK_SHADOW_NONE)
1025 requisition->width += 2 * widget->style->xthickness;
1026 requisition->height += 2 * widget->style->ythickness;
1029 toolbar->button_maxw = max_homogeneous_child_width;
1030 toolbar->button_maxh = max_homogeneous_child_height;
1034 position (GtkToolbar *toolbar,
1041 if (! GTK_TOOLBAR_GET_PRIVATE (toolbar)->animation)
1044 if (elapsed <= ACCEL_THRESHOLD)
1046 n_pixels = SLIDE_SPEED * elapsed;
1050 /* The formula is a second degree polynomial in
1051 * @elapsed that has the line SLIDE_SPEED * @elapsed
1052 * as tangent for @elapsed == ACCEL_THRESHOLD.
1053 * This makes @n_pixels a smooth function of elapsed time.
1055 n_pixels = (SLIDE_SPEED / ACCEL_THRESHOLD) * elapsed * elapsed -
1056 SLIDE_SPEED * elapsed + SLIDE_SPEED * ACCEL_THRESHOLD;
1060 return MIN (from + n_pixels, to);
1062 return MAX (from - n_pixels, to);
1066 compute_intermediate_allocation (GtkToolbar *toolbar,
1067 const GtkAllocation *start,
1068 const GtkAllocation *goal,
1069 GtkAllocation *intermediate)
1071 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1072 gdouble elapsed = g_timer_elapsed (priv->timer, NULL);
1074 intermediate->x = position (toolbar, start->x, goal->x, elapsed);
1075 intermediate->y = position (toolbar, start->y, goal->y, elapsed);
1076 intermediate->width = position (toolbar, start->x + start->width,
1077 goal->x + goal->width,
1078 elapsed) - intermediate->x;
1079 intermediate->height = position (toolbar, start->y + start->height,
1080 goal->y + goal->height,
1081 elapsed) - intermediate->y;
1085 fixup_allocation_for_rtl (gint total_size,
1086 GtkAllocation *allocation)
1088 allocation->x += (total_size - (2 * allocation->x + allocation->width));
1092 fixup_allocation_for_vertical (GtkAllocation *allocation)
1096 tmp = allocation->x;
1097 allocation->x = allocation->y;
1098 allocation->y = tmp;
1100 tmp = allocation->width;
1101 allocation->width = allocation->height;
1102 allocation->height = tmp;
1106 get_item_size (GtkToolbar *toolbar,
1107 ToolbarContent *content)
1109 GtkRequisition requisition;
1111 toolbar_content_size_request (content, toolbar, &requisition);
1113 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
1115 if (toolbar_content_is_homogeneous (content, toolbar))
1116 return toolbar->button_maxw;
1118 return requisition.width;
1122 if (toolbar_content_is_homogeneous (content, toolbar))
1123 return toolbar->button_maxh;
1125 return requisition.height;
1130 slide_idle_handler (gpointer data)
1132 GtkToolbar *toolbar = data;
1133 GtkToolbarPrivate *priv;
1136 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1138 if (priv->need_sync)
1141 priv->need_sync = FALSE;
1144 for (list = priv->content; list != NULL; list = list->next)
1146 ToolbarContent *content = list->data;
1148 GtkAllocation goal_allocation;
1149 GtkAllocation allocation;
1152 state = toolbar_content_get_state (content);
1153 toolbar_content_get_goal_allocation (content, &goal_allocation);
1154 toolbar_content_get_allocation (content, &allocation);
1158 if (state == NOT_ALLOCATED)
1160 /* an unallocated item means that size allocate has to
1161 * called at least once more
1166 /* An invisible item with a goal allocation of
1167 * 0 is already at its goal.
1169 if ((state == NORMAL || state == OVERFLOWN) &&
1170 ((goal_allocation.width != 0 &&
1171 goal_allocation.height != 0) ||
1172 toolbar_content_child_visible (content)))
1174 if ((goal_allocation.x != allocation.x ||
1175 goal_allocation.y != allocation.y ||
1176 goal_allocation.width != allocation.width ||
1177 goal_allocation.height != allocation.height))
1179 /* An item is not in its right position yet. Note
1180 * that OVERFLOWN items do get an allocation in
1181 * gtk_toolbar_size_allocate(). This way you can see
1182 * them slide back in when you drag an item off the
1189 if (toolbar_content_is_placeholder (content) &&
1190 toolbar_content_disappearing (content) &&
1191 toolbar_content_child_visible (content))
1193 /* A disappearing placeholder is still visible.
1201 gtk_widget_queue_resize_no_redraw (GTK_WIDGET (toolbar));
1203 GDK_THREADS_LEAVE ();
1208 priv->is_sliding = FALSE;
1215 rect_within (GtkAllocation *a1,
1218 return (a1->x >= a2->x &&
1219 a1->x + a1->width <= a2->x + a2->width &&
1221 a1->y + a1->height <= a2->y + a2->height);
1225 gtk_toolbar_begin_sliding (GtkToolbar *toolbar)
1227 GtkWidget *widget = GTK_WIDGET (toolbar);
1228 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1236 /* Start the sliding. This function copies the allocation of every
1237 * item into content->start_allocation. For items that haven't
1238 * been allocated yet, we calculate their position and save that
1239 * in start_allocatino along with zero width and zero height.
1241 * FIXME: It would be nice if we could share this code with
1242 * the equivalent in gtk_widget_size_allocate().
1244 priv->is_sliding = TRUE;
1247 priv->idle_id = gdk_threads_add_idle (slide_idle_handler, toolbar);
1249 rtl = (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL);
1250 vertical = (toolbar->orientation == GTK_ORIENTATION_VERTICAL);
1251 border_width = get_internal_padding (toolbar) + GTK_CONTAINER (toolbar)->border_width;
1255 cur_x = widget->allocation.width - border_width - widget->style->xthickness;
1256 cur_y = widget->allocation.height - border_width - widget->style->ythickness;
1260 cur_x = border_width + widget->style->xthickness;
1261 cur_y = border_width + widget->style->ythickness;
1264 cur_x += widget->allocation.x;
1265 cur_y += widget->allocation.y;
1267 for (list = priv->content; list != NULL; list = list->next)
1269 ToolbarContent *content = list->data;
1270 GtkAllocation new_start_allocation;
1271 GtkAllocation item_allocation;
1274 state = toolbar_content_get_state (content);
1275 toolbar_content_get_allocation (content, &item_allocation);
1277 if ((state == NORMAL &&
1278 rect_within (&item_allocation, &(widget->allocation))) ||
1281 new_start_allocation = item_allocation;
1285 new_start_allocation.x = cur_x;
1286 new_start_allocation.y = cur_y;
1290 new_start_allocation.width = widget->allocation.width -
1291 2 * border_width - 2 * widget->style->xthickness;
1292 new_start_allocation.height = 0;
1296 new_start_allocation.width = 0;
1297 new_start_allocation.height = widget->allocation.height -
1298 2 * border_width - 2 * widget->style->ythickness;
1303 cur_y = new_start_allocation.y + new_start_allocation.height;
1305 cur_x = new_start_allocation.x;
1307 cur_x = new_start_allocation.x + new_start_allocation.width;
1309 toolbar_content_set_start_allocation (content, &new_start_allocation);
1312 /* This resize will run before the first idle handler. This
1313 * will make sure that items get the right goal allocation
1314 * so that the idle handler will not immediately return
1317 gtk_widget_queue_resize_no_redraw (GTK_WIDGET (toolbar));
1318 g_timer_reset (priv->timer);
1322 gtk_toolbar_stop_sliding (GtkToolbar *toolbar)
1324 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1326 if (priv->is_sliding)
1330 priv->is_sliding = FALSE;
1334 g_source_remove (priv->idle_id);
1338 list = priv->content;
1341 ToolbarContent *content = list->data;
1344 if (toolbar_content_is_placeholder (content))
1346 toolbar_content_remove (content, toolbar);
1347 toolbar_content_free (content);
1351 gtk_widget_queue_resize_no_redraw (GTK_WIDGET (toolbar));
1356 remove_item (GtkWidget *menu_item,
1359 gtk_container_remove (GTK_CONTAINER (menu_item->parent), menu_item);
1363 menu_deactivated (GtkWidget *menu,
1364 GtkToolbar *toolbar)
1366 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1367 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (priv->arrow_button), FALSE);
1371 menu_detached (GtkWidget *toolbar,
1374 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1379 rebuild_menu (GtkToolbar *toolbar)
1381 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1382 GList *list, *children;
1386 priv->menu = GTK_MENU (gtk_menu_new());
1387 gtk_menu_attach_to_widget (priv->menu,
1388 GTK_WIDGET (toolbar),
1391 g_signal_connect (priv->menu, "deactivate", G_CALLBACK (menu_deactivated), toolbar);
1394 gtk_container_foreach (GTK_CONTAINER (priv->menu), remove_item, NULL);
1396 for (list = priv->content; list != NULL; list = list->next)
1398 ToolbarContent *content = list->data;
1400 if (toolbar_content_get_state (content) == OVERFLOWN &&
1401 !toolbar_content_is_placeholder (content))
1403 GtkWidget *menu_item = toolbar_content_retrieve_menu_item (content);
1407 g_assert (GTK_IS_MENU_ITEM (menu_item));
1408 gtk_menu_shell_append (GTK_MENU_SHELL (priv->menu), menu_item);
1413 /* Remove leading and trailing separator items */
1414 children = gtk_container_get_children (GTK_CONTAINER (priv->menu));
1417 while (list && GTK_IS_SEPARATOR_MENU_ITEM (list->data))
1419 GtkWidget *child = list->data;
1421 gtk_container_remove (GTK_CONTAINER (priv->menu), child);
1424 g_list_free (children);
1426 /* Regenerate the list of children so we don't try to remove items twice */
1427 children = gtk_container_get_children (GTK_CONTAINER (priv->menu));
1429 list = g_list_last (children);
1430 while (list && GTK_IS_SEPARATOR_MENU_ITEM (list->data))
1432 GtkWidget *child = list->data;
1434 gtk_container_remove (GTK_CONTAINER (priv->menu), child);
1437 g_list_free (children);
1439 priv->need_rebuild = FALSE;
1443 gtk_toolbar_size_allocate (GtkWidget *widget,
1444 GtkAllocation *allocation)
1446 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
1447 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1448 GtkAllocation *allocations;
1449 ItemState *new_states;
1450 GtkAllocation arrow_allocation;
1452 gint size, pos, short_size;
1455 gboolean need_arrow;
1456 gint n_expand_items;
1458 gint available_size;
1461 GtkRequisition arrow_requisition;
1462 gboolean overflowing;
1463 gboolean size_changed;
1465 GtkAllocation item_area;
1466 GtkShadowType shadow_type;
1468 size_changed = FALSE;
1469 if (widget->allocation.x != allocation->x ||
1470 widget->allocation.y != allocation->y ||
1471 widget->allocation.width != allocation->width ||
1472 widget->allocation.height != allocation->height)
1474 size_changed = TRUE;
1478 gtk_toolbar_stop_sliding (toolbar);
1480 widget->allocation = *allocation;
1482 border_width = GTK_CONTAINER (toolbar)->border_width;
1484 if (GTK_WIDGET_REALIZED (widget))
1486 gdk_window_move_resize (priv->event_window,
1487 allocation->x + border_width,
1488 allocation->y + border_width,
1489 allocation->width - border_width * 2,
1490 allocation->height - border_width * 2);
1493 border_width += get_internal_padding (toolbar);
1495 gtk_widget_get_child_requisition (GTK_WIDGET (priv->arrow_button),
1496 &arrow_requisition);
1498 shadow_type = get_shadow_type (toolbar);
1500 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
1502 available_size = size = allocation->width - 2 * border_width;
1503 short_size = allocation->height - 2 * border_width;
1504 arrow_size = arrow_requisition.width;
1506 if (shadow_type != GTK_SHADOW_NONE)
1508 available_size -= 2 * widget->style->xthickness;
1509 short_size -= 2 * widget->style->ythickness;
1514 available_size = size = allocation->height - 2 * border_width;
1515 short_size = allocation->width - 2 * border_width;
1516 arrow_size = arrow_requisition.height;
1518 if (shadow_type != GTK_SHADOW_NONE)
1520 available_size -= 2 * widget->style->ythickness;
1521 short_size -= 2 * widget->style->xthickness;
1525 n_items = g_list_length (priv->content);
1526 allocations = g_new0 (GtkAllocation, n_items);
1527 new_states = g_new0 (ItemState, n_items);
1531 for (list = priv->content; list != NULL; list = list->next)
1533 ToolbarContent *content = list->data;
1535 if (toolbar_content_visible (content, toolbar))
1537 needed_size += get_item_size (toolbar, content);
1539 /* Do we need an arrow?
1541 * Assume we don't, and see if any non-separator item with a
1542 * proxy menu item is then going to overflow.
1544 if (needed_size > available_size &&
1547 priv->api_mode == NEW_API &&
1548 toolbar_content_has_proxy_menu_item (content) &&
1549 !toolbar_content_is_separator (content))
1557 size = available_size - arrow_size;
1559 size = available_size;
1561 /* calculate widths and states of items */
1562 overflowing = FALSE;
1563 for (list = priv->content, i = 0; list != NULL; list = list->next, ++i)
1565 ToolbarContent *content = list->data;
1568 if (!toolbar_content_visible (content, toolbar))
1570 new_states[i] = HIDDEN;
1574 item_size = get_item_size (toolbar, content);
1575 if (item_size <= size && !overflowing)
1578 allocations[i].width = item_size;
1579 new_states[i] = NORMAL;
1584 new_states[i] = OVERFLOWN;
1585 allocations[i].width = item_size;
1589 /* calculate width of arrow */
1592 arrow_allocation.width = arrow_size;
1593 arrow_allocation.height = MAX (short_size, 1);
1596 /* expand expandable items */
1598 /* We don't expand when there is an overflow menu, because that leads to
1599 * weird jumps when items get moved to the overflow menu and the expanding
1600 * items suddenly get a lot of extra space
1604 gint max_child_expand;
1607 for (i = 0, list = priv->content; list != NULL; list = list->next, ++i)
1609 ToolbarContent *content = list->data;
1611 if (toolbar_content_get_expand (content) && new_states[i] == NORMAL)
1615 max_child_expand = get_max_child_expand (toolbar);
1616 for (list = priv->content, i = 0; list != NULL; list = list->next, ++i)
1618 ToolbarContent *content = list->data;
1620 if (toolbar_content_get_expand (content) && new_states[i] == NORMAL)
1622 gint extra = size / n_expand_items;
1623 if (size % n_expand_items != 0)
1626 if (extra > max_child_expand)
1627 extra = max_child_expand;
1629 allocations[i].width += extra;
1635 g_assert (n_expand_items == 0);
1638 /* position items */
1640 for (list = priv->content, i = 0; list != NULL; list = list->next, ++i)
1642 /* both NORMAL and OVERFLOWN items get a position. This ensures
1643 * that sliding will work for OVERFLOWN items too
1645 if (new_states[i] == NORMAL ||
1646 new_states[i] == OVERFLOWN)
1648 allocations[i].x = pos;
1649 allocations[i].y = border_width;
1650 allocations[i].height = short_size;
1652 pos += allocations[i].width;
1656 /* position arrow */
1659 arrow_allocation.x = available_size - border_width - arrow_allocation.width;
1660 arrow_allocation.y = border_width;
1663 item_area.x = border_width;
1664 item_area.y = border_width;
1665 item_area.width = available_size - (need_arrow? arrow_size : 0);
1666 item_area.height = short_size;
1668 /* fix up allocations in the vertical or RTL cases */
1669 if (toolbar->orientation == GTK_ORIENTATION_VERTICAL)
1671 for (i = 0; i < n_items; ++i)
1672 fixup_allocation_for_vertical (&(allocations[i]));
1675 fixup_allocation_for_vertical (&arrow_allocation);
1677 fixup_allocation_for_vertical (&item_area);
1679 else if (gtk_widget_get_direction (GTK_WIDGET (toolbar)) == GTK_TEXT_DIR_RTL)
1681 for (i = 0; i < n_items; ++i)
1682 fixup_allocation_for_rtl (available_size, &(allocations[i]));
1685 fixup_allocation_for_rtl (available_size, &arrow_allocation);
1687 fixup_allocation_for_rtl (available_size, &item_area);
1690 /* translate the items by allocation->(x,y) */
1691 for (i = 0; i < n_items; ++i)
1693 allocations[i].x += allocation->x;
1694 allocations[i].y += allocation->y;
1696 if (shadow_type != GTK_SHADOW_NONE)
1698 allocations[i].x += widget->style->xthickness;
1699 allocations[i].y += widget->style->ythickness;
1705 arrow_allocation.x += allocation->x;
1706 arrow_allocation.y += allocation->y;
1708 if (shadow_type != GTK_SHADOW_NONE)
1710 arrow_allocation.x += widget->style->xthickness;
1711 arrow_allocation.y += widget->style->ythickness;
1715 item_area.x += allocation->x;
1716 item_area.y += allocation->y;
1717 if (shadow_type != GTK_SHADOW_NONE)
1719 item_area.x += widget->style->xthickness;
1720 item_area.y += widget->style->ythickness;
1723 /* did anything change? */
1724 for (list = priv->content, i = 0; list != NULL; list = list->next, i++)
1726 ToolbarContent *content = list->data;
1728 if (toolbar_content_get_state (content) == NORMAL &&
1729 new_states[i] != NORMAL)
1731 /* an item disappeared and we didn't change size, so begin sliding */
1732 if (!size_changed && priv->api_mode == NEW_API)
1733 gtk_toolbar_begin_sliding (toolbar);
1737 /* finally allocate the items */
1738 if (priv->is_sliding)
1740 for (list = priv->content, i = 0; list != NULL; list = list->next, i++)
1742 ToolbarContent *content = list->data;
1744 toolbar_content_set_goal_allocation (content, &(allocations[i]));
1748 elapsed = g_timer_elapsed (priv->timer, NULL);
1749 for (list = priv->content, i = 0; list != NULL; list = list->next, ++i)
1751 ToolbarContent *content = list->data;
1753 if (new_states[i] == OVERFLOWN ||
1754 new_states[i] == NORMAL)
1756 GtkAllocation alloc;
1757 GtkAllocation start_allocation = { 0, };
1758 GtkAllocation goal_allocation;
1760 if (priv->is_sliding)
1762 toolbar_content_get_start_allocation (content, &start_allocation);
1763 toolbar_content_get_goal_allocation (content, &goal_allocation);
1765 compute_intermediate_allocation (toolbar,
1770 priv->need_sync = TRUE;
1774 alloc = allocations[i];
1777 if (alloc.width <= 0 || alloc.height <= 0)
1779 toolbar_content_set_child_visible (content, toolbar, FALSE);
1783 if (!rect_within (&alloc, &item_area))
1785 toolbar_content_set_child_visible (content, toolbar, FALSE);
1786 toolbar_content_size_allocate (content, &alloc);
1790 toolbar_content_set_child_visible (content, toolbar, TRUE);
1791 toolbar_content_size_allocate (content, &alloc);
1797 toolbar_content_set_child_visible (content, toolbar, FALSE);
1800 toolbar_content_set_state (content, new_states[i]);
1803 if (priv->menu && priv->need_rebuild)
1804 rebuild_menu (toolbar);
1808 gtk_widget_size_allocate (GTK_WIDGET (priv->arrow_button),
1810 gtk_widget_show (GTK_WIDGET (priv->arrow_button));
1814 gtk_widget_hide (GTK_WIDGET (priv->arrow_button));
1816 if (priv->menu && GTK_WIDGET_VISIBLE (priv->menu))
1817 gtk_menu_shell_deactivate (GTK_MENU_SHELL (priv->menu));
1820 g_free (allocations);
1821 g_free (new_states);
1825 gtk_toolbar_update_button_relief (GtkToolbar *toolbar)
1827 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1828 GtkReliefStyle relief;
1830 relief = get_button_relief (toolbar);
1832 if (relief != gtk_button_get_relief (GTK_BUTTON (priv->arrow_button)))
1834 gtk_toolbar_reconfigured (toolbar);
1836 gtk_button_set_relief (GTK_BUTTON (priv->arrow_button), relief);
1841 gtk_toolbar_style_set (GtkWidget *widget,
1842 GtkStyle *prev_style)
1844 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (widget);
1846 priv->max_homogeneous_pixels = -1;
1848 if (GTK_WIDGET_REALIZED (widget))
1849 gtk_style_set_background (widget->style, widget->window, widget->state);
1852 gtk_toolbar_update_button_relief (GTK_TOOLBAR (widget));
1856 gtk_toolbar_list_children_in_focus_order (GtkToolbar *toolbar,
1857 GtkDirectionType dir)
1859 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1860 GList *result = NULL;
1864 /* generate list of children in reverse logical order */
1866 for (list = priv->content; list != NULL; list = list->next)
1868 ToolbarContent *content = list->data;
1871 widget = toolbar_content_get_widget (content);
1874 result = g_list_prepend (result, widget);
1877 result = g_list_prepend (result, priv->arrow_button);
1879 rtl = (gtk_widget_get_direction (GTK_WIDGET (toolbar)) == GTK_TEXT_DIR_RTL);
1881 /* move in logical order when
1883 * - dir is TAB_FORWARD
1885 * - in RTL mode and moving left or up
1887 * - in LTR mode and moving right or down
1889 if (dir == GTK_DIR_TAB_FORWARD ||
1890 (rtl && (dir == GTK_DIR_UP || dir == GTK_DIR_LEFT)) ||
1891 (!rtl && (dir == GTK_DIR_DOWN || dir == GTK_DIR_RIGHT)))
1893 result = g_list_reverse (result);
1900 gtk_toolbar_focus_home_or_end (GtkToolbar *toolbar,
1901 gboolean focus_home)
1903 GList *children, *list;
1904 GtkDirectionType dir = focus_home? GTK_DIR_RIGHT : GTK_DIR_LEFT;
1906 children = gtk_toolbar_list_children_in_focus_order (toolbar, dir);
1908 if (gtk_widget_get_direction (GTK_WIDGET (toolbar)) == GTK_TEXT_DIR_RTL)
1910 children = g_list_reverse (children);
1912 dir = (dir == GTK_DIR_RIGHT)? GTK_DIR_LEFT : GTK_DIR_RIGHT;
1915 for (list = children; list != NULL; list = list->next)
1917 GtkWidget *child = list->data;
1919 if (GTK_CONTAINER (toolbar)->focus_child == child)
1922 if (GTK_WIDGET_MAPPED (child) && gtk_widget_child_focus (child, dir))
1926 g_list_free (children);
1931 /* Keybinding handler. This function is called when the user presses
1932 * Ctrl TAB or an arrow key.
1935 gtk_toolbar_move_focus (GtkWidget *widget,
1936 GtkDirectionType dir)
1938 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
1939 GtkContainer *container = GTK_CONTAINER (toolbar);
1941 gboolean try_focus = FALSE;
1944 if (container->focus_child &&
1945 gtk_widget_child_focus (container->focus_child, dir))
1950 children = gtk_toolbar_list_children_in_focus_order (toolbar, dir);
1952 for (list = children; list != NULL; list = list->next)
1954 GtkWidget *child = list->data;
1956 if (try_focus && GTK_WIDGET_MAPPED (child) && gtk_widget_child_focus (child, dir))
1959 if (child == GTK_CONTAINER (toolbar)->focus_child)
1963 g_list_free (children);
1966 /* The focus handler for the toolbar. It called when the user presses
1967 * TAB or otherwise tries to focus the toolbar.
1970 gtk_toolbar_focus (GtkWidget *widget,
1971 GtkDirectionType dir)
1973 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
1974 GList *children, *list;
1975 gboolean result = FALSE;
1977 /* if focus is already somewhere inside the toolbar then return FALSE.
1978 * The only way focus can stay inside the toolbar is when the user presses
1979 * arrow keys or Ctrl TAB (both of which are handled by the
1980 * gtk_toolbar_move_focus() keybinding function.
1982 if (GTK_CONTAINER (widget)->focus_child)
1985 children = gtk_toolbar_list_children_in_focus_order (toolbar, dir);
1987 for (list = children; list != NULL; list = list->next)
1989 GtkWidget *child = list->data;
1991 if (GTK_WIDGET_MAPPED (child) && gtk_widget_child_focus (child, dir))
1998 g_list_free (children);
2003 static GtkSettings *
2004 toolbar_get_settings (GtkToolbar *toolbar)
2006 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2007 return priv->settings;
2011 style_change_notify (GtkToolbar *toolbar)
2013 if (!toolbar->style_set)
2015 /* pretend it was set, then unset, thus reverting to new default */
2016 toolbar->style_set = TRUE;
2017 gtk_toolbar_unset_style (toolbar);
2022 icon_size_change_notify (GtkToolbar *toolbar)
2024 if (!toolbar->icon_size_set)
2026 /* pretend it was set, then unset, thus reverting to new default */
2027 toolbar->icon_size_set = TRUE;
2028 gtk_toolbar_unset_icon_size (toolbar);
2033 animation_change_notify (GtkToolbar *toolbar)
2035 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2036 GtkSettings *settings = toolbar_get_settings (toolbar);
2040 g_object_get (settings,
2041 "gtk-enable-animations", &animation,
2044 animation = DEFAULT_ANIMATION_STATE;
2046 priv->animation = animation;
2050 settings_change_notify (GtkSettings *settings,
2051 const GParamSpec *pspec,
2052 GtkToolbar *toolbar)
2054 if (! strcmp (pspec->name, "gtk-toolbar-style"))
2055 style_change_notify (toolbar);
2056 else if (! strcmp (pspec->name, "gtk-toolbar-icon-size"))
2057 icon_size_change_notify (toolbar);
2058 else if (! strcmp (pspec->name, "gtk-enable-animations"))
2059 animation_change_notify (toolbar);
2063 gtk_toolbar_screen_changed (GtkWidget *widget,
2064 GdkScreen *previous_screen)
2066 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (widget);
2067 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
2068 GtkSettings *old_settings = toolbar_get_settings (toolbar);
2069 GtkSettings *settings;
2071 if (gtk_widget_has_screen (GTK_WIDGET (toolbar)))
2072 settings = gtk_widget_get_settings (GTK_WIDGET (toolbar));
2076 if (settings == old_settings)
2081 g_signal_handler_disconnect (old_settings, priv->settings_connection);
2083 g_object_unref (old_settings);
2088 priv->settings_connection =
2089 g_signal_connect (settings, "notify",
2090 G_CALLBACK (settings_change_notify),
2093 priv->settings = g_object_ref (settings);
2096 priv->settings = NULL;
2098 style_change_notify (toolbar);
2099 icon_size_change_notify (toolbar);
2100 animation_change_notify (toolbar);
2104 find_drop_index (GtkToolbar *toolbar,
2108 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2109 GList *interesting_content;
2111 GtkOrientation orientation;
2112 GtkTextDirection direction;
2113 gint best_distance = G_MAXINT;
2117 ToolbarContent *best_content;
2118 GtkAllocation allocation;
2120 /* list items we care about wrt. drag and drop */
2121 interesting_content = NULL;
2122 for (list = priv->content; list != NULL; list = list->next)
2124 ToolbarContent *content = list->data;
2126 if (toolbar_content_get_state (content) == NORMAL)
2127 interesting_content = g_list_prepend (interesting_content, content);
2129 interesting_content = g_list_reverse (interesting_content);
2131 if (!interesting_content)
2134 orientation = toolbar->orientation;
2135 direction = gtk_widget_get_direction (GTK_WIDGET (toolbar));
2137 /* distance to first interesting item */
2138 best_content = interesting_content->data;
2139 toolbar_content_get_allocation (best_content, &allocation);
2141 if (orientation == GTK_ORIENTATION_HORIZONTAL)
2145 if (direction == GTK_TEXT_DIR_LTR)
2148 pos = allocation.x + allocation.width;
2156 best_content = NULL;
2157 best_distance = ABS (pos - cursor);
2159 /* distance to far end of each item */
2160 for (list = interesting_content; list != NULL; list = list->next)
2162 ToolbarContent *content = list->data;
2164 toolbar_content_get_allocation (content, &allocation);
2166 if (orientation == GTK_ORIENTATION_HORIZONTAL)
2168 if (direction == GTK_TEXT_DIR_LTR)
2169 pos = allocation.x + allocation.width;
2175 pos = allocation.y + allocation.height;
2178 distance = ABS (pos - cursor);
2180 if (distance < best_distance)
2182 best_distance = distance;
2183 best_content = content;
2187 g_list_free (interesting_content);
2192 return g_list_index (priv->content, best_content) + 1;
2196 reset_all_placeholders (GtkToolbar *toolbar)
2198 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2201 for (list = priv->content; list != NULL; list = list->next)
2203 ToolbarContent *content = list->data;
2204 if (toolbar_content_is_placeholder (content))
2205 toolbar_content_set_disappearing (content, TRUE);
2210 physical_to_logical (GtkToolbar *toolbar,
2213 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2217 g_assert (physical >= 0);
2220 for (list = priv->content; list && physical > 0; list = list->next)
2222 ToolbarContent *content = list->data;
2224 if (!toolbar_content_is_placeholder (content))
2229 g_assert (physical == 0);
2235 logical_to_physical (GtkToolbar *toolbar,
2238 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2242 g_assert (logical >= 0);
2245 for (list = priv->content; list; list = list->next)
2247 ToolbarContent *content = list->data;
2249 if (!toolbar_content_is_placeholder (content))
2259 g_assert (logical == 0);
2265 * gtk_toolbar_set_drop_highlight_item:
2266 * @toolbar: a #GtkToolbar
2267 * @tool_item: a #GtkToolItem, or %NULL to turn of highlighting
2268 * @index_: a position on @toolbar
2270 * Highlights @toolbar to give an idea of what it would look like
2271 * if @item was added to @toolbar at the position indicated by @index_.
2272 * If @item is %NULL, highlighting is turned off. In that case @index_
2275 * The @tool_item passed to this function must not be part of any widget
2276 * hierarchy. When an item is set as drop highlight item it can not
2277 * added to any widget hierarchy or used as highlight item for another
2283 gtk_toolbar_set_drop_highlight_item (GtkToolbar *toolbar,
2284 GtkToolItem *tool_item,
2287 ToolbarContent *content;
2288 GtkToolbarPrivate *priv;
2290 GtkRequisition requisition;
2291 GtkRequisition old_requisition;
2292 gboolean restart_sliding;
2294 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2295 g_return_if_fail (tool_item == NULL || GTK_IS_TOOL_ITEM (tool_item));
2297 gtk_toolbar_check_new_api (toolbar);
2299 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2303 if (priv->highlight_tool_item)
2305 gtk_widget_unparent (GTK_WIDGET (priv->highlight_tool_item));
2306 g_object_unref (priv->highlight_tool_item);
2307 priv->highlight_tool_item = NULL;
2310 reset_all_placeholders (toolbar);
2311 gtk_toolbar_begin_sliding (toolbar);
2315 n_items = gtk_toolbar_get_n_items (toolbar);
2316 if (index_ < 0 || index_ > n_items)
2319 if (tool_item != priv->highlight_tool_item)
2321 if (priv->highlight_tool_item)
2322 g_object_unref (priv->highlight_tool_item);
2324 g_object_ref_sink (tool_item);
2326 priv->highlight_tool_item = tool_item;
2328 gtk_widget_set_parent (GTK_WIDGET (priv->highlight_tool_item),
2329 GTK_WIDGET (toolbar));
2332 index_ = logical_to_physical (toolbar, index_);
2334 content = g_list_nth_data (priv->content, index_);
2338 ToolbarContent *prev_content;
2340 prev_content = g_list_nth_data (priv->content, index_ - 1);
2342 if (prev_content && toolbar_content_is_placeholder (prev_content))
2343 content = prev_content;
2346 if (!content || !toolbar_content_is_placeholder (content))
2348 GtkWidget *placeholder;
2350 placeholder = GTK_WIDGET (gtk_separator_tool_item_new ());
2352 content = toolbar_content_new_tool_item (toolbar,
2353 GTK_TOOL_ITEM (placeholder),
2355 gtk_widget_show (placeholder);
2359 g_assert (toolbar_content_is_placeholder (content));
2361 gtk_widget_size_request (GTK_WIDGET (priv->highlight_tool_item),
2364 toolbar_content_set_expand (content, gtk_tool_item_get_expand (tool_item));
2366 restart_sliding = FALSE;
2367 toolbar_content_size_request (content, toolbar, &old_requisition);
2368 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
2370 requisition.height = -1;
2371 if (requisition.width != old_requisition.width)
2372 restart_sliding = TRUE;
2376 requisition.width = -1;
2377 if (requisition.height != old_requisition.height)
2378 restart_sliding = TRUE;
2381 if (toolbar_content_disappearing (content))
2382 restart_sliding = TRUE;
2384 reset_all_placeholders (toolbar);
2385 toolbar_content_set_disappearing (content, FALSE);
2387 toolbar_content_set_size_request (content,
2388 requisition.width, requisition.height);
2390 if (restart_sliding)
2391 gtk_toolbar_begin_sliding (toolbar);
2395 gtk_toolbar_get_child_property (GtkContainer *container,
2401 GtkToolItem *item = GTK_TOOL_ITEM (child);
2403 switch (property_id)
2405 case CHILD_PROP_HOMOGENEOUS:
2406 g_value_set_boolean (value, gtk_tool_item_get_homogeneous (item));
2409 case CHILD_PROP_EXPAND:
2410 g_value_set_boolean (value, gtk_tool_item_get_expand (item));
2414 GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, property_id, pspec);
2420 gtk_toolbar_set_child_property (GtkContainer *container,
2423 const GValue *value,
2426 switch (property_id)
2428 case CHILD_PROP_HOMOGENEOUS:
2429 gtk_tool_item_set_homogeneous (GTK_TOOL_ITEM (child), g_value_get_boolean (value));
2432 case CHILD_PROP_EXPAND:
2433 gtk_tool_item_set_expand (GTK_TOOL_ITEM (child), g_value_get_boolean (value));
2437 GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, property_id, pspec);
2443 gtk_toolbar_show_all (GtkWidget *widget)
2445 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (widget);
2448 for (list = priv->content; list != NULL; list = list->next)
2450 ToolbarContent *content = list->data;
2452 toolbar_content_show_all (content);
2455 gtk_widget_show (widget);
2459 gtk_toolbar_hide_all (GtkWidget *widget)
2461 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (widget);
2464 for (list = priv->content; list != NULL; list = list->next)
2466 ToolbarContent *content = list->data;
2468 toolbar_content_hide_all (content);
2471 gtk_widget_hide (widget);
2475 gtk_toolbar_add (GtkContainer *container,
2478 GtkToolbar *toolbar;
2480 g_return_if_fail (GTK_IS_TOOLBAR (container));
2481 g_return_if_fail (widget != NULL);
2483 toolbar = GTK_TOOLBAR (container);
2485 if (GTK_IS_TOOL_ITEM (widget))
2486 gtk_toolbar_insert (toolbar, GTK_TOOL_ITEM (widget), -1);
2488 gtk_toolbar_append_widget (toolbar, widget, NULL, NULL);
2492 gtk_toolbar_remove (GtkContainer *container,
2495 GtkToolbar *toolbar;
2496 GtkToolbarPrivate *priv;
2497 ToolbarContent *content_to_remove;
2500 g_return_if_fail (GTK_IS_TOOLBAR (container));
2501 g_return_if_fail (GTK_IS_WIDGET (widget));
2503 toolbar = GTK_TOOLBAR (container);
2504 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2506 content_to_remove = NULL;
2507 for (list = priv->content; list != NULL; list = list->next)
2509 ToolbarContent *content = list->data;
2512 child = toolbar_content_get_widget (content);
2513 if (child && child == widget)
2515 content_to_remove = content;
2520 g_return_if_fail (content_to_remove != NULL);
2522 toolbar_content_remove (content_to_remove, toolbar);
2523 toolbar_content_free (content_to_remove);
2527 gtk_toolbar_forall (GtkContainer *container,
2528 gboolean include_internals,
2529 GtkCallback callback,
2530 gpointer callback_data)
2532 GtkToolbar *toolbar = GTK_TOOLBAR (container);
2533 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2536 g_return_if_fail (callback != NULL);
2538 list = priv->content;
2541 ToolbarContent *content = list->data;
2542 GList *next = list->next;
2544 if (include_internals || !toolbar_content_is_placeholder (content))
2546 GtkWidget *child = toolbar_content_get_widget (content);
2549 callback (child, callback_data);
2555 if (include_internals)
2556 callback (priv->arrow_button, callback_data);
2560 gtk_toolbar_child_type (GtkContainer *container)
2562 return GTK_TYPE_TOOL_ITEM;
2566 gtk_toolbar_reconfigured (GtkToolbar *toolbar)
2568 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2571 list = priv->content;
2574 ToolbarContent *content = list->data;
2575 GList *next = list->next;
2577 toolbar_content_toolbar_reconfigured (content, toolbar);
2584 gtk_toolbar_orientation_changed (GtkToolbar *toolbar,
2585 GtkOrientation orientation)
2587 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2588 if (toolbar->orientation != orientation)
2590 toolbar->orientation = orientation;
2592 if (orientation == GTK_ORIENTATION_HORIZONTAL)
2593 gtk_arrow_set (GTK_ARROW (priv->arrow), GTK_ARROW_DOWN, GTK_SHADOW_NONE);
2595 gtk_arrow_set (GTK_ARROW (priv->arrow), GTK_ARROW_RIGHT, GTK_SHADOW_NONE);
2597 gtk_toolbar_reconfigured (toolbar);
2599 gtk_widget_queue_resize (GTK_WIDGET (toolbar));
2600 g_object_notify (G_OBJECT (toolbar), "orientation");
2605 gtk_toolbar_real_style_changed (GtkToolbar *toolbar,
2606 GtkToolbarStyle style)
2608 if (toolbar->style != style)
2610 toolbar->style = style;
2612 gtk_toolbar_reconfigured (toolbar);
2614 gtk_widget_queue_resize (GTK_WIDGET (toolbar));
2615 g_object_notify (G_OBJECT (toolbar), "toolbar-style");
2620 menu_position_func (GtkMenu *menu,
2626 GtkToolbar *toolbar = GTK_TOOLBAR (user_data);
2627 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2629 GtkRequisition menu_req;
2630 GdkRectangle monitor;
2634 gtk_widget_size_request (priv->arrow_button, &req);
2635 gtk_widget_size_request (GTK_WIDGET (menu), &menu_req);
2637 screen = gtk_widget_get_screen (GTK_WIDGET (menu));
2638 monitor_num = gdk_screen_get_monitor_at_window (screen, priv->arrow_button->window);
2639 if (monitor_num < 0)
2641 gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor);
2643 gdk_window_get_origin (GTK_BUTTON (priv->arrow_button)->event_window, x, y);
2644 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
2646 if (gtk_widget_get_direction (GTK_WIDGET (toolbar)) == GTK_TEXT_DIR_LTR)
2647 *x += priv->arrow_button->allocation.width - req.width;
2649 *x += req.width - menu_req.width;
2651 if ((*y + priv->arrow_button->allocation.height + menu_req.height) <= monitor.y + monitor.height)
2652 *y += priv->arrow_button->allocation.height;
2653 else if ((*y - menu_req.height) >= monitor.y)
2654 *y -= menu_req.height;
2655 else if (monitor.y + monitor.height - (*y + priv->arrow_button->allocation.height) > *y)
2656 *y += priv->arrow_button->allocation.height;
2658 *y -= menu_req.height;
2662 if (gtk_widget_get_direction (GTK_WIDGET (toolbar)) == GTK_TEXT_DIR_LTR)
2663 *x += priv->arrow_button->allocation.width;
2665 *x -= menu_req.width;
2667 if (*y + menu_req.height > monitor.y + monitor.height &&
2668 *y + priv->arrow_button->allocation.height - monitor.y > monitor.y + monitor.height - *y)
2669 *y += priv->arrow_button->allocation.height - menu_req.height;
2676 show_menu (GtkToolbar *toolbar,
2677 GdkEventButton *event)
2679 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2681 rebuild_menu (toolbar);
2683 gtk_widget_show_all (GTK_WIDGET (priv->menu));
2685 gtk_menu_popup (priv->menu, NULL, NULL,
2686 menu_position_func, toolbar,
2687 event? event->button : 0,
2688 event? event->time : gtk_get_current_event_time());
2692 gtk_toolbar_arrow_button_clicked (GtkWidget *button,
2693 GtkToolbar *toolbar)
2695 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2697 if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (priv->arrow_button)) &&
2698 (!priv->menu || !GTK_WIDGET_VISIBLE (priv->menu)))
2700 /* We only get here when the button is clicked with the keyboard,
2701 * because mouse button presses result in the menu being shown so
2702 * that priv->menu would be non-NULL and visible.
2704 show_menu (toolbar, NULL);
2705 gtk_menu_shell_select_first (GTK_MENU_SHELL (priv->menu), FALSE);
2710 gtk_toolbar_arrow_button_press (GtkWidget *button,
2711 GdkEventButton *event,
2712 GtkToolbar *toolbar)
2714 show_menu (toolbar, event);
2715 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (button), TRUE);
2721 gtk_toolbar_button_press (GtkWidget *toolbar,
2722 GdkEventButton *event)
2724 if (event->button == 3)
2726 gboolean return_value;
2728 g_signal_emit (toolbar, toolbar_signals[POPUP_CONTEXT_MENU], 0,
2729 (int)event->x_root, (int)event->y_root, event->button,
2732 return return_value;
2739 gtk_toolbar_popup_menu (GtkWidget *toolbar)
2741 gboolean return_value;
2742 /* This function is the handler for the "popup menu" keybinding,
2743 * ie., it is called when the user presses Shift F10
2745 g_signal_emit (toolbar, toolbar_signals[POPUP_CONTEXT_MENU], 0,
2746 -1, -1, -1, &return_value);
2748 return return_value;
2754 * Creates a new toolbar.
2756 * Return Value: the newly-created toolbar.
2759 gtk_toolbar_new (void)
2761 GtkToolbar *toolbar;
2763 toolbar = g_object_new (GTK_TYPE_TOOLBAR, NULL);
2765 return GTK_WIDGET (toolbar);
2769 * gtk_toolbar_insert:
2770 * @toolbar: a #GtkToolbar
2771 * @item: a #GtkToolItem
2772 * @pos: the position of the new item
2774 * Insert a #GtkToolItem into the toolbar at position @pos. If @pos is
2775 * 0 the item is prepended to the start of the toolbar. If @pos is
2776 * negative, the item is appended to the end of the toolbar.
2781 gtk_toolbar_insert (GtkToolbar *toolbar,
2785 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2786 g_return_if_fail (GTK_IS_TOOL_ITEM (item));
2788 if (!gtk_toolbar_check_new_api (toolbar))
2792 pos = logical_to_physical (toolbar, pos);
2794 toolbar_content_new_tool_item (toolbar, item, FALSE, pos);
2798 * gtk_toolbar_get_item_index:
2799 * @toolbar: a #GtkToolbar
2800 * @item: a #GtkToolItem that is a child of @toolbar
2802 * Returns the position of @item on the toolbar, starting from 0.
2803 * It is an error if @item is not a child of the toolbar.
2805 * Return value: the position of item on the toolbar.
2810 gtk_toolbar_get_item_index (GtkToolbar *toolbar,
2813 GtkToolbarPrivate *priv;
2817 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), -1);
2818 g_return_val_if_fail (GTK_IS_TOOL_ITEM (item), -1);
2819 g_return_val_if_fail (GTK_WIDGET (item)->parent == GTK_WIDGET (toolbar), -1);
2821 if (!gtk_toolbar_check_new_api (toolbar))
2824 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2827 for (list = priv->content; list != NULL; list = list->next)
2829 ToolbarContent *content = list->data;
2832 widget = toolbar_content_get_widget (content);
2834 if (item == GTK_TOOL_ITEM (widget))
2840 return physical_to_logical (toolbar, n);
2844 * gtk_toolbar_set_orientation:
2845 * @toolbar: a #GtkToolbar.
2846 * @orientation: a new #GtkOrientation.
2848 * Sets whether a toolbar should appear horizontally or vertically.
2851 gtk_toolbar_set_orientation (GtkToolbar *toolbar,
2852 GtkOrientation orientation)
2854 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2856 g_signal_emit (toolbar, toolbar_signals[ORIENTATION_CHANGED], 0, orientation);
2860 * gtk_toolbar_get_orientation:
2861 * @toolbar: a #GtkToolbar
2863 * Retrieves the current orientation of the toolbar. See
2864 * gtk_toolbar_set_orientation().
2866 * Return value: the orientation
2869 gtk_toolbar_get_orientation (GtkToolbar *toolbar)
2871 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), GTK_ORIENTATION_HORIZONTAL);
2873 return toolbar->orientation;
2877 * gtk_toolbar_set_style:
2878 * @toolbar: a #GtkToolbar.
2879 * @style: the new style for @toolbar.
2881 * Alters the view of @toolbar to display either icons only, text only, or both.
2884 gtk_toolbar_set_style (GtkToolbar *toolbar,
2885 GtkToolbarStyle style)
2887 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2889 toolbar->style_set = TRUE;
2890 g_signal_emit (toolbar, toolbar_signals[STYLE_CHANGED], 0, style);
2894 * gtk_toolbar_get_style:
2895 * @toolbar: a #GtkToolbar
2897 * Retrieves whether the toolbar has text, icons, or both . See
2898 * gtk_toolbar_set_style().
2900 * Return value: the current style of @toolbar
2903 gtk_toolbar_get_style (GtkToolbar *toolbar)
2905 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), DEFAULT_TOOLBAR_STYLE);
2907 return toolbar->style;
2911 * gtk_toolbar_unset_style:
2912 * @toolbar: a #GtkToolbar
2914 * Unsets a toolbar style set with gtk_toolbar_set_style(), so that
2915 * user preferences will be used to determine the toolbar style.
2918 gtk_toolbar_unset_style (GtkToolbar *toolbar)
2920 GtkToolbarStyle style;
2922 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2924 if (toolbar->style_set)
2926 GtkSettings *settings = toolbar_get_settings (toolbar);
2929 g_object_get (settings,
2930 "gtk-toolbar-style", &style,
2933 style = DEFAULT_TOOLBAR_STYLE;
2935 if (style != toolbar->style)
2936 g_signal_emit (toolbar, toolbar_signals[STYLE_CHANGED], 0, style);
2938 toolbar->style_set = FALSE;
2943 * gtk_toolbar_set_tooltips:
2944 * @toolbar: a #GtkToolbar.
2945 * @enable: set to %FALSE to disable the tooltips, or %TRUE to enable them.
2947 * Sets if the tooltips of a toolbar should be active or not.
2950 gtk_toolbar_set_tooltips (GtkToolbar *toolbar,
2953 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2956 gtk_tooltips_enable (toolbar->tooltips);
2958 gtk_tooltips_disable (toolbar->tooltips);
2960 g_object_notify (G_OBJECT (toolbar), "tooltips");
2964 * gtk_toolbar_get_tooltips:
2965 * @toolbar: a #GtkToolbar
2967 * Retrieves whether tooltips are enabled. See
2968 * gtk_toolbar_set_tooltips().
2970 * Return value: %TRUE if tooltips are enabled
2973 gtk_toolbar_get_tooltips (GtkToolbar *toolbar)
2975 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), FALSE);
2981 * gtk_toolbar_get_n_items:
2982 * @toolbar: a #GtkToolbar
2984 * Returns the number of items on the toolbar.
2986 * Return value: the number of items on the toolbar
2991 gtk_toolbar_get_n_items (GtkToolbar *toolbar)
2993 GtkToolbarPrivate *priv;
2995 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), -1);
2997 if (!gtk_toolbar_check_new_api (toolbar))
3000 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
3002 return physical_to_logical (toolbar, g_list_length (priv->content));
3006 * gtk_toolbar_get_nth_item:
3007 * @toolbar: a #GtkToolbar
3008 * @n: A position on the toolbar
3010 * Returns the @n<!-- -->'th item on @toolbar, or %NULL if the
3011 * toolbar does not contain an @n<!-- -->'th item.
3013 * Return value: The @n<!-- -->'th #GtkToolItem on @toolbar, or %NULL if there
3014 * isn't an @n<!-- -->'th item.
3019 gtk_toolbar_get_nth_item (GtkToolbar *toolbar,
3022 GtkToolbarPrivate *priv;
3023 ToolbarContent *content;
3026 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), NULL);
3028 if (!gtk_toolbar_check_new_api (toolbar))
3031 n_items = gtk_toolbar_get_n_items (toolbar);
3033 if (n < 0 || n >= n_items)
3036 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
3038 content = g_list_nth_data (priv->content, logical_to_physical (toolbar, n));
3041 g_assert (!toolbar_content_is_placeholder (content));
3043 return GTK_TOOL_ITEM (toolbar_content_get_widget (content));
3047 * gtk_toolbar_get_icon_size:
3048 * @toolbar: a #GtkToolbar
3050 * Retrieves the icon size for the toolbar. See gtk_toolbar_set_icon_size().
3052 * Return value: the current icon size for the icons on the toolbar.
3055 gtk_toolbar_get_icon_size (GtkToolbar *toolbar)
3057 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), DEFAULT_ICON_SIZE);
3059 return toolbar->icon_size;
3063 * gtk_toolbar_get_relief_style:
3064 * @toolbar: a #GtkToolbar
3066 * Returns the relief style of buttons on @toolbar. See
3067 * gtk_button_set_relief().
3069 * Return value: The relief style of buttons on @toolbar.
3074 gtk_toolbar_get_relief_style (GtkToolbar *toolbar)
3076 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), GTK_RELIEF_NONE);
3078 return get_button_relief (toolbar);
3082 * gtk_toolbar_set_show_arrow:
3083 * @toolbar: a #GtkToolbar
3084 * @show_arrow: Whether to show an overflow menu
3086 * Sets whether to show an overflow menu when
3087 * @toolbar doesn't have room for all items on it. If %TRUE,
3088 * items that there are not room are available through an
3094 gtk_toolbar_set_show_arrow (GtkToolbar *toolbar,
3095 gboolean show_arrow)
3097 GtkToolbarPrivate *priv;
3099 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
3101 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
3102 show_arrow = show_arrow != FALSE;
3104 if (priv->show_arrow != show_arrow)
3106 priv->show_arrow = show_arrow;
3108 if (!priv->show_arrow)
3109 gtk_widget_hide (priv->arrow_button);
3111 gtk_widget_queue_resize (GTK_WIDGET (toolbar));
3112 g_object_notify (G_OBJECT (toolbar), "show-arrow");
3117 * gtk_toolbar_get_show_arrow:
3118 * @toolbar: a #GtkToolbar
3120 * Returns whether the toolbar has an overflow menu.
3121 * See gtk_toolbar_set_show_arrow().
3123 * Return value: %TRUE if the toolbar has an overflow menu.
3128 gtk_toolbar_get_show_arrow (GtkToolbar *toolbar)
3130 GtkToolbarPrivate *priv;
3132 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), FALSE);
3134 if (!gtk_toolbar_check_new_api (toolbar))
3137 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
3139 return priv->show_arrow;
3143 * gtk_toolbar_get_drop_index:
3144 * @toolbar: a #GtkToolbar
3145 * @x: x coordinate of a point on the toolbar
3146 * @y: y coordinate of a point on the toolbar
3148 * Returns the position corresponding to the indicated point on
3149 * @toolbar. This is useful when dragging items to the toolbar:
3150 * this function returns the position a new item should be
3153 * @x and @y are in @toolbar coordinates.
3155 * Return value: The position corresponding to the point (@x, @y) on the toolbar.
3160 gtk_toolbar_get_drop_index (GtkToolbar *toolbar,
3164 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), -1);
3166 if (!gtk_toolbar_check_new_api (toolbar))
3169 return physical_to_logical (toolbar, find_drop_index (toolbar, x, y));
3173 gtk_toolbar_finalize (GObject *object)
3176 GtkToolbar *toolbar = GTK_TOOLBAR (object);
3177 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
3179 if (toolbar->tooltips)
3180 g_object_unref (toolbar->tooltips);
3182 if (priv->arrow_button)
3183 gtk_widget_unparent (priv->arrow_button);
3185 for (list = priv->content; list != NULL; list = list->next)
3187 ToolbarContent *content = list->data;
3189 toolbar_content_free (content);
3192 g_list_free (priv->content);
3193 g_list_free (toolbar->children);
3195 g_timer_destroy (priv->timer);
3198 gtk_widget_destroy (GTK_WIDGET (priv->menu));
3201 g_source_remove (priv->idle_id);
3203 G_OBJECT_CLASS (gtk_toolbar_parent_class)->finalize (object);
3207 * gtk_toolbar_set_icon_size:
3208 * @toolbar: A #GtkToolbar
3209 * @icon_size: The #GtkIconSize that stock icons in the toolbar shall have.
3211 * This function sets the size of stock icons in the toolbar. You
3212 * can call it both before you add the icons and after they've been
3213 * added. The size you set will override user preferences for the default
3216 * This should only be used for special-purpose toolbars, normal
3217 * application toolbars should respect the user preferences for the
3221 gtk_toolbar_set_icon_size (GtkToolbar *toolbar,
3222 GtkIconSize icon_size)
3224 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
3225 g_return_if_fail (icon_size != GTK_ICON_SIZE_INVALID);
3227 if (!toolbar->icon_size_set)
3229 toolbar->icon_size_set = TRUE;
3230 g_object_notify (G_OBJECT (toolbar), "icon-size-set");
3233 if (toolbar->icon_size == icon_size)
3236 toolbar->icon_size = icon_size;
3237 g_object_notify (G_OBJECT (toolbar), "icon-size");
3239 gtk_toolbar_reconfigured (toolbar);
3241 gtk_widget_queue_resize (GTK_WIDGET (toolbar));
3245 * gtk_toolbar_unset_icon_size:
3246 * @toolbar: a #GtkToolbar
3248 * Unsets toolbar icon size set with gtk_toolbar_set_icon_size(), so that
3249 * user preferences will be used to determine the icon size.
3252 gtk_toolbar_unset_icon_size (GtkToolbar *toolbar)
3256 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
3258 if (toolbar->icon_size_set)
3260 GtkSettings *settings = toolbar_get_settings (toolbar);
3264 g_object_get (settings,
3265 "gtk-toolbar-icon-size", &size,
3269 size = DEFAULT_ICON_SIZE;
3271 if (size != toolbar->icon_size)
3273 gtk_toolbar_set_icon_size (toolbar, size);
3274 g_object_notify (G_OBJECT (toolbar), "icon-size");
3277 toolbar->icon_size_set = FALSE;
3278 g_object_notify (G_OBJECT (toolbar), "icon-size-set");
3287 * gtk_toolbar_append_item:
3288 * @toolbar: a #GtkToolbar.
3289 * @text: give your toolbar button a label.
3290 * @tooltip_text: a string that appears when the user holds the mouse over this item.
3291 * @tooltip_private_text: use with #GtkTipsQuery.
3292 * @icon: a #GtkWidget that should be used as the button's icon.
3293 * @callback: the function to be executed when the button is pressed.
3294 * @user_data: a pointer to any data you wish to be passed to the callback.
3296 * Inserts a new item into the toolbar. You must specify the position
3297 * in the toolbar where it will be inserted.
3299 * @callback must be a pointer to a function taking a #GtkWidget and a gpointer as
3300 * arguments. Use the GTK_SIGNAL_FUNC() to cast the function to #GtkSignalFunc.
3302 * Return value: the new toolbar item as a #GtkWidget.
3305 gtk_toolbar_append_item (GtkToolbar *toolbar,
3307 const char *tooltip_text,
3308 const char *tooltip_private_text,
3310 GtkSignalFunc callback,
3313 return gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_BUTTON,
3315 tooltip_text, tooltip_private_text,
3316 icon, callback, user_data,
3317 toolbar->num_children);
3321 * gtk_toolbar_prepend_item:
3322 * @toolbar: a #GtkToolbar.
3323 * @text: give your toolbar button a label.
3324 * @tooltip_text: a string that appears when the user holds the mouse over this item.
3325 * @tooltip_private_text: use with #GtkTipsQuery.
3326 * @icon: a #GtkWidget that should be used as the button's icon.
3327 * @callback: the function to be executed when the button is pressed.
3328 * @user_data: a pointer to any data you wish to be passed to the callback.
3330 * Adds a new button to the beginning (top or left edges) of the given toolbar.
3332 * @callback must be a pointer to a function taking a #GtkWidget and a gpointer as
3333 * arguments. Use the GTK_SIGNAL_FUNC() to cast the function to #GtkSignalFunc.
3335 * Return value: the new toolbar item as a #GtkWidget.
3338 gtk_toolbar_prepend_item (GtkToolbar *toolbar,
3340 const char *tooltip_text,
3341 const char *tooltip_private_text,
3343 GtkSignalFunc callback,
3346 return gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_BUTTON,
3348 tooltip_text, tooltip_private_text,
3349 icon, callback, user_data,
3354 * gtk_toolbar_insert_item:
3355 * @toolbar: a #GtkToolbar.
3356 * @text: give your toolbar button a label.
3357 * @tooltip_text: a string that appears when the user holds the mouse over this item.
3358 * @tooltip_private_text: use with #GtkTipsQuery.
3359 * @icon: a #GtkWidget that should be used as the button's icon.
3360 * @callback: the function to be executed when the button is pressed.
3361 * @user_data: a pointer to any data you wish to be passed to the callback.
3362 * @position: the number of widgets to insert this item after.
3364 * Inserts a new item into the toolbar. You must specify the position in the
3365 * toolbar where it will be inserted.
3367 * @callback must be a pointer to a function taking a #GtkWidget and a gpointer as
3368 * arguments. Use the GTK_SIGNAL_FUNC() to cast the function to #GtkSignalFunc.
3370 * Return value: the new toolbar item as a #GtkWidget.
3373 gtk_toolbar_insert_item (GtkToolbar *toolbar,
3375 const char *tooltip_text,
3376 const char *tooltip_private_text,
3378 GtkSignalFunc callback,
3382 return gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_BUTTON,
3384 tooltip_text, tooltip_private_text,
3385 icon, callback, user_data,
3390 * gtk_toolbar_insert_stock:
3391 * @toolbar: A #GtkToolbar
3392 * @stock_id: The id of the stock item you want to insert
3393 * @tooltip_text: The text in the tooltip of the toolbar button
3394 * @tooltip_private_text: The private text of the tooltip
3395 * @callback: The callback called when the toolbar button is clicked.
3396 * @user_data: user data passed to callback
3397 * @position: The position the button shall be inserted at.
3398 * -1 means at the end.
3400 * Inserts a stock item at the specified position of the toolbar. If
3401 * @stock_id is not a known stock item ID, it's inserted verbatim,
3402 * except that underscores used to mark mnemonics are removed.
3404 * @callback must be a pointer to a function taking a #GtkWidget and a gpointer as
3405 * arguments. Use the GTK_SIGNAL_FUNC() to cast the function to #GtkSignalFunc.
3407 * Returns: the inserted widget
3410 gtk_toolbar_insert_stock (GtkToolbar *toolbar,
3411 const gchar *stock_id,
3412 const char *tooltip_text,
3413 const char *tooltip_private_text,
3414 GtkSignalFunc callback,
3418 return internal_insert_element (toolbar, GTK_TOOLBAR_CHILD_BUTTON,
3420 tooltip_text, tooltip_private_text,
3421 NULL, callback, user_data,
3426 * gtk_toolbar_append_space:
3427 * @toolbar: a #GtkToolbar.
3429 * Adds a new space to the end of the toolbar.
3432 gtk_toolbar_append_space (GtkToolbar *toolbar)
3434 gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_SPACE,
3438 toolbar->num_children);
3442 * gtk_toolbar_prepend_space:
3443 * @toolbar: a #GtkToolbar.
3445 * Adds a new space to the beginning of the toolbar.
3448 gtk_toolbar_prepend_space (GtkToolbar *toolbar)
3450 gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_SPACE,
3458 * gtk_toolbar_insert_space:
3459 * @toolbar: a #GtkToolbar
3460 * @position: the number of widgets after which a space should be inserted.
3462 * Inserts a new space in the toolbar at the specified position.
3465 gtk_toolbar_insert_space (GtkToolbar *toolbar,
3468 gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_SPACE,
3476 * gtk_toolbar_remove_space:
3477 * @toolbar: a #GtkToolbar.
3478 * @position: the index of the space to remove.
3480 * Removes a space from the specified position.
3483 gtk_toolbar_remove_space (GtkToolbar *toolbar,
3486 GtkToolbarPrivate *priv;
3487 ToolbarContent *content;
3489 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
3491 if (!gtk_toolbar_check_old_api (toolbar))
3494 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
3496 content = g_list_nth_data (priv->content, position);
3500 g_warning ("Toolbar position %d doesn't exist", position);
3504 if (!toolbar_content_is_separator (content))
3506 g_warning ("Toolbar position %d is not a space", position);
3510 toolbar_content_remove (content, toolbar);
3511 toolbar_content_free (content);
3515 * gtk_toolbar_append_widget:
3516 * @toolbar: a #GtkToolbar.
3517 * @widget: a #GtkWidget to add to the toolbar.
3518 * @tooltip_text: the element's tooltip.
3519 * @tooltip_private_text: used for context-sensitive help about this toolbar element.
3521 * Adds a widget to the end of the given toolbar.
3524 gtk_toolbar_append_widget (GtkToolbar *toolbar,
3526 const gchar *tooltip_text,
3527 const gchar *tooltip_private_text)
3529 gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_WIDGET,
3531 tooltip_text, tooltip_private_text,
3533 toolbar->num_children);
3537 * gtk_toolbar_prepend_widget:
3538 * @toolbar: a #GtkToolbar.
3539 * @widget: a #GtkWidget to add to the toolbar.
3540 * @tooltip_text: the element's tooltip.
3541 * @tooltip_private_text: used for context-sensitive help about this toolbar element.
3543 * Adds a widget to the beginning of the given toolbar.
3546 gtk_toolbar_prepend_widget (GtkToolbar *toolbar,
3548 const gchar *tooltip_text,
3549 const gchar *tooltip_private_text)
3551 gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_WIDGET,
3553 tooltip_text, tooltip_private_text,
3559 * gtk_toolbar_insert_widget:
3560 * @toolbar: a #GtkToolbar.
3561 * @widget: a #GtkWidget to add to the toolbar.
3562 * @tooltip_text: the element's tooltip.
3563 * @tooltip_private_text: used for context-sensitive help about this toolbar element.
3564 * @position: the number of widgets to insert this widget after.
3566 * Inserts a widget in the toolbar at the given position.
3569 gtk_toolbar_insert_widget (GtkToolbar *toolbar,
3571 const char *tooltip_text,
3572 const char *tooltip_private_text,
3575 gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_WIDGET,
3577 tooltip_text, tooltip_private_text,
3583 * gtk_toolbar_append_element:
3584 * @toolbar: a #GtkToolbar.
3585 * @type: a value of type #GtkToolbarChildType that determines what @widget will be.
3586 * @widget: a #GtkWidget, or %NULL.
3587 * @text: the element's label.
3588 * @tooltip_text: the element's tooltip.
3589 * @tooltip_private_text: used for context-sensitive help about this toolbar element.
3590 * @icon: a #GtkWidget that provides pictorial representation of the element's function.
3591 * @callback: the function to be executed when the button is pressed.
3592 * @user_data: any data you wish to pass to the callback.
3594 * Adds a new element to the end of a toolbar.
3596 * If @type == %GTK_TOOLBAR_CHILD_WIDGET, @widget is used as the new element.
3597 * If @type == %GTK_TOOLBAR_CHILD_RADIOBUTTON, @widget is used to determine
3598 * the radio group for the new element. In all other cases, @widget must
3601 * @callback must be a pointer to a function taking a #GtkWidget and a gpointer as
3602 * arguments. Use the GTK_SIGNAL_FUNC() to cast the function to #GtkSignalFunc.
3604 * Return value: the new toolbar element as a #GtkWidget.
3607 gtk_toolbar_append_element (GtkToolbar *toolbar,
3608 GtkToolbarChildType type,
3611 const char *tooltip_text,
3612 const char *tooltip_private_text,
3614 GtkSignalFunc callback,
3617 return gtk_toolbar_insert_element (toolbar, type, widget, text,
3618 tooltip_text, tooltip_private_text,
3619 icon, callback, user_data,
3620 toolbar->num_children);
3624 * gtk_toolbar_prepend_element:
3625 * @toolbar: a #GtkToolbar.
3626 * @type: a value of type #GtkToolbarChildType that determines what @widget will be.
3627 * @widget: a #GtkWidget, or %NULL
3628 * @text: the element's label.
3629 * @tooltip_text: the element's tooltip.
3630 * @tooltip_private_text: used for context-sensitive help about this toolbar element.
3631 * @icon: a #GtkWidget that provides pictorial representation of the element's function.
3632 * @callback: the function to be executed when the button is pressed.
3633 * @user_data: any data you wish to pass to the callback.
3635 * Adds a new element to the beginning of a toolbar.
3637 * If @type == %GTK_TOOLBAR_CHILD_WIDGET, @widget is used as the new element.
3638 * If @type == %GTK_TOOLBAR_CHILD_RADIOBUTTON, @widget is used to determine
3639 * the radio group for the new element. In all other cases, @widget must
3642 * @callback must be a pointer to a function taking a #GtkWidget and a gpointer as
3643 * arguments. Use the GTK_SIGNAL_FUNC() to cast the function to #GtkSignalFunc.
3645 * Return value: the new toolbar element as a #GtkWidget.
3648 gtk_toolbar_prepend_element (GtkToolbar *toolbar,
3649 GtkToolbarChildType type,
3652 const char *tooltip_text,
3653 const char *tooltip_private_text,
3655 GtkSignalFunc callback,
3658 return gtk_toolbar_insert_element (toolbar, type, widget, text,
3659 tooltip_text, tooltip_private_text,
3660 icon, callback, user_data, 0);
3664 * gtk_toolbar_insert_element:
3665 * @toolbar: a #GtkToolbar.
3666 * @type: a value of type #GtkToolbarChildType that determines what @widget
3668 * @widget: a #GtkWidget, or %NULL.
3669 * @text: the element's label.
3670 * @tooltip_text: the element's tooltip.
3671 * @tooltip_private_text: used for context-sensitive help about this toolbar element.
3672 * @icon: a #GtkWidget that provides pictorial representation of the element's function.
3673 * @callback: the function to be executed when the button is pressed.
3674 * @user_data: any data you wish to pass to the callback.
3675 * @position: the number of widgets to insert this element after.
3677 * Inserts a new element in the toolbar at the given position.
3679 * If @type == %GTK_TOOLBAR_CHILD_WIDGET, @widget is used as the new element.
3680 * If @type == %GTK_TOOLBAR_CHILD_RADIOBUTTON, @widget is used to determine
3681 * the radio group for the new element. In all other cases, @widget must
3684 * @callback must be a pointer to a function taking a #GtkWidget and a gpointer as
3685 * arguments. Use the GTK_SIGNAL_FUNC() to cast the function to #GtkSignalFunc.
3687 * Return value: the new toolbar element as a #GtkWidget.
3690 gtk_toolbar_insert_element (GtkToolbar *toolbar,
3691 GtkToolbarChildType type,
3694 const char *tooltip_text,
3695 const char *tooltip_private_text,
3697 GtkSignalFunc callback,
3701 return internal_insert_element (toolbar, type, widget, text,
3702 tooltip_text, tooltip_private_text,
3703 icon, callback, user_data, position, FALSE);
3707 set_child_packing_and_visibility(GtkToolbar *toolbar,
3708 GtkToolbarChild *child)
3713 box = gtk_bin_get_child (GTK_BIN (child->widget));
3715 g_return_if_fail (GTK_IS_BOX (box));
3719 expand = (toolbar->style != GTK_TOOLBAR_BOTH);
3721 gtk_box_set_child_packing (GTK_BOX (box), child->label,
3722 expand, expand, 0, GTK_PACK_END);
3724 if (toolbar->style != GTK_TOOLBAR_ICONS)
3725 gtk_widget_show (child->label);
3727 gtk_widget_hide (child->label);
3732 expand = (toolbar->style != GTK_TOOLBAR_BOTH_HORIZ);
3734 gtk_box_set_child_packing (GTK_BOX (box), child->icon,
3735 expand, expand, 0, GTK_PACK_END);
3737 if (toolbar->style != GTK_TOOLBAR_TEXT)
3738 gtk_widget_show (child->icon);
3740 gtk_widget_hide (child->icon);
3745 internal_insert_element (GtkToolbar *toolbar,
3746 GtkToolbarChildType type,
3749 const char *tooltip_text,
3750 const char *tooltip_private_text,
3752 GtkSignalFunc callback,
3758 ToolbarContent *content;
3759 char *free_me = NULL;
3761 GtkWidget *child_widget;
3762 GtkWidget *child_label;
3763 GtkWidget *child_icon;
3765 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), NULL);
3766 if (type == GTK_TOOLBAR_CHILD_WIDGET)
3767 g_return_val_if_fail (GTK_IS_WIDGET (widget), NULL);
3768 else if (type != GTK_TOOLBAR_CHILD_RADIOBUTTON)
3769 g_return_val_if_fail (widget == NULL, NULL);
3770 if (GTK_IS_TOOL_ITEM (widget))
3771 g_warning (MIXED_API_WARNING);
3773 if (!gtk_toolbar_check_old_api (toolbar))
3776 child_widget = NULL;
3782 case GTK_TOOLBAR_CHILD_SPACE:
3785 case GTK_TOOLBAR_CHILD_WIDGET:
3786 child_widget = widget;
3789 case GTK_TOOLBAR_CHILD_BUTTON:
3790 case GTK_TOOLBAR_CHILD_TOGGLEBUTTON:
3791 case GTK_TOOLBAR_CHILD_RADIOBUTTON:
3792 if (type == GTK_TOOLBAR_CHILD_BUTTON)
3794 child_widget = gtk_button_new ();
3796 else if (type == GTK_TOOLBAR_CHILD_TOGGLEBUTTON)
3798 child_widget = gtk_toggle_button_new ();
3799 gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (child_widget), FALSE);
3801 else /* type == GTK_TOOLBAR_CHILD_RADIOBUTTON */
3803 GSList *group = NULL;
3806 group = gtk_radio_button_get_group (GTK_RADIO_BUTTON (widget));
3808 child_widget = gtk_radio_button_new (group);
3809 gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (child_widget), FALSE);
3812 gtk_button_set_relief (GTK_BUTTON (child_widget), get_button_relief (toolbar));
3813 gtk_button_set_focus_on_click (GTK_BUTTON (child_widget), FALSE);
3817 g_signal_connect (child_widget, "clicked",
3818 callback, user_data);
3821 if (toolbar->style == GTK_TOOLBAR_BOTH_HORIZ)
3822 box = gtk_hbox_new (FALSE, 0);
3824 box = gtk_vbox_new (FALSE, 0);
3826 gtk_container_add (GTK_CONTAINER (child_widget), box);
3827 gtk_widget_show (box);
3829 if (text && use_stock)
3831 GtkStockItem stock_item;
3832 if (gtk_stock_lookup (text, &stock_item))
3835 icon = gtk_image_new_from_stock (text, toolbar->icon_size);
3837 text = free_me = _gtk_toolbar_elide_underscores (stock_item.label);
3843 child_label = gtk_label_new (text);
3845 gtk_container_add (GTK_CONTAINER (box), child_label);
3850 child_icon = GTK_WIDGET (icon);
3851 gtk_container_add (GTK_CONTAINER (box), child_icon);
3854 gtk_widget_show (child_widget);
3858 g_assert_not_reached ();
3862 if ((type != GTK_TOOLBAR_CHILD_SPACE) && tooltip_text)
3864 gtk_tooltips_set_tip (toolbar->tooltips, child_widget,
3865 tooltip_text, tooltip_private_text);
3868 content = toolbar_content_new_compatibility (toolbar, type, child_widget,
3869 child_icon, child_label, position);
3873 return child_widget;
3877 * ToolbarContent methods
3885 struct _ToolbarContent
3895 GtkAllocation start_allocation;
3896 GtkAllocation goal_allocation;
3897 guint is_placeholder : 1;
3898 guint disappearing : 1;
3904 GtkToolbarChild child;
3905 GtkAllocation space_allocation;
3906 guint space_visible : 1;
3911 static ToolbarContent *
3912 toolbar_content_new_tool_item (GtkToolbar *toolbar,
3914 gboolean is_placeholder,
3917 ToolbarContent *content;
3918 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
3920 content = g_slice_new0 (ToolbarContent);
3922 content->type = TOOL_ITEM;
3923 content->state = NOT_ALLOCATED;
3924 content->u.tool_item.item = item;
3925 content->u.tool_item.is_placeholder = is_placeholder;
3927 gtk_widget_set_parent (GTK_WIDGET (item), GTK_WIDGET (toolbar));
3929 priv->content = g_list_insert (priv->content, content, pos);
3931 if (!is_placeholder)
3933 toolbar->num_children++;
3935 gtk_toolbar_stop_sliding (toolbar);
3938 gtk_widget_queue_resize (GTK_WIDGET (toolbar));
3939 priv->need_rebuild = TRUE;
3944 static ToolbarContent *
3945 toolbar_content_new_compatibility (GtkToolbar *toolbar,
3946 GtkToolbarChildType type,
3952 ToolbarContent *content;
3953 GtkToolbarChild *child;
3954 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
3956 content = g_slice_new0 (ToolbarContent);
3958 child = &(content->u.compatibility.child);
3960 content->type = COMPATIBILITY;
3962 child->widget = widget;
3964 child->label = label;
3966 if (type != GTK_TOOLBAR_CHILD_SPACE)
3968 gtk_widget_set_parent (child->widget, GTK_WIDGET (toolbar));
3972 content->u.compatibility.space_visible = TRUE;
3973 gtk_widget_queue_resize (GTK_WIDGET (toolbar));
3976 if (type == GTK_TOOLBAR_CHILD_BUTTON ||
3977 type == GTK_TOOLBAR_CHILD_TOGGLEBUTTON ||
3978 type == GTK_TOOLBAR_CHILD_RADIOBUTTON)
3980 set_child_packing_and_visibility (toolbar, child);
3983 priv->content = g_list_insert (priv->content, content, pos);
3984 toolbar->children = g_list_insert (toolbar->children, child, pos);
3985 priv->need_rebuild = TRUE;
3987 toolbar->num_children++;
3993 toolbar_content_remove (ToolbarContent *content,
3994 GtkToolbar *toolbar)
3996 GtkToolbarChild *child;
3997 GtkToolbarPrivate *priv;
3999 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
4001 switch (content->type)
4004 gtk_widget_unparent (GTK_WIDGET (content->u.tool_item.item));
4008 child = &(content->u.compatibility.child);
4010 if (child->type != GTK_TOOLBAR_CHILD_SPACE)
4012 g_object_ref (child->widget);
4013 gtk_widget_unparent (child->widget);
4014 gtk_widget_destroy (child->widget);
4015 g_object_unref (child->widget);
4018 toolbar->children = g_list_remove (toolbar->children, child);
4022 priv->content = g_list_remove (priv->content, content);
4024 if (!toolbar_content_is_placeholder (content))
4025 toolbar->num_children--;
4027 gtk_widget_queue_resize (GTK_WIDGET (toolbar));
4028 priv->need_rebuild = TRUE;
4032 toolbar_content_free (ToolbarContent *content)
4034 g_slice_free (ToolbarContent, content);
4038 calculate_max_homogeneous_pixels (GtkWidget *widget)
4040 PangoContext *context;
4041 PangoFontMetrics *metrics;
4044 context = gtk_widget_get_pango_context (widget);
4045 metrics = pango_context_get_metrics (context,
4046 widget->style->font_desc,
4047 pango_context_get_language (context));
4048 char_width = pango_font_metrics_get_approximate_char_width (metrics);
4049 pango_font_metrics_unref (metrics);
4051 return PANGO_PIXELS (MAX_HOMOGENEOUS_N_CHARS * char_width);
4055 toolbar_content_expose (ToolbarContent *content,
4056 GtkContainer *container,
4057 GdkEventExpose *expose)
4059 GtkToolbar *toolbar = GTK_TOOLBAR (container);
4060 GtkToolbarChild *child;
4061 GtkWidget *widget = NULL; /* quiet gcc */
4063 switch (content->type)
4066 if (!content->u.tool_item.is_placeholder)
4067 widget = GTK_WIDGET (content->u.tool_item.item);
4071 child = &(content->u.compatibility.child);
4073 if (child->type == GTK_TOOLBAR_CHILD_SPACE)
4075 if (content->u.compatibility.space_visible &&
4076 get_space_style (toolbar) == GTK_TOOLBAR_SPACE_LINE)
4077 _gtk_toolbar_paint_space_line (GTK_WIDGET (toolbar), toolbar,
4079 &content->u.compatibility.space_allocation);
4083 widget = child->widget;
4088 gtk_container_propagate_expose (container, widget, expose);
4092 toolbar_content_visible (ToolbarContent *content,
4093 GtkToolbar *toolbar)
4097 switch (content->type)
4100 item = content->u.tool_item.item;
4102 if (!GTK_WIDGET_VISIBLE (item))
4105 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL &&
4106 gtk_tool_item_get_visible_horizontal (item))
4109 if ((toolbar->orientation == GTK_ORIENTATION_VERTICAL &&
4110 gtk_tool_item_get_visible_vertical (item)))
4117 if (content->u.compatibility.child.type != GTK_TOOLBAR_CHILD_SPACE)
4118 return GTK_WIDGET_VISIBLE (content->u.compatibility.child.widget);
4124 g_assert_not_reached ();
4129 toolbar_content_size_request (ToolbarContent *content,
4130 GtkToolbar *toolbar,
4131 GtkRequisition *requisition)
4135 switch (content->type)
4138 gtk_widget_size_request (GTK_WIDGET (content->u.tool_item.item),
4140 if (content->u.tool_item.is_placeholder &&
4141 content->u.tool_item.disappearing)
4143 requisition->width = 0;
4144 requisition->height = 0;
4149 space_size = get_space_size (toolbar);
4151 if (content->u.compatibility.child.type != GTK_TOOLBAR_CHILD_SPACE)
4153 gtk_widget_size_request (content->u.compatibility.child.widget,
4158 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
4160 requisition->width = space_size;
4161 requisition->height = 0;
4165 requisition->height = space_size;
4166 requisition->width = 0;
4175 toolbar_content_is_homogeneous (ToolbarContent *content,
4176 GtkToolbar *toolbar)
4178 gboolean result = FALSE; /* quiet gcc */
4179 GtkRequisition requisition;
4180 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
4182 if (priv->max_homogeneous_pixels < 0)
4184 priv->max_homogeneous_pixels =
4185 calculate_max_homogeneous_pixels (GTK_WIDGET (toolbar));
4188 toolbar_content_size_request (content, toolbar, &requisition);
4190 if (requisition.width > priv->max_homogeneous_pixels)
4193 switch (content->type)
4196 result = gtk_tool_item_get_homogeneous (content->u.tool_item.item) &&
4197 !GTK_IS_SEPARATOR_TOOL_ITEM (content->u.tool_item.item);
4199 if (gtk_tool_item_get_is_important (content->u.tool_item.item) &&
4200 toolbar->style == GTK_TOOLBAR_BOTH_HORIZ &&
4201 toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
4208 if (content->u.compatibility.child.type == GTK_TOOLBAR_CHILD_BUTTON ||
4209 content->u.compatibility.child.type == GTK_TOOLBAR_CHILD_RADIOBUTTON ||
4210 content->u.compatibility.child.type == GTK_TOOLBAR_CHILD_TOGGLEBUTTON)
4225 toolbar_content_is_placeholder (ToolbarContent *content)
4227 if (content->type == TOOL_ITEM && content->u.tool_item.is_placeholder)
4234 toolbar_content_disappearing (ToolbarContent *content)
4236 if (content->type == TOOL_ITEM && content->u.tool_item.disappearing)
4243 toolbar_content_get_state (ToolbarContent *content)
4245 return content->state;
4249 toolbar_content_child_visible (ToolbarContent *content)
4251 switch (content->type)
4254 return GTK_WIDGET_CHILD_VISIBLE (content->u.tool_item.item);
4258 if (content->u.compatibility.child.type != GTK_TOOLBAR_CHILD_SPACE)
4260 return GTK_WIDGET_CHILD_VISIBLE (content->u.compatibility.child.widget);
4264 return content->u.compatibility.space_visible;
4269 return FALSE; /* quiet gcc */
4273 toolbar_content_get_goal_allocation (ToolbarContent *content,
4274 GtkAllocation *allocation)
4276 switch (content->type)
4279 *allocation = content->u.tool_item.goal_allocation;
4283 /* Goal allocations are only relevant when we are
4284 * using the new API, so we should never get here
4286 g_assert_not_reached ();
4292 toolbar_content_get_allocation (ToolbarContent *content,
4293 GtkAllocation *allocation)
4295 GtkToolbarChild *child;
4297 switch (content->type)
4300 *allocation = GTK_WIDGET (content->u.tool_item.item)->allocation;
4304 child = &(content->u.compatibility.child);
4306 if (child->type == GTK_TOOLBAR_CHILD_SPACE)
4307 *allocation = content->u.compatibility.space_allocation;
4309 *allocation = child->widget->allocation;
4315 toolbar_content_set_start_allocation (ToolbarContent *content,
4316 GtkAllocation *allocation)
4318 switch (content->type)
4321 content->u.tool_item.start_allocation = *allocation;
4325 /* start_allocation is only relevant when using the new API */
4326 g_assert_not_reached ();
4332 toolbar_content_get_expand (ToolbarContent *content)
4334 if (content->type == TOOL_ITEM &&
4335 gtk_tool_item_get_expand (content->u.tool_item.item) &&
4336 !content->u.tool_item.disappearing)
4345 toolbar_content_set_goal_allocation (ToolbarContent *content,
4346 GtkAllocation *allocation)
4348 switch (content->type)
4351 content->u.tool_item.goal_allocation = *allocation;
4355 /* Only relevant when using new API */
4356 g_assert_not_reached ();
4362 toolbar_content_set_child_visible (ToolbarContent *content,
4363 GtkToolbar *toolbar,
4366 GtkToolbarChild *child;
4368 switch (content->type)
4371 gtk_widget_set_child_visible (GTK_WIDGET (content->u.tool_item.item),
4376 child = &(content->u.compatibility.child);
4378 if (child->type != GTK_TOOLBAR_CHILD_SPACE)
4380 gtk_widget_set_child_visible (child->widget, visible);
4384 if (content->u.compatibility.space_visible != visible)
4386 content->u.compatibility.space_visible = visible;
4387 gtk_widget_queue_draw (GTK_WIDGET (toolbar));
4395 toolbar_content_get_start_allocation (ToolbarContent *content,
4396 GtkAllocation *start_allocation)
4398 switch (content->type)
4401 *start_allocation = content->u.tool_item.start_allocation;
4405 /* Only relevant for new API */
4406 g_assert_not_reached ();
4412 toolbar_content_size_allocate (ToolbarContent *content,
4413 GtkAllocation *allocation)
4415 switch (content->type)
4418 gtk_widget_size_allocate (GTK_WIDGET (content->u.tool_item.item),
4423 if (content->u.compatibility.child.type != GTK_TOOLBAR_CHILD_SPACE)
4425 gtk_widget_size_allocate (content->u.compatibility.child.widget,
4430 content->u.compatibility.space_allocation = *allocation;
4437 toolbar_content_set_state (ToolbarContent *content,
4440 content->state = state;
4444 toolbar_content_get_widget (ToolbarContent *content)
4446 GtkToolbarChild *child;
4448 switch (content->type)
4451 return GTK_WIDGET (content->u.tool_item.item);
4455 child = &(content->u.compatibility.child);
4456 if (child->type != GTK_TOOLBAR_CHILD_SPACE)
4457 return child->widget;
4467 toolbar_content_set_disappearing (ToolbarContent *content,
4468 gboolean disappearing)
4470 switch (content->type)
4473 content->u.tool_item.disappearing = disappearing;
4477 /* Only relevant for new API */
4478 g_assert_not_reached ();
4484 toolbar_content_set_size_request (ToolbarContent *content,
4488 switch (content->type)
4491 gtk_widget_set_size_request (GTK_WIDGET (content->u.tool_item.item),
4496 /* Setting size requests only happens with sliding,
4497 * so not relevant here
4499 g_assert_not_reached ();
4505 toolbar_child_reconfigure (GtkToolbar *toolbar,
4506 GtkToolbarChild *child)
4510 GtkToolbarStyle style;
4511 GtkIconSize icon_size;
4512 GtkReliefStyle relief;
4515 style = gtk_toolbar_get_style (toolbar);
4516 icon_size = gtk_toolbar_get_icon_size (toolbar);
4517 relief = gtk_toolbar_get_relief_style (toolbar);
4520 if (child->type == GTK_TOOLBAR_CHILD_BUTTON ||
4521 child->type == GTK_TOOLBAR_CHILD_RADIOBUTTON ||
4522 child->type == GTK_TOOLBAR_CHILD_TOGGLEBUTTON)
4524 box = gtk_bin_get_child (GTK_BIN (child->widget));
4526 if (style == GTK_TOOLBAR_BOTH && GTK_IS_HBOX (box))
4530 vbox = gtk_vbox_new (FALSE, 0);
4533 gtk_widget_reparent (child->label, vbox);
4535 gtk_widget_reparent (child->icon, vbox);
4537 gtk_widget_destroy (box);
4538 gtk_container_add (GTK_CONTAINER (child->widget), vbox);
4540 gtk_widget_show (vbox);
4542 else if (style == GTK_TOOLBAR_BOTH_HORIZ && GTK_IS_VBOX (box))
4546 hbox = gtk_hbox_new (FALSE, 0);
4549 gtk_widget_reparent (child->label, hbox);
4551 gtk_widget_reparent (child->icon, hbox);
4553 gtk_widget_destroy (box);
4554 gtk_container_add (GTK_CONTAINER (child->widget), hbox);
4556 gtk_widget_show (hbox);
4559 set_child_packing_and_visibility (toolbar, child);
4564 if ((child->type == GTK_TOOLBAR_CHILD_BUTTON ||
4565 child->type == GTK_TOOLBAR_CHILD_TOGGLEBUTTON ||
4566 child->type == GTK_TOOLBAR_CHILD_RADIOBUTTON) &&
4567 GTK_IS_IMAGE (child->icon))
4569 image = GTK_IMAGE (child->icon);
4570 if (gtk_image_get_storage_type (image) == GTK_IMAGE_STOCK)
4572 gtk_image_get_stock (image, &stock_id, NULL);
4573 stock_id = g_strdup (stock_id);
4574 gtk_image_set_from_stock (image,
4582 if (child->type == GTK_TOOLBAR_CHILD_BUTTON ||
4583 child->type == GTK_TOOLBAR_CHILD_RADIOBUTTON ||
4584 child->type == GTK_TOOLBAR_CHILD_TOGGLEBUTTON)
4586 gtk_button_set_relief (GTK_BUTTON (child->widget), relief);
4591 toolbar_content_toolbar_reconfigured (ToolbarContent *content,
4592 GtkToolbar *toolbar)
4594 switch (content->type)
4597 _gtk_tool_item_toolbar_reconfigured (content->u.tool_item.item);
4601 toolbar_child_reconfigure (toolbar, &(content->u.compatibility.child));
4607 toolbar_content_retrieve_menu_item (ToolbarContent *content)
4609 if (content->type == TOOL_ITEM)
4610 return gtk_tool_item_retrieve_proxy_menu_item (content->u.tool_item.item);
4612 /* FIXME - we might actually be able to do something meaningful here */
4617 toolbar_content_has_proxy_menu_item (ToolbarContent *content)
4619 if (content->type == TOOL_ITEM)
4621 GtkWidget *menu_item;
4623 if (content->u.tool_item.has_menu == YES)
4625 else if (content->u.tool_item.has_menu == NO)
4628 menu_item = toolbar_content_retrieve_menu_item (content);
4630 content->u.tool_item.has_menu = menu_item? YES : NO;
4632 return menu_item != NULL;
4641 toolbar_content_set_unknown_menu_status (ToolbarContent *content)
4643 if (content->type == TOOL_ITEM)
4644 content->u.tool_item.has_menu = UNKNOWN;
4648 toolbar_content_is_separator (ToolbarContent *content)
4650 GtkToolbarChild *child;
4652 switch (content->type)
4655 return GTK_IS_SEPARATOR_TOOL_ITEM (content->u.tool_item.item);
4659 child = &(content->u.compatibility.child);
4660 return (child->type == GTK_TOOLBAR_CHILD_SPACE);
4668 toolbar_content_set_expand (ToolbarContent *content,
4671 if (content->type == TOOL_ITEM)
4672 gtk_tool_item_set_expand (content->u.tool_item.item, expand);
4676 ignore_show_and_hide_all (ToolbarContent *content)
4678 if (content->type == COMPATIBILITY)
4680 GtkToolbarChildType type = content->u.compatibility.child.type;
4682 if (type == GTK_TOOLBAR_CHILD_BUTTON ||
4683 type == GTK_TOOLBAR_CHILD_TOGGLEBUTTON ||
4684 type == GTK_TOOLBAR_CHILD_RADIOBUTTON)
4694 toolbar_content_show_all (ToolbarContent *content)
4698 if (ignore_show_and_hide_all (content))
4701 widget = toolbar_content_get_widget (content);
4703 gtk_widget_show_all (widget);
4707 toolbar_content_hide_all (ToolbarContent *content)
4711 if (ignore_show_and_hide_all (content))
4714 widget = toolbar_content_get_widget (content);
4716 gtk_widget_hide_all (widget);
4723 get_space_size (GtkToolbar *toolbar)
4725 gint space_size = DEFAULT_SPACE_SIZE;
4729 gtk_widget_style_get (GTK_WIDGET (toolbar),
4730 "space-size", &space_size,
4737 static GtkToolbarSpaceStyle
4738 get_space_style (GtkToolbar *toolbar)
4740 GtkToolbarSpaceStyle space_style = DEFAULT_SPACE_STYLE;
4744 gtk_widget_style_get (GTK_WIDGET (toolbar),
4745 "space-style", &space_style,
4752 static GtkReliefStyle
4753 get_button_relief (GtkToolbar *toolbar)
4755 GtkReliefStyle button_relief = GTK_RELIEF_NORMAL;
4757 gtk_widget_ensure_style (GTK_WIDGET (toolbar));
4759 gtk_widget_style_get (GTK_WIDGET (toolbar),
4760 "button-relief", &button_relief,
4763 return button_relief;
4767 get_internal_padding (GtkToolbar *toolbar)
4771 gtk_widget_style_get (GTK_WIDGET (toolbar),
4772 "internal-padding", &ipadding,
4779 get_max_child_expand (GtkToolbar *toolbar)
4781 gint mexpand = G_MAXINT;
4783 gtk_widget_style_get (GTK_WIDGET (toolbar),
4784 "max-child-expand", &mexpand,
4789 static GtkShadowType
4790 get_shadow_type (GtkToolbar *toolbar)
4792 GtkShadowType shadow_type;
4794 gtk_widget_style_get (GTK_WIDGET (toolbar),
4795 "shadow-type", &shadow_type,
4805 gtk_toolbar_check_old_api (GtkToolbar *toolbar)
4807 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
4809 if (priv->api_mode == NEW_API)
4811 g_warning (MIXED_API_WARNING);
4815 priv->api_mode = OLD_API;
4820 gtk_toolbar_check_new_api (GtkToolbar *toolbar)
4822 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
4824 if (priv->api_mode == OLD_API)
4826 g_warning (MIXED_API_WARNING);
4830 priv->api_mode = NEW_API;
4834 /* GTK+ internal methods */
4837 _gtk_toolbar_get_default_space_size (void)
4839 return DEFAULT_SPACE_SIZE;
4843 _gtk_toolbar_paint_space_line (GtkWidget *widget,
4844 GtkToolbar *toolbar,
4846 GtkAllocation *allocation)
4848 const double start_fraction = (SPACE_LINE_START / SPACE_LINE_DIVISION);
4849 const double end_fraction = (SPACE_LINE_END / SPACE_LINE_DIVISION);
4851 GtkOrientation orientation;
4853 g_return_if_fail (GTK_IS_WIDGET (widget));
4855 orientation = toolbar? toolbar->orientation : GTK_ORIENTATION_HORIZONTAL;
4857 if (orientation == GTK_ORIENTATION_HORIZONTAL)
4859 gboolean wide_separators;
4860 gint separator_width;
4862 gtk_widget_style_get (widget,
4863 "wide-separators", &wide_separators,
4864 "separator-width", &separator_width,
4867 if (wide_separators)
4868 gtk_paint_box (widget->style, widget->window,
4869 GTK_WIDGET_STATE (widget), GTK_SHADOW_ETCHED_OUT,
4870 area, widget, "vseparator",
4871 allocation->x + (allocation->width - separator_width) / 2,
4872 allocation->y + allocation->height * start_fraction,
4874 allocation->height * (end_fraction - start_fraction));
4876 gtk_paint_vline (widget->style, widget->window,
4877 GTK_WIDGET_STATE (widget), area, widget,
4879 allocation->y + allocation->height * start_fraction,
4880 allocation->y + allocation->height * end_fraction,
4881 allocation->x + (allocation->width - widget->style->xthickness) / 2);
4885 gboolean wide_separators;
4886 gint separator_height;
4888 gtk_widget_style_get (widget,
4889 "wide-separators", &wide_separators,
4890 "separator-height", &separator_height,
4893 if (wide_separators)
4894 gtk_paint_box (widget->style, widget->window,
4895 GTK_WIDGET_STATE (widget), GTK_SHADOW_ETCHED_OUT,
4896 area, widget, "hseparator",
4897 allocation->x + allocation->width * start_fraction,
4898 allocation->y + (allocation->height - separator_height) / 2,
4899 allocation->width * (end_fraction - start_fraction),
4902 gtk_paint_hline (widget->style, widget->window,
4903 GTK_WIDGET_STATE (widget), area, widget,
4905 allocation->x + allocation->width * start_fraction,
4906 allocation->x + allocation->width * end_fraction,
4907 allocation->y + (allocation->height - widget->style->ythickness) / 2);
4912 _gtk_toolbar_elide_underscores (const gchar *original)
4915 const gchar *p, *end;
4917 gboolean last_underscore;
4922 len = strlen (original);
4923 q = result = g_malloc (len + 1);
4924 last_underscore = FALSE;
4926 end = original + len;
4927 for (p = original; p < end; p++)
4929 if (!last_underscore && *p == '_')
4930 last_underscore = TRUE;
4933 last_underscore = FALSE;
4934 if (original + 2 <= p && p + 1 <= end &&
4935 p[-2] == '(' && p[-1] == '_' && p[0] != '_' && p[1] == ')')
4946 if (last_underscore)
4955 toolbar_get_icon_size (GtkToolShell *shell)
4957 return GTK_TOOLBAR (shell)->icon_size;
4960 static GtkOrientation
4961 toolbar_get_orientation (GtkToolShell *shell)
4963 return GTK_TOOLBAR (shell)->orientation;
4966 static GtkToolbarStyle
4967 toolbar_get_style (GtkToolShell *shell)
4969 return GTK_TOOLBAR (shell)->style;
4972 static GtkReliefStyle
4973 toolbar_get_relief_style (GtkToolShell *shell)
4975 return get_button_relief (GTK_TOOLBAR (shell));
4979 toolbar_rebuild_menu (GtkToolShell *shell)
4981 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (shell);
4984 priv->need_rebuild = TRUE;
4986 for (list = priv->content; list != NULL; list = list->next)
4988 ToolbarContent *content = list->data;
4990 toolbar_content_set_unknown_menu_status (content);
4993 gtk_widget_queue_resize (GTK_WIDGET (shell));
4996 #define __GTK_TOOLBAR_C__
4997 #include "gtkaliasdef.c"