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@codefactory.se>
6 * Copyright (C) 2002 James Henstridge <james@daa.com.au>
7 * Copyright (C) 2003 Soeren Sandmann <sandmann@daimi.au.dk>
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
12 * version 2 of the License, or (at your option) any later version.
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with this library; if not, write to the
21 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
22 * Boston, MA 02111-1307, USA.
26 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
27 * file for a list of people on the GTK+ Team. See the ChangeLog
28 * files for a list of changes. These files are distributed with
29 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
32 #undef GTK_DISABLE_DEPRECATED
35 #include "gtktoolbar.h"
36 #include "gtkradiotoolbutton.h"
37 #include "gtkseparatortoolitem.h"
39 #include "gtkradiobutton.h"
40 #include "gtktoolbar.h"
41 #include "gtkbindings.h"
42 #include <gdk/gdkkeysyms.h>
43 #include "gtkmarshalers.h"
47 #include "gtkprivate.h"
51 #define DEFAULT_IPADDING 0
53 /* note: keep in sync with DEFAULT_SPACE_SIZE and DEFAULT_SPACE_STYLE in gtkseparatortoolitem.c */
54 #define DEFAULT_SPACE_SIZE 4
55 #define DEFAULT_SPACE_STYLE GTK_TOOLBAR_SPACE_LINE
57 #define DEFAULT_ICON_SIZE GTK_ICON_SIZE_LARGE_TOOLBAR
58 #define DEFAULT_TOOLBAR_STYLE GTK_TOOLBAR_BOTH
70 CHILD_PROP_HOMOGENEOUS,
83 static void gtk_toolbar_init (GtkToolbar *toolbar);
84 static void gtk_toolbar_class_init (GtkToolbarClass *klass);
86 static void gtk_toolbar_set_property (GObject *object,
90 static void gtk_toolbar_get_property (GObject *object,
95 static gint gtk_toolbar_expose (GtkWidget *widget,
96 GdkEventExpose *event);
97 static void gtk_toolbar_realize (GtkWidget *widget);
98 static void gtk_toolbar_unrealize (GtkWidget *widget);
99 static void gtk_toolbar_size_request (GtkWidget *widget,
100 GtkRequisition *requisition);
101 static void gtk_toolbar_size_allocate (GtkWidget *widget,
102 GtkAllocation *allocation);
103 static void gtk_toolbar_style_set (GtkWidget *widget,
104 GtkStyle *prev_style);
105 static void gtk_toolbar_direction_changed (GtkWidget *widget,
106 GtkTextDirection previous_direction);
107 static gboolean gtk_toolbar_focus (GtkWidget *widget,
108 GtkDirectionType dir);
109 static void gtk_toolbar_screen_changed (GtkWidget *widget,
110 GdkScreen *previous_screen);
111 static void gtk_toolbar_map (GtkWidget *widget);
112 static void gtk_toolbar_unmap (GtkWidget *widget);
114 static void gtk_toolbar_drag_leave (GtkWidget *widget,
115 GdkDragContext *context,
117 static gboolean gtk_toolbar_drag_motion (GtkWidget *widget,
118 GdkDragContext *context,
122 static void gtk_toolbar_set_child_property (GtkContainer *container,
127 static void gtk_toolbar_get_child_property (GtkContainer *container,
132 static void gtk_toolbar_finalize (GObject *object);
135 static void gtk_toolbar_add (GtkContainer *container,
137 static void gtk_toolbar_remove (GtkContainer *container,
139 static void gtk_toolbar_forall (GtkContainer *container,
140 gboolean include_internals,
141 GtkCallback callback,
142 gpointer callback_data);
143 static GType gtk_toolbar_child_type (GtkContainer *container);
145 static void gtk_toolbar_real_orientation_changed (GtkToolbar *toolbar,
146 GtkOrientation orientation);
147 static void gtk_toolbar_real_style_changed (GtkToolbar *toolbar,
148 GtkToolbarStyle style);
150 static gboolean gtk_toolbar_move_focus (GtkToolbar *toolbar,
151 GtkDirectionType dir);
152 static gboolean gtk_toolbar_focus_home_or_end (GtkToolbar *toolbar,
153 gboolean focus_home);
155 static gboolean gtk_toolbar_button_press (GtkWidget *toolbar,
156 GdkEventButton *event);
157 static gboolean gtk_toolbar_arrow_button_press (GtkWidget *button,
158 GdkEventButton *event,
159 GtkToolbar *toolbar);
160 static void gtk_toolbar_arrow_button_clicked (GtkWidget *button,
161 GtkToolbar *toolbar);
162 static void gtk_toolbar_update_button_relief (GtkToolbar *toolbar);
163 static GtkReliefStyle get_button_relief (GtkToolbar *toolbar);
164 static gint get_internal_padding (GtkToolbar *toolbar);
165 static GtkShadowType get_shadow_type (GtkToolbar *toolbar);
166 static void gtk_toolbar_remove_tool_item (GtkToolbar *toolbar,
168 static gboolean gtk_toolbar_popup_menu (GtkWidget *toolbar);
170 static GtkWidget *gtk_toolbar_internal_insert_element (GtkToolbar *toolbar,
171 GtkToolbarChildType type,
174 const char *tooltip_text,
175 const char *tooltip_private_text,
177 GtkSignalFunc callback,
189 struct _GtkToolbarPrivate
194 GtkWidget *arrow_button;
199 GdkWindow *drag_highlight;
202 GdkWindow *event_window;
204 GtkSettings *settings;
207 static GtkContainerClass *parent_class = NULL;
208 static guint toolbar_signals [LAST_SIGNAL] = { 0 };
211 gtk_toolbar_get_type (void)
213 static GtkType type = 0;
217 static const GTypeInfo type_info =
219 sizeof (GtkToolbarClass),
220 (GBaseInitFunc) NULL,
221 (GBaseFinalizeFunc) NULL,
222 (GClassInitFunc) gtk_toolbar_class_init,
223 (GClassFinalizeFunc) NULL,
227 (GInstanceInitFunc) gtk_toolbar_init,
230 type = g_type_register_static (GTK_TYPE_CONTAINER,
239 add_arrow_bindings (GtkBindingSet *binding_set,
241 GtkDirectionType dir)
243 guint keypad_keysym = keysym - GDK_Left + GDK_KP_Left;
245 gtk_binding_entry_add_signal (binding_set, keysym, 0,
247 GTK_TYPE_DIRECTION_TYPE, dir);
248 gtk_binding_entry_add_signal (binding_set, keypad_keysym, 0,
250 GTK_TYPE_DIRECTION_TYPE, dir);
254 add_ctrl_tab_bindings (GtkBindingSet *binding_set,
255 GdkModifierType modifiers,
256 GtkDirectionType direction)
258 gtk_binding_entry_add_signal (binding_set,
259 GDK_Tab, GDK_CONTROL_MASK | modifiers,
261 GTK_TYPE_DIRECTION_TYPE, direction);
262 gtk_binding_entry_add_signal (binding_set,
263 GDK_KP_Tab, GDK_CONTROL_MASK | modifiers,
265 GTK_TYPE_DIRECTION_TYPE, direction);
269 gtk_toolbar_class_init (GtkToolbarClass *klass)
271 GObjectClass *gobject_class;
272 GtkWidgetClass *widget_class;
273 GtkContainerClass *container_class;
274 GtkBindingSet *binding_set;
276 parent_class = g_type_class_peek_parent (klass);
278 gobject_class = (GObjectClass *)klass;
279 widget_class = (GtkWidgetClass *)klass;
280 container_class = (GtkContainerClass *)klass;
282 gobject_class->set_property = gtk_toolbar_set_property;
283 gobject_class->get_property = gtk_toolbar_get_property;
284 gobject_class->finalize = gtk_toolbar_finalize;
286 widget_class->button_press_event = gtk_toolbar_button_press;
287 widget_class->expose_event = gtk_toolbar_expose;
288 widget_class->size_request = gtk_toolbar_size_request;
289 widget_class->size_allocate = gtk_toolbar_size_allocate;
290 widget_class->style_set = gtk_toolbar_style_set;
291 widget_class->direction_changed = gtk_toolbar_direction_changed;
292 widget_class->focus = gtk_toolbar_focus;
293 widget_class->screen_changed = gtk_toolbar_screen_changed;
294 widget_class->realize = gtk_toolbar_realize;
295 widget_class->unrealize = gtk_toolbar_unrealize;
296 widget_class->map = gtk_toolbar_map;
297 widget_class->unmap = gtk_toolbar_unmap;
298 widget_class->popup_menu = gtk_toolbar_popup_menu;
300 widget_class->drag_leave = gtk_toolbar_drag_leave;
301 widget_class->drag_motion = gtk_toolbar_drag_motion;
303 container_class->add = gtk_toolbar_add;
304 container_class->remove = gtk_toolbar_remove;
305 container_class->forall = gtk_toolbar_forall;
306 container_class->child_type = gtk_toolbar_child_type;
307 container_class->get_child_property = gtk_toolbar_get_child_property;
308 container_class->set_child_property = gtk_toolbar_set_child_property;
310 klass->orientation_changed = gtk_toolbar_real_orientation_changed;
311 klass->style_changed = gtk_toolbar_real_style_changed;
313 toolbar_signals[ORIENTATION_CHANGED] =
314 g_signal_new ("orientation_changed",
315 G_OBJECT_CLASS_TYPE (klass),
317 G_STRUCT_OFFSET (GtkToolbarClass, orientation_changed),
319 g_cclosure_marshal_VOID__ENUM,
321 GTK_TYPE_ORIENTATION);
322 toolbar_signals[STYLE_CHANGED] =
323 g_signal_new ("style_changed",
324 G_OBJECT_CLASS_TYPE (klass),
326 G_STRUCT_OFFSET (GtkToolbarClass, style_changed),
328 g_cclosure_marshal_VOID__ENUM,
330 GTK_TYPE_TOOLBAR_STYLE);
331 toolbar_signals[POPUP_CONTEXT_MENU] =
332 g_signal_new ("popup_context_menu",
333 G_OBJECT_CLASS_TYPE (klass),
335 G_STRUCT_OFFSET (GtkToolbarClass, popup_context_menu),
336 _gtk_boolean_handled_accumulator, NULL,
337 _gtk_marshal_BOOLEAN__INT_INT_INT,
339 G_TYPE_INT, G_TYPE_INT,
341 toolbar_signals[MOVE_FOCUS] =
342 _gtk_binding_signal_new ("move_focus",
343 G_TYPE_FROM_CLASS (klass),
344 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
345 G_CALLBACK (gtk_toolbar_move_focus),
347 _gtk_marshal_BOOLEAN__ENUM,
349 GTK_TYPE_DIRECTION_TYPE);
350 toolbar_signals[FOCUS_HOME_OR_END] =
351 _gtk_binding_signal_new ("focus_home_or_end",
352 G_OBJECT_CLASS_TYPE (klass),
353 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
354 G_CALLBACK (gtk_toolbar_focus_home_or_end),
356 _gtk_marshal_BOOLEAN__BOOLEAN,
361 g_object_class_install_property (gobject_class,
363 g_param_spec_enum ("orientation",
365 _("The orientation of the toolbar"),
366 GTK_TYPE_ORIENTATION,
367 GTK_ORIENTATION_HORIZONTAL,
370 g_object_class_install_property (gobject_class,
372 g_param_spec_enum ("toolbar_style",
374 _("How to draw the toolbar"),
375 GTK_TYPE_TOOLBAR_STYLE,
378 g_object_class_install_property (gobject_class,
380 g_param_spec_boolean ("show_arrow",
382 _("If an arrow should be shown if the toolbar doesn't fit"),
386 /* child properties */
387 gtk_container_class_install_child_property (container_class,
389 g_param_spec_boolean ("expand",
391 _("Whether the item should receive extra space when the toolbar grows"),
395 gtk_container_class_install_child_property (container_class,
396 CHILD_PROP_HOMOGENEOUS,
397 g_param_spec_boolean ("homogeneous",
399 _("Whether the item should be the same size as other homogeneous items"),
403 gtk_container_class_install_child_property (container_class,
405 g_param_spec_uint ("pack_end",
407 _("Whether the item is positioned at the end of the toolbar"),
411 /* style properties */
412 gtk_widget_class_install_style_property (widget_class,
413 g_param_spec_int ("space_size",
415 _("Size of spacers"),
421 gtk_widget_class_install_style_property (widget_class,
422 g_param_spec_int ("internal_padding",
423 _("Internal padding"),
424 _("Amount of border space between the toolbar shadow and the buttons"),
430 gtk_widget_class_install_style_property (widget_class,
431 g_param_spec_enum ("space_style",
433 _("Whether spacers are vertical lines or just blank"),
434 GTK_TYPE_TOOLBAR_SPACE_STYLE,
438 gtk_widget_class_install_style_property (widget_class,
439 g_param_spec_enum ("button_relief",
441 _("Type of bevel around toolbar buttons"),
442 GTK_TYPE_RELIEF_STYLE,
445 gtk_widget_class_install_style_property (widget_class,
446 g_param_spec_enum ("shadow_type",
448 _("Style of bevel around the toolbar"),
449 GTK_TYPE_SHADOW_TYPE,
453 gtk_settings_install_property (g_param_spec_enum ("gtk-toolbar-style",
455 _("Whether default toolbars have text only, text and icons, icons only, etc."),
456 GTK_TYPE_TOOLBAR_STYLE,
457 DEFAULT_TOOLBAR_STYLE,
460 gtk_settings_install_property (g_param_spec_enum ("gtk-toolbar-icon-size",
461 _("Toolbar icon size"),
462 _("Size of icons in default toolbars"),
467 binding_set = gtk_binding_set_by_class (klass);
469 add_arrow_bindings (binding_set, GDK_Left, GTK_DIR_LEFT);
470 add_arrow_bindings (binding_set, GDK_Right, GTK_DIR_RIGHT);
471 add_arrow_bindings (binding_set, GDK_Up, GTK_DIR_UP);
472 add_arrow_bindings (binding_set, GDK_Down, GTK_DIR_DOWN);
474 gtk_binding_entry_add_signal (binding_set, GDK_KP_Home, 0,
475 "focus_home_or_end", 1,
476 G_TYPE_BOOLEAN, TRUE);
477 gtk_binding_entry_add_signal (binding_set, GDK_Home, 0,
478 "focus_home_or_end", 1,
479 G_TYPE_BOOLEAN, TRUE);
480 gtk_binding_entry_add_signal (binding_set, GDK_KP_End, 0,
481 "focus_home_or_end", 1,
482 G_TYPE_BOOLEAN, FALSE);
483 gtk_binding_entry_add_signal (binding_set, GDK_End, 0,
484 "focus_home_or_end", 1,
485 G_TYPE_BOOLEAN, FALSE);
487 add_ctrl_tab_bindings (binding_set, 0, GTK_DIR_TAB_FORWARD);
488 add_ctrl_tab_bindings (binding_set, GDK_SHIFT_MASK, GTK_DIR_TAB_BACKWARD);
490 g_type_class_add_private (gobject_class, sizeof (GtkToolbarPrivate));
494 gtk_toolbar_init (GtkToolbar *toolbar)
496 GtkToolbarPrivate *priv;
498 GTK_WIDGET_UNSET_FLAGS (toolbar, GTK_CAN_FOCUS);
499 GTK_WIDGET_SET_FLAGS (toolbar, GTK_NO_WINDOW);
501 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
503 toolbar->orientation = GTK_ORIENTATION_HORIZONTAL;
504 toolbar->style = DEFAULT_TOOLBAR_STYLE;
505 toolbar->icon_size = DEFAULT_ICON_SIZE;
506 toolbar->tooltips = gtk_tooltips_new ();
507 g_object_ref (toolbar->tooltips);
508 gtk_object_sink (GTK_OBJECT (toolbar->tooltips));
510 priv->arrow_button = gtk_toggle_button_new ();
511 g_signal_connect (priv->arrow_button, "button_press_event",
512 G_CALLBACK (gtk_toolbar_arrow_button_press), toolbar);
513 g_signal_connect (priv->arrow_button, "clicked",
514 G_CALLBACK (gtk_toolbar_arrow_button_clicked), toolbar);
515 gtk_button_set_relief (GTK_BUTTON (priv->arrow_button),
516 get_button_relief (toolbar));
518 priv->api_mode = DONT_KNOW;
520 gtk_button_set_focus_on_click (GTK_BUTTON (priv->arrow_button), FALSE);
522 priv->arrow = gtk_arrow_new (GTK_ARROW_DOWN, GTK_SHADOW_NONE);
523 gtk_widget_show (priv->arrow);
524 gtk_container_add (GTK_CONTAINER (priv->arrow_button), priv->arrow);
526 gtk_widget_set_parent (priv->arrow_button, GTK_WIDGET (toolbar));
528 /* which child position a drop will occur at */
529 priv->drop_index = -1;
530 priv->drag_highlight = NULL;
533 priv->show_arrow = TRUE;
534 priv->settings = NULL;
538 toolbar_item_visible (GtkToolbar *toolbar,
541 if (GTK_WIDGET_VISIBLE (item) &&
542 ((toolbar->orientation == GTK_ORIENTATION_HORIZONTAL &&
543 gtk_tool_item_get_visible_horizontal (item)) ||
544 (toolbar->orientation == GTK_ORIENTATION_VERTICAL &&
545 gtk_tool_item_get_visible_vertical (item))))
547 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
549 /* With the old toolbar you could hide a button by calling gtk_widget_hide()
550 * on it. This doesn't work with the new API because the GtkToolItem will not be
553 if (priv->api_mode == OLD_API)
555 GtkWidget *bin_child = GTK_BIN (item)->child;
557 if (bin_child && !GTK_WIDGET_VISIBLE (bin_child))
568 toolbar_item_is_homogeneous (GtkToolItem *item)
570 return (gtk_tool_item_get_homogeneous (item) && !GTK_IS_SEPARATOR_TOOL_ITEM (item));
574 toolbar_item_set_is_overflow (GtkToolItem *item,
575 gboolean is_overflow)
577 g_object_set_data (G_OBJECT (item), "gtk-toolbar-item-is-overflow", GINT_TO_POINTER (is_overflow));
581 toolbar_item_get_is_overflow (GtkToolItem *item)
585 result = g_object_get_data (G_OBJECT (item), "gtk-toolbar-item-is-overflow");
587 return GPOINTER_TO_INT (result);
591 gtk_toolbar_set_property (GObject *object,
596 GtkToolbar *toolbar = GTK_TOOLBAR (object);
600 case PROP_ORIENTATION:
601 gtk_toolbar_set_orientation (toolbar, g_value_get_enum (value));
603 case PROP_TOOLBAR_STYLE:
604 gtk_toolbar_set_style (toolbar, g_value_get_enum (value));
606 case PROP_SHOW_ARROW:
607 gtk_toolbar_set_show_arrow (toolbar, g_value_get_boolean (value));
610 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
616 gtk_toolbar_get_property (GObject *object,
621 GtkToolbar *toolbar = GTK_TOOLBAR (object);
622 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
626 case PROP_ORIENTATION:
627 g_value_set_enum (value, toolbar->orientation);
629 case PROP_TOOLBAR_STYLE:
630 g_value_set_enum (value, toolbar->style);
632 case PROP_SHOW_ARROW:
633 g_value_set_boolean (value, priv->show_arrow);
636 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
642 gtk_toolbar_map (GtkWidget *widget)
644 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (widget);
646 GTK_WIDGET_CLASS (parent_class)->map (widget);
648 if (priv->event_window)
649 gdk_window_show_unraised (priv->event_window);
653 gtk_toolbar_unmap (GtkWidget *widget)
655 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (widget);
657 if (priv->event_window)
658 gdk_window_hide (priv->event_window);
660 GTK_WIDGET_CLASS (parent_class)->unmap (widget);
664 gtk_toolbar_realize (GtkWidget *widget)
666 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
667 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
669 GdkWindowAttr attributes;
670 gint attributes_mask;
673 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
675 border_width = GTK_CONTAINER (widget)->border_width;
677 attributes.wclass = GDK_INPUT_ONLY;
678 attributes.window_type = GDK_WINDOW_CHILD;
679 attributes.x = widget->allocation.x + border_width;
680 attributes.y = widget->allocation.y + border_width;
681 attributes.width = widget->allocation.width - border_width * 2;
682 attributes.height = widget->allocation.height - border_width * 2;
683 attributes.event_mask = gtk_widget_get_events (widget);
684 attributes.event_mask |= (GDK_BUTTON_PRESS_MASK |
685 GDK_BUTTON_RELEASE_MASK |
686 GDK_ENTER_NOTIFY_MASK |
687 GDK_LEAVE_NOTIFY_MASK);
689 attributes_mask = GDK_WA_X | GDK_WA_Y;
691 widget->window = gtk_widget_get_parent_window (widget);
692 g_object_ref (widget->window);
693 widget->style = gtk_style_attach (widget->style, widget->window);
695 priv->event_window = gdk_window_new (gtk_widget_get_parent_window (widget),
696 &attributes, attributes_mask);
697 gdk_window_set_user_data (priv->event_window, toolbar);
701 gtk_toolbar_unrealize (GtkWidget *widget)
703 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (widget);
705 if (priv->drag_highlight)
707 gdk_window_set_user_data (priv->drag_highlight, NULL);
708 gdk_window_destroy (priv->drag_highlight);
709 priv->drag_highlight = NULL;
712 if (priv->event_window)
714 gdk_window_set_user_data (priv->event_window, NULL);
715 gdk_window_destroy (priv->event_window);
716 priv->event_window = NULL;
719 if (GTK_WIDGET_CLASS (parent_class)->unrealize)
720 (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
724 gtk_toolbar_expose (GtkWidget *widget,
725 GdkEventExpose *event)
727 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
728 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
733 border_width = GTK_CONTAINER (widget)->border_width;
735 if (GTK_WIDGET_DRAWABLE (widget))
737 gtk_paint_box (widget->style,
739 GTK_WIDGET_STATE (widget),
740 get_shadow_type (toolbar),
741 &event->area, widget, "toolbar",
742 border_width + widget->allocation.x,
743 border_width + widget->allocation.y,
744 widget->allocation.width - 2 * border_width,
745 widget->allocation.height - 2 * border_width);
751 GtkToolItem *item = GTK_TOOL_ITEM (items->data);
753 gtk_container_propagate_expose (GTK_CONTAINER (widget),
760 gtk_container_propagate_expose (GTK_CONTAINER (widget),
768 gtk_toolbar_size_request (GtkWidget *widget,
769 GtkRequisition *requisition)
771 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
772 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
774 gint max_child_height;
775 gint max_child_width;
776 gint max_homogeneous_child_width;
777 gint max_homogeneous_child_height;
778 gint homogeneous_size;
781 gint pack_front_size;
783 GtkRequisition arrow_requisition;
785 max_homogeneous_child_width = 0;
786 max_homogeneous_child_height = 0;
788 max_child_height = 0;
789 for (list = priv->items; list != NULL; list = list->next)
791 GtkRequisition requisition;
792 GtkToolItem *item = list->data;
794 if (!toolbar_item_visible (toolbar, item))
797 gtk_widget_size_request (GTK_WIDGET (item), &requisition);
799 max_child_width = MAX (max_child_width, requisition.width);
800 max_child_height = MAX (max_child_height, requisition.height);
802 if (toolbar_item_is_homogeneous (item))
804 max_homogeneous_child_width = MAX (max_homogeneous_child_width, requisition.width);
805 max_homogeneous_child_height = MAX (max_homogeneous_child_height, requisition.height);
809 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
810 homogeneous_size = max_homogeneous_child_width;
812 homogeneous_size = max_homogeneous_child_height;
816 for (list = priv->items; list != NULL; list = list->next)
818 GtkToolItem *item = list->data;
821 if (!toolbar_item_visible (toolbar, item))
824 if (toolbar_item_is_homogeneous (item))
826 size = homogeneous_size;
830 GtkRequisition requisition;
832 gtk_widget_size_request (GTK_WIDGET (item), &requisition);
834 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
835 size = requisition.width;
837 size = requisition.height;
840 if (gtk_tool_item_get_pack_end (item))
841 pack_end_size += size;
843 pack_front_size += size;
846 if (priv->show_arrow && priv->api_mode == NEW_API)
848 gtk_widget_size_request (priv->arrow_button, &arrow_requisition);
850 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
851 long_req = arrow_requisition.width;
853 long_req = arrow_requisition.height;
855 /* There is no point requesting space for the arrow if that would take
856 * up more space than all the items combined
858 long_req = MIN (long_req, pack_front_size + pack_end_size);
862 arrow_requisition.height = 0;
863 arrow_requisition.width = 0;
865 long_req = pack_end_size + pack_front_size;
868 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
870 requisition->width = long_req;
871 requisition->height = MAX (max_child_height, arrow_requisition.height);
875 requisition->height = long_req;
876 requisition->width = MAX (max_child_width, arrow_requisition.width);
880 ipadding = get_internal_padding (toolbar);
882 requisition->width += 2 * (ipadding + GTK_CONTAINER (toolbar)->border_width);
883 requisition->height += 2 * (ipadding + GTK_CONTAINER (toolbar)->border_width);
885 if (get_shadow_type (toolbar) != GTK_SHADOW_NONE)
887 requisition->width += 2 * widget->style->xthickness;
888 requisition->height += 2 * widget->style->ythickness;
891 toolbar->button_maxw = max_homogeneous_child_width;
892 toolbar->button_maxh = max_homogeneous_child_height;
896 fixup_allocation_for_rtl (gint total_size,
897 GtkAllocation *allocation)
899 allocation->x += (total_size - (2 * allocation->x + allocation->width));
903 fixup_allocation_for_vertical (GtkAllocation *allocation)
908 allocation->x = allocation->y;
911 tmp = allocation->width;
912 allocation->width = allocation->height;
913 allocation->height = tmp;
917 get_item_size (GtkToolbar *toolbar,
920 GtkRequisition requisition;
921 GtkToolItem *item = GTK_TOOL_ITEM (child);
923 gtk_widget_get_child_requisition (child, &requisition);
925 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
927 if (toolbar_item_is_homogeneous (item))
928 return toolbar->button_maxw;
930 return requisition.width;
934 if (toolbar_item_is_homogeneous (item))
935 return toolbar->button_maxh;
937 return requisition.height;
942 gtk_toolbar_size_allocate (GtkWidget *widget,
943 GtkAllocation *allocation)
945 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
946 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
947 GtkAllocation *allocations;
948 GtkAllocation arrow_allocation;
950 gint size, pos, short_size;
960 GtkRequisition arrow_requisition;
962 widget->allocation = *allocation;
964 border_width = GTK_CONTAINER (toolbar)->border_width;
966 if (GTK_WIDGET_REALIZED (widget))
968 gdk_window_move_resize (priv->event_window,
969 allocation->x + border_width,
970 allocation->y + border_width,
971 allocation->width - border_width * 2,
972 allocation->height - border_width * 2);
975 border_width += get_internal_padding (toolbar);
977 gtk_widget_get_child_requisition (GTK_WIDGET (priv->arrow_button),
980 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
982 available_size = size = allocation->width - 2 * border_width;
983 short_size = allocation->height - 2 * border_width;
984 arrow_size = arrow_requisition.width;
986 if (get_shadow_type (toolbar) != GTK_SHADOW_NONE)
988 available_size -= 2 * widget->style->xthickness;
989 short_size -= 2 * widget->style->ythickness;
994 available_size = size = allocation->height - 2 * border_width;
995 short_size = allocation->width - 2 * border_width;
996 arrow_size = arrow_requisition.height;
998 if (get_shadow_type (toolbar) != GTK_SHADOW_NONE)
1000 available_size -= 2 * widget->style->ythickness;
1001 short_size -= 2 * widget->style->xthickness;
1005 n_items = g_list_length (priv->items);
1006 allocations = g_new0 (GtkAllocation, n_items);
1009 for (list = priv->items; list != NULL; list = list->next)
1011 GtkToolItem *item = list->data;
1013 if (toolbar_item_visible (toolbar, item))
1014 needed_size += get_item_size (toolbar, GTK_WIDGET (item));
1017 need_arrow = (needed_size > available_size) && priv->show_arrow && priv->api_mode == NEW_API;
1020 size = available_size - arrow_size;
1022 size = available_size;
1024 items = g_list_copy (priv->items);
1026 /* calculate widths of pack end items */
1027 for (list = g_list_last (items), i = 0; list != NULL; list = list->prev, ++i)
1029 GtkToolItem *item = list->data;
1030 GtkAllocation *allocation = &(allocations[n_items - i - 1]);
1033 if (!gtk_tool_item_get_pack_end (item) ||
1034 !toolbar_item_visible (toolbar, item))
1037 item_size = get_item_size (toolbar, GTK_WIDGET (item));
1038 if (item_size <= size)
1041 allocation->width = item_size;
1042 toolbar_item_set_is_overflow (item, FALSE);
1049 if (gtk_tool_item_get_pack_end (item))
1050 toolbar_item_set_is_overflow (item, TRUE);
1058 /* calculate widths of pack front items */
1059 for (list = items, i = 0; list != NULL; list = list->next, ++i)
1061 GtkToolItem *item = list->data;
1064 if (gtk_tool_item_get_pack_end (item) || !toolbar_item_visible (toolbar, item))
1067 item_size = get_item_size (toolbar, GTK_WIDGET (item));
1068 if (item_size <= size)
1071 allocations[i].width = item_size;
1072 toolbar_item_set_is_overflow (item, FALSE);
1079 if (!gtk_tool_item_get_pack_end (item))
1080 toolbar_item_set_is_overflow (item, TRUE);
1089 arrow_allocation.width = arrow_size;
1090 arrow_allocation.height = short_size;
1093 /* expand expandable items */
1095 for (list = priv->items; list != NULL; list = list->next)
1097 GtkToolItem *item = list->data;
1099 if (toolbar_item_visible (toolbar, item) &&
1100 gtk_tool_item_get_expand (item) &&
1101 !toolbar_item_get_is_overflow (item) &&
1102 !GTK_IS_SEPARATOR_TOOL_ITEM (item))
1108 for (list = items, i = 0; list != NULL; list = list->next, ++i)
1110 GtkToolItem *item = list->data;
1112 if (toolbar_item_visible (toolbar, item) && gtk_tool_item_get_expand (item) &&
1113 !toolbar_item_get_is_overflow (item) &&
1114 !GTK_IS_SEPARATOR_TOOL_ITEM (item))
1116 gint extra = size / n_expand_items;
1117 if (size % n_expand_items != 0)
1120 allocations[i].width += extra;
1126 g_assert (n_expand_items == 0);
1128 /* position pack front items */
1130 for (list = items, i = 0; list != NULL; list = list->next, ++i)
1132 GtkToolItem *item = list->data;
1134 if (toolbar_item_visible (toolbar, item) && !toolbar_item_get_is_overflow (item) && !gtk_tool_item_get_pack_end (item))
1136 allocations[i].x = pos;
1137 allocations[i].y = border_width;
1138 allocations[i].height = short_size;
1140 pos += allocations[i].width;
1144 /* position pack end items */
1145 pos = available_size + border_width;
1146 for (list = g_list_last (items), i = 0; list != NULL; list = list->prev, ++i)
1148 GtkToolItem *item = list->data;
1150 if (toolbar_item_visible (toolbar, item) && !toolbar_item_get_is_overflow (item) && gtk_tool_item_get_pack_end (item))
1152 GtkAllocation *allocation = &(allocations[n_items - i - 1]);
1154 allocation->x = pos - allocation->width;
1155 allocation->y = border_width;
1156 allocation->height = short_size;
1158 pos -= allocation->width;
1162 /* position arrow */
1165 arrow_allocation.x = pos - arrow_allocation.width;
1166 arrow_allocation.y = border_width;
1169 /* fix up allocations in the vertical or RTL cases */
1170 if (toolbar->orientation == GTK_ORIENTATION_VERTICAL)
1172 for (i = 0; i < n_items; ++i)
1173 fixup_allocation_for_vertical (&(allocations[i]));
1176 fixup_allocation_for_vertical (&arrow_allocation);
1178 else if (gtk_widget_get_direction (GTK_WIDGET (toolbar)) == GTK_TEXT_DIR_RTL)
1180 for (i = 0; i < n_items; ++i)
1181 fixup_allocation_for_rtl (available_size, &(allocations[i]));
1184 fixup_allocation_for_rtl (available_size, &arrow_allocation);
1187 /* translate the items by allocation->(x,y) */
1188 for (i = 0; i < n_items; ++i)
1190 allocations[i].x += allocation->x;
1191 allocations[i].y += allocation->y;
1193 if (get_shadow_type (toolbar) != GTK_SHADOW_NONE)
1195 allocations[i].x += widget->style->xthickness;
1196 allocations[i].y += widget->style->ythickness;
1202 arrow_allocation.x += allocation->x;
1203 arrow_allocation.y += allocation->y;
1205 if (get_shadow_type (toolbar) != GTK_SHADOW_NONE)
1207 arrow_allocation.x += widget->style->xthickness;
1208 arrow_allocation.y += widget->style->ythickness;
1212 /* finally allocate the items */
1213 for (list = items, i = 0; list != NULL; list = list->next, i++)
1215 GtkToolItem *item = list->data;
1217 if (toolbar_item_visible (toolbar, item) && !toolbar_item_get_is_overflow (item))
1219 gtk_widget_size_allocate (GTK_WIDGET (item), &(allocations[i]));
1220 gtk_widget_set_child_visible (GTK_WIDGET (item), TRUE);
1224 gtk_widget_set_child_visible (GTK_WIDGET (item), FALSE);
1230 gtk_widget_size_allocate (GTK_WIDGET (priv->arrow_button),
1232 gtk_widget_show (GTK_WIDGET (priv->arrow_button));
1236 gtk_widget_hide (GTK_WIDGET (priv->arrow_button));
1239 g_free (allocations);
1240 g_list_free (items);
1244 gtk_toolbar_style_set (GtkWidget *widget,
1245 GtkStyle *prev_style)
1247 if (GTK_WIDGET_REALIZED (widget))
1248 gtk_style_set_background (widget->style, widget->window, widget->state);
1251 gtk_toolbar_update_button_relief (GTK_TOOLBAR (widget));
1255 gtk_toolbar_direction_changed (GtkWidget *widget,
1256 GtkTextDirection previous_dir)
1258 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
1259 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1261 if (toolbar->orientation == GTK_ORIENTATION_VERTICAL)
1263 if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_LTR)
1264 gtk_arrow_set (GTK_ARROW (priv->arrow), GTK_ARROW_RIGHT, GTK_SHADOW_NONE);
1266 gtk_arrow_set (GTK_ARROW (priv->arrow), GTK_ARROW_LEFT, GTK_SHADOW_NONE);
1269 GTK_WIDGET_CLASS (parent_class)->direction_changed (widget, previous_dir);
1273 gtk_toolbar_list_children_in_focus_order (GtkToolbar *toolbar,
1274 GtkDirectionType dir)
1276 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1277 GList *result = NULL;
1281 /* generate list of children in reverse logical order */
1283 for (list = priv->items; list != NULL; list = list->next)
1285 GtkToolItem *item = list->data;
1286 if (!gtk_tool_item_get_pack_end (item))
1287 result = g_list_prepend (result, item);
1290 for (list = priv->items; list != NULL; list = list->next)
1292 GtkToolItem *item = list->data;
1294 if (gtk_tool_item_get_pack_end (item))
1295 result = g_list_prepend (result, item);
1298 result = g_list_prepend (result, priv->arrow_button);
1300 rtl = (gtk_widget_get_direction (GTK_WIDGET (toolbar)) == GTK_TEXT_DIR_RTL);
1302 /* move in logical order when
1304 * - dir is TAB_FORWARD
1306 * - in RTL mode and moving left or up
1308 * - in LTR mode and moving right or down
1310 if (dir == GTK_DIR_TAB_FORWARD ||
1311 (rtl && (dir == GTK_DIR_UP || dir == GTK_DIR_LEFT)) ||
1312 (!rtl && (dir == GTK_DIR_DOWN || dir == GTK_DIR_RIGHT)))
1314 result = g_list_reverse (result);
1321 gtk_toolbar_focus_home_or_end (GtkToolbar *toolbar,
1322 gboolean focus_home)
1324 GList *children, *list;
1325 GtkDirectionType dir = focus_home? GTK_DIR_RIGHT : GTK_DIR_LEFT;
1327 children = gtk_toolbar_list_children_in_focus_order (toolbar, dir);
1329 if (gtk_widget_get_direction (GTK_WIDGET (toolbar)) == GTK_TEXT_DIR_RTL)
1331 children = g_list_reverse (children);
1333 dir = (dir == GTK_DIR_RIGHT)? GTK_DIR_LEFT : GTK_DIR_RIGHT;
1336 for (list = children; list != NULL; list = list->next)
1338 GtkWidget *child = list->data;
1340 if (GTK_CONTAINER (toolbar)->focus_child == child)
1343 if (GTK_WIDGET_MAPPED (child) && gtk_widget_child_focus (child, dir))
1347 g_list_free (children);
1352 /* Keybinding handler. This function is called when the user presses
1353 * Ctrl TAB or an arrow key.
1356 gtk_toolbar_move_focus (GtkToolbar *toolbar,
1357 GtkDirectionType dir)
1360 gboolean try_focus = FALSE;
1362 GtkContainer *container = GTK_CONTAINER (toolbar);
1364 if (container->focus_child &&
1365 gtk_widget_child_focus (container->focus_child, dir))
1370 children = gtk_toolbar_list_children_in_focus_order (toolbar, dir);
1372 for (list = children; list != NULL; list = list->next)
1374 GtkWidget *child = list->data;
1376 if (try_focus && GTK_WIDGET_MAPPED (child) && gtk_widget_child_focus (child, dir))
1379 if (child == GTK_CONTAINER (toolbar)->focus_child)
1383 g_list_free (children);
1388 /* The focus handler for the toolbar. It called when the user presses
1389 * TAB or otherwise tries to focus the toolbar.
1392 gtk_toolbar_focus (GtkWidget *widget,
1393 GtkDirectionType dir)
1395 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
1396 GList *children, *list;
1398 /* if focus is already somewhere inside the toolbar then return FALSE.
1399 * The only way focus can stay inside the toolbar is when the user presses
1400 * arrow keys or Ctrl TAB (both of which are handled by the
1401 * gtk_toolbar_move_focus() keybinding function.
1403 if (GTK_CONTAINER (widget)->focus_child)
1406 children = gtk_toolbar_list_children_in_focus_order (toolbar, dir);
1408 for (list = children; list != NULL; list = list->next)
1410 GtkWidget *child = list->data;
1412 if (GTK_WIDGET_MAPPED (child) && gtk_widget_child_focus (child, dir))
1416 g_list_free (children);
1422 style_change_notify (GtkToolbar *toolbar)
1424 if (!toolbar->style_set)
1426 /* pretend it was set, then unset, thus reverting to new default */
1427 toolbar->style_set = TRUE;
1428 gtk_toolbar_unset_style (toolbar);
1433 icon_size_change_notify (GtkToolbar *toolbar)
1435 if (!toolbar->icon_size_set)
1437 /* pretend it was set, then unset, thus reverting to new default */
1438 toolbar->icon_size_set = TRUE;
1439 gtk_toolbar_unset_icon_size (toolbar);
1443 static GtkSettings *
1444 toolbar_get_settings (GtkToolbar *toolbar)
1446 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1447 return priv->settings;
1451 gtk_toolbar_screen_changed (GtkWidget *widget,
1452 GdkScreen *previous_screen)
1454 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (widget);
1455 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
1456 GtkSettings *old_settings = toolbar_get_settings (toolbar);
1457 GtkSettings *settings;
1459 if (gtk_widget_has_screen (GTK_WIDGET (toolbar)))
1460 settings = gtk_widget_get_settings (GTK_WIDGET (toolbar));
1464 if (settings == old_settings)
1469 g_signal_handler_disconnect (old_settings, toolbar->style_set_connection);
1470 g_signal_handler_disconnect (old_settings, toolbar->icon_size_connection);
1472 g_object_unref (old_settings);
1477 toolbar->style_set_connection =
1478 g_signal_connect_swapped (settings,
1479 "notify::gtk-toolbar-style",
1480 G_CALLBACK (style_change_notify),
1482 toolbar->icon_size_connection =
1483 g_signal_connect_swapped (settings,
1484 "notify::gtk-toolbar-icon-size",
1485 G_CALLBACK (icon_size_change_notify),
1488 g_object_ref (settings);
1489 priv->settings = settings;
1492 priv->settings = NULL;
1494 style_change_notify (toolbar);
1495 icon_size_change_notify (toolbar);
1499 find_drop_pos (GtkToolbar *toolbar,
1505 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1506 GtkOrientation orientation;
1507 GtkTextDirection direction;
1511 gint best_distance, best_pos, best_index, index;
1513 orientation = toolbar->orientation;
1514 direction = gtk_widget_get_direction (GTK_WIDGET (toolbar));
1515 border_width = GTK_CONTAINER (toolbar)->border_width + get_internal_padding (toolbar);
1517 items = priv->items;
1521 if (orientation == GTK_ORIENTATION_HORIZONTAL)
1523 if (direction == GTK_TEXT_DIR_LTR)
1524 *drop_pos = border_width;
1526 *drop_pos = GTK_WIDGET (toolbar)->allocation.width - border_width;
1530 *drop_pos = border_width;
1535 /* initial conditions */
1536 item = GTK_TOOL_ITEM (items->data);
1538 if (orientation == GTK_ORIENTATION_HORIZONTAL)
1540 if (direction == GTK_TEXT_DIR_LTR)
1541 best_pos = GTK_WIDGET (item)->allocation.x;
1543 best_pos = GTK_WIDGET (item)->allocation.x +
1544 GTK_WIDGET (item)->allocation.width;
1545 best_distance = ABS (best_pos - x);
1549 best_pos = GTK_WIDGET (item)->allocation.y;
1550 best_distance = ABS (best_pos - y);
1556 item = GTK_TOOL_ITEM (items->data);
1558 if (GTK_WIDGET_DRAWABLE (item) && !gtk_tool_item_get_pack_end (item))
1562 if (orientation == GTK_ORIENTATION_HORIZONTAL)
1564 if (direction == GTK_TEXT_DIR_LTR)
1565 pos = GTK_WIDGET (item)->allocation.x +
1566 GTK_WIDGET (item)->allocation.width;
1568 pos = GTK_WIDGET (item)->allocation.x;
1569 distance = ABS (pos - x);
1573 pos = GTK_WIDGET (item)->allocation.y +
1574 GTK_WIDGET (item)->allocation.height;
1575 distance = ABS (pos - y);
1577 if (distance < best_distance)
1581 best_distance = distance;
1584 items = items->next;
1586 *drop_index = best_index;
1587 *drop_pos = best_pos;
1591 gtk_toolbar_drag_leave (GtkWidget *widget,
1592 GdkDragContext *context,
1595 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
1596 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1598 if (priv->drag_highlight)
1600 gdk_window_set_user_data (priv->drag_highlight, NULL);
1601 gdk_window_destroy (priv->drag_highlight);
1602 priv->drag_highlight = NULL;
1605 priv->drop_index = -1;
1609 gtk_toolbar_drag_motion (GtkWidget *widget,
1610 GdkDragContext *context,
1615 GtkToolbar *toolbar = GTK_TOOLBAR (widget);
1616 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1617 gint new_index, new_pos;
1619 find_drop_pos(toolbar, x, y, &new_index, &new_pos);
1621 if (!priv->drag_highlight)
1623 GdkWindowAttr attributes;
1624 guint attributes_mask;
1626 attributes.window_type = GDK_WINDOW_CHILD;
1627 attributes.wclass = GDK_INPUT_OUTPUT;
1628 attributes.visual = gtk_widget_get_visual (widget);
1629 attributes.colormap = gtk_widget_get_colormap (widget);
1630 attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK | GDK_POINTER_MOTION_MASK;
1631 attributes.width = 1;
1632 attributes.height = 1;
1633 attributes_mask = GDK_WA_VISUAL | GDK_WA_COLORMAP;
1634 priv->drag_highlight = gdk_window_new (widget->window,
1635 &attributes, attributes_mask);
1636 gdk_window_set_user_data (priv->drag_highlight, widget);
1637 gdk_window_set_background (priv->drag_highlight,
1638 &widget->style->fg[widget->state]);
1641 if (priv->drop_index < 0 ||
1642 priv->drop_index != new_index)
1644 gint border_width = GTK_CONTAINER (toolbar)->border_width;
1645 priv->drop_index = new_index;
1646 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
1648 gdk_window_move_resize (priv->drag_highlight,
1649 widget->allocation.x + new_pos - 1,
1650 widget->allocation.y + border_width,
1651 2, widget->allocation.height-border_width*2);
1655 gdk_window_move_resize (priv->drag_highlight,
1656 widget->allocation.x + border_width,
1657 widget->allocation.y + new_pos - 1,
1658 widget->allocation.width-border_width*2, 2);
1662 gdk_window_show (priv->drag_highlight);
1664 gdk_drag_status (context, context->suggested_action, time_);
1670 gtk_toolbar_get_child_property (GtkContainer *container,
1676 GtkToolItem *item = GTK_TOOL_ITEM (child);
1678 switch (property_id)
1680 case CHILD_PROP_PACK_END:
1681 g_value_set_boolean (value, gtk_tool_item_get_pack_end (item));
1684 case CHILD_PROP_HOMOGENEOUS:
1685 g_value_set_boolean (value, gtk_tool_item_get_homogeneous (item));
1688 case CHILD_PROP_EXPAND:
1689 g_value_set_boolean (value, gtk_tool_item_get_expand (item));
1693 GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, property_id, pspec);
1699 gtk_toolbar_set_child_property (GtkContainer *container,
1702 const GValue *value,
1705 switch (property_id)
1707 case CHILD_PROP_PACK_END:
1708 gtk_tool_item_set_pack_end (GTK_TOOL_ITEM (child), g_value_get_boolean (value));
1711 case CHILD_PROP_HOMOGENEOUS:
1712 gtk_tool_item_set_homogeneous (GTK_TOOL_ITEM (child), g_value_get_boolean (value));
1715 case CHILD_PROP_EXPAND:
1716 gtk_tool_item_set_homogeneous (GTK_TOOL_ITEM (child), g_value_get_boolean (value));
1720 GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, property_id, pspec);
1726 gtk_toolbar_add (GtkContainer *container,
1729 GtkToolbar *toolbar;
1731 g_return_if_fail (GTK_IS_TOOLBAR (container));
1732 g_return_if_fail (widget != NULL);
1734 toolbar = GTK_TOOLBAR (container);
1736 if (GTK_IS_TOOL_ITEM (widget))
1737 gtk_toolbar_insert (toolbar, GTK_TOOL_ITEM (widget), 0);
1739 gtk_toolbar_append_widget (toolbar, widget, NULL, NULL);
1743 gtk_toolbar_remove (GtkContainer *container,
1746 GtkToolbar *toolbar;
1747 GtkToolItem *item = NULL;
1749 g_return_if_fail (GTK_IS_TOOLBAR (container));
1750 g_return_if_fail (GTK_IS_WIDGET (widget));
1752 toolbar = GTK_TOOLBAR (container);
1754 if (GTK_IS_TOOL_ITEM (widget))
1756 item = GTK_TOOL_ITEM (widget);
1760 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1763 for (list = priv->items; list != NULL; list = list->next)
1765 if (GTK_BIN (list->data)->child == widget)
1773 g_return_if_fail (item != NULL);
1775 gtk_toolbar_remove_tool_item (GTK_TOOLBAR (container), item);
1779 gtk_toolbar_forall (GtkContainer *container,
1780 gboolean include_internals,
1781 GtkCallback callback,
1782 gpointer callback_data)
1784 GtkToolbar *toolbar = GTK_TOOLBAR (container);
1785 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1788 g_return_if_fail (callback != NULL);
1790 items = priv->items;
1794 GtkToolItem *item = GTK_TOOL_ITEM (items->data);
1796 items = items->next;
1798 (*callback) (GTK_WIDGET (item), callback_data);
1801 if (include_internals)
1802 (* callback) (priv->arrow_button, callback_data);
1806 gtk_toolbar_child_type (GtkContainer *container)
1808 return GTK_TYPE_TOOL_ITEM;
1812 gtk_toolbar_reconfigured (GtkToolbar *toolbar)
1814 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1817 items = priv->items;
1820 GtkToolItem *item = GTK_TOOL_ITEM (items->data);
1822 _gtk_tool_item_toolbar_reconfigured (item);
1824 items = items->next;
1829 gtk_toolbar_real_orientation_changed (GtkToolbar *toolbar,
1830 GtkOrientation orientation)
1832 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1833 if (toolbar->orientation != orientation)
1835 toolbar->orientation = orientation;
1837 if (orientation == GTK_ORIENTATION_HORIZONTAL)
1838 gtk_arrow_set (GTK_ARROW (priv->arrow), GTK_ARROW_DOWN, GTK_SHADOW_NONE);
1839 else if (gtk_widget_get_direction (GTK_WIDGET (toolbar)) == GTK_TEXT_DIR_LTR)
1840 gtk_arrow_set (GTK_ARROW (priv->arrow), GTK_ARROW_RIGHT, GTK_SHADOW_NONE);
1842 gtk_arrow_set (GTK_ARROW (priv->arrow), GTK_ARROW_LEFT, GTK_SHADOW_NONE);
1844 gtk_toolbar_reconfigured (toolbar);
1846 gtk_widget_queue_resize (GTK_WIDGET (toolbar));
1847 g_object_notify (G_OBJECT (toolbar), "orientation");
1852 gtk_toolbar_real_style_changed (GtkToolbar *toolbar,
1853 GtkToolbarStyle style)
1855 if (toolbar->style != style)
1857 toolbar->style = style;
1859 gtk_toolbar_reconfigured (toolbar);
1861 gtk_widget_queue_resize (GTK_WIDGET (toolbar));
1862 g_object_notify (G_OBJECT (toolbar), "toolbar_style");
1867 menu_position_func (GtkMenu *menu,
1873 GtkToolbar *toolbar = GTK_TOOLBAR (user_data);
1874 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1876 GtkRequisition menu_req;
1878 gdk_window_get_origin (GTK_BUTTON (priv->arrow_button)->event_window, x, y);
1879 gtk_widget_size_request (priv->arrow_button, &req);
1880 gtk_widget_size_request (GTK_WIDGET (menu), &menu_req);
1882 if (toolbar->orientation == GTK_ORIENTATION_HORIZONTAL)
1884 *y += priv->arrow_button->allocation.height;
1885 if (gtk_widget_get_direction (GTK_WIDGET (toolbar)) == GTK_TEXT_DIR_LTR)
1886 *x += priv->arrow_button->allocation.width - req.width;
1888 *x += req.width - menu_req.width;
1892 if (gtk_widget_get_direction (GTK_WIDGET (toolbar)) == GTK_TEXT_DIR_LTR)
1893 *x += priv->arrow_button->allocation.width;
1895 *x -= menu_req.width;
1896 *y += priv->arrow_button->allocation.height - req.height;
1903 menu_deactivated (GtkWidget *menu,
1904 GtkToolbar *toolbar)
1906 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1908 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (priv->arrow_button), FALSE);
1912 remove_item (GtkWidget *menu_item,
1915 gtk_container_remove (GTK_CONTAINER (menu_item->parent), menu_item);
1919 show_menu (GtkToolbar *toolbar,
1920 GdkEventButton *event)
1922 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1927 gtk_container_foreach (GTK_CONTAINER (priv->menu), remove_item, NULL);
1928 gtk_widget_destroy (GTK_WIDGET (priv->menu));
1931 priv->menu = GTK_MENU (gtk_menu_new ());
1932 g_signal_connect (priv->menu, "deactivate", G_CALLBACK (menu_deactivated), toolbar);
1934 for (list = priv->items; list != NULL; list = list->next)
1936 GtkToolItem *item = list->data;
1938 if (toolbar_item_visible (toolbar, item) && toolbar_item_get_is_overflow (item))
1940 GtkWidget *menu_item = gtk_tool_item_retrieve_proxy_menu_item (item);
1944 g_assert (GTK_IS_MENU_ITEM (menu_item));
1945 gtk_menu_shell_append (GTK_MENU_SHELL (priv->menu), menu_item);
1950 gtk_widget_show_all (GTK_WIDGET (priv->menu));
1952 gtk_menu_popup (GTK_MENU (priv->menu), NULL, NULL,
1953 menu_position_func, toolbar,
1954 event? event->button : 0, event? event->time : gtk_get_current_event_time());
1958 gtk_toolbar_arrow_button_clicked (GtkWidget *button,
1959 GtkToolbar *toolbar)
1961 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
1963 if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (priv->arrow_button)) &&
1964 (!priv->menu || !GTK_WIDGET_VISIBLE (GTK_WIDGET (priv->menu))))
1966 /* We only get here when the button is clicked with the keybaord,
1967 * because mouse button presses result in the menu being shown so
1968 * that priv->menu would be non-NULL and visible.
1970 show_menu (toolbar, NULL);
1971 gtk_menu_shell_select_first (GTK_MENU_SHELL (priv->menu), FALSE);
1976 gtk_toolbar_arrow_button_press (GtkWidget *button,
1977 GdkEventButton *event,
1978 GtkToolbar *toolbar)
1980 show_menu (toolbar, event);
1981 gtk_toggle_button_set_active (GTK_TOGGLE_BUTTON (button), TRUE);
1987 gtk_toolbar_button_press (GtkWidget *toolbar,
1988 GdkEventButton *event)
1990 if (event->button == 3)
1992 gboolean return_value;
1994 g_signal_emit (toolbar, toolbar_signals[POPUP_CONTEXT_MENU], 0,
1995 (int)event->x_root, (int)event->y_root, event->button,
1998 return return_value;
2005 gtk_toolbar_popup_menu (GtkWidget *toolbar)
2007 gboolean return_value;
2008 /* This function is the handler for the "popup menu" keybinding,
2009 * ie., it is called when the user presses Shift F10
2011 g_signal_emit (toolbar, toolbar_signals[POPUP_CONTEXT_MENU], 0,
2012 -1, -1, -1, &return_value);
2014 return return_value;
2018 gtk_toolbar_update_button_relief (GtkToolbar *toolbar)
2020 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2022 gtk_toolbar_reconfigured (toolbar);
2024 gtk_button_set_relief (GTK_BUTTON (priv->arrow_button), get_button_relief (toolbar));
2027 static GtkReliefStyle
2028 get_button_relief (GtkToolbar *toolbar)
2030 GtkReliefStyle button_relief = GTK_RELIEF_NORMAL;
2032 gtk_widget_ensure_style (GTK_WIDGET (toolbar));
2034 gtk_widget_style_get (GTK_WIDGET (toolbar),
2035 "button_relief", &button_relief,
2038 return button_relief;
2042 get_internal_padding (GtkToolbar *toolbar)
2046 gtk_widget_style_get (GTK_WIDGET (toolbar),
2047 "internal_padding", &ipadding,
2053 static GtkShadowType
2054 get_shadow_type (GtkToolbar *toolbar)
2056 GtkShadowType shadow_type;
2058 gtk_widget_style_get (GTK_WIDGET (toolbar),
2059 "shadow_type", &shadow_type,
2066 gtk_toolbar_check_old_api (GtkToolbar *toolbar)
2068 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2070 if (priv->api_mode == NEW_API)
2072 g_warning ("mixing deprecated and non-deprecated GtkToolbar API is not allowed");
2076 priv->api_mode = OLD_API;
2081 gtk_toolbar_check_new_api (GtkToolbar *toolbar)
2083 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2085 if (priv->api_mode == OLD_API)
2087 g_warning ("mixing deprecated and non-deprecated GtkToolbar API is not allowed");
2091 priv->api_mode = NEW_API;
2096 gtk_toolbar_insert_tool_item (GtkToolbar *toolbar,
2100 GtkToolbarPrivate *priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2102 priv->items = g_list_insert (priv->items, item, pos);
2103 toolbar->num_children++;
2105 gtk_widget_set_parent (GTK_WIDGET (item), GTK_WIDGET (toolbar));
2109 gtk_toolbar_remove_tool_item (GtkToolbar *toolbar,
2112 GtkToolbarPrivate *priv;
2116 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2117 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2118 g_return_if_fail (GTK_IS_TOOL_ITEM (item));
2119 g_return_if_fail (g_list_find (priv->items, item));
2123 for (tmp = priv->items; tmp != NULL; tmp = tmp->next)
2125 if (tmp->data == item)
2131 priv->items = g_list_remove (priv->items, item);
2133 gtk_widget_unparent (GTK_WIDGET (item));
2135 if (priv->api_mode == OLD_API)
2137 GtkToolbarChild *toolbar_child;
2139 toolbar_child = g_list_nth_data (toolbar->children, nth_child);
2140 toolbar->children = g_list_remove (toolbar->children, toolbar_child);
2142 g_free (toolbar_child);
2145 gtk_widget_queue_resize (GTK_WIDGET (toolbar));
2151 * Creates a new toolbar.
2153 * Return Value: the newly-created toolbar.
2156 gtk_toolbar_new (void)
2158 GtkToolbar *toolbar;
2160 toolbar = g_object_new (GTK_TYPE_TOOLBAR, NULL);
2162 return GTK_WIDGET (toolbar);
2166 gtk_toolbar_insert (GtkToolbar *toolbar,
2170 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2171 g_return_if_fail (GTK_IS_TOOL_ITEM (item));
2173 if (!gtk_toolbar_check_new_api (toolbar))
2176 gtk_toolbar_insert_tool_item (toolbar, item, pos);
2180 gtk_toolbar_get_item_index (GtkToolbar *toolbar,
2183 GtkToolbarPrivate *priv;
2185 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), -1);
2186 g_return_val_if_fail (GTK_IS_TOOL_ITEM (item), -1);
2188 if (!gtk_toolbar_check_new_api (toolbar))
2191 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2192 g_return_val_if_fail (g_list_find (priv->items, item) != NULL, -1);
2194 return g_list_index (priv->items, item);
2198 * gtk_toolbar_set_orientation:
2199 * @toolbar: a #GtkToolbar.
2200 * @orientation: a new #GtkOrientation.
2202 * Sets whether a toolbar should appear horizontally or vertically.
2205 gtk_toolbar_set_orientation (GtkToolbar *toolbar,
2206 GtkOrientation orientation)
2208 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2210 g_signal_emit (toolbar, toolbar_signals[ORIENTATION_CHANGED], 0, orientation);
2214 * gtk_toolbar_get_orientation:
2215 * @toolbar: a #GtkToolbar
2217 * Retrieves the current orientation of the toolbar. See
2218 * gtk_toolbar_set_orientation().
2220 * Return value: the orientation
2223 gtk_toolbar_get_orientation (GtkToolbar *toolbar)
2225 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), GTK_ORIENTATION_HORIZONTAL);
2227 return toolbar->orientation;
2231 * gtk_toolbar_set_style:
2232 * @toolbar: a #GtkToolbar.
2233 * @style: the new style for @toolbar.
2235 * Alters the view of @toolbar to display either icons only, text only, or both.
2238 gtk_toolbar_set_style (GtkToolbar *toolbar,
2239 GtkToolbarStyle style)
2241 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2243 toolbar->style_set = TRUE;
2244 g_signal_emit (toolbar, toolbar_signals[STYLE_CHANGED], 0, style);
2250 * gtk_toolbar_get_style:
2251 * @toolbar: a #GtkToolbar
2253 * Retrieves whether the toolbar has text, icons, or both . See
2254 * gtk_toolbar_set_style().
2256 * Return value: the current style of @toolbar
2259 gtk_toolbar_get_style (GtkToolbar *toolbar)
2261 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), DEFAULT_TOOLBAR_STYLE);
2263 return toolbar->style;
2267 * gtk_toolbar_unset_style:
2268 * @toolbar: a #GtkToolbar
2270 * Unsets a toolbar style set with gtk_toolbar_set_style(), so that
2271 * user preferences will be used to determine the toolbar style.
2274 gtk_toolbar_unset_style (GtkToolbar *toolbar)
2276 GtkToolbarStyle style;
2278 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2280 if (toolbar->style_set)
2282 GtkSettings *settings = toolbar_get_settings (toolbar);
2285 g_object_get (settings,
2286 "gtk-toolbar-style", &style,
2289 style = DEFAULT_TOOLBAR_STYLE;
2291 if (style != toolbar->style)
2292 g_signal_emit (toolbar, toolbar_signals[STYLE_CHANGED], 0, style);
2294 toolbar->style_set = FALSE;
2299 * gtk_toolbar_set_tooltips:
2300 * @toolbar: a #GtkToolbar.
2301 * @enable: set to %FALSE to disable the tooltips, or %TRUE to enable them.
2303 * Sets if the tooltips of a toolbar should be active or not.
2306 gtk_toolbar_set_tooltips (GtkToolbar *toolbar,
2309 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2312 gtk_tooltips_enable (toolbar->tooltips);
2314 gtk_tooltips_disable (toolbar->tooltips);
2318 * gtk_toolbar_get_tooltips:
2319 * @toolbar: a #GtkToolbar
2321 * Retrieves whether tooltips are enabled. See
2322 * gtk_toolbar_set_tooltips().
2324 * Return value: %TRUE if tooltips are enabled
2327 gtk_toolbar_get_tooltips (GtkToolbar *toolbar)
2329 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), FALSE);
2331 return toolbar->tooltips->enabled;
2335 gtk_toolbar_get_n_items (GtkToolbar *toolbar)
2337 GtkToolbarPrivate *priv;
2339 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), -1);
2341 if (!gtk_toolbar_check_new_api (toolbar))
2344 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2346 return g_list_length (priv->items);
2350 * returns NULL if n is out of range
2353 gtk_toolbar_get_nth_item (GtkToolbar *toolbar,
2356 GtkToolbarPrivate *priv;
2358 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), NULL);
2360 if (!gtk_toolbar_check_new_api (toolbar))
2363 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2365 return g_list_nth_data (priv->items, n);
2369 * gtk_toolbar_set_icon_size:
2370 * @toolbar: A #GtkToolbar
2371 * @icon_size: The #GtkIconSize that stock icons in the toolbar shall have.
2373 * This function sets the size of stock icons in the toolbar. You
2374 * can call it both before you add the icons and after they've been
2375 * added. The size you set will override user preferences for the default
2379 gtk_toolbar_set_icon_size (GtkToolbar *toolbar,
2380 GtkIconSize icon_size)
2382 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2384 toolbar->icon_size_set = TRUE;
2386 if (toolbar->icon_size == icon_size)
2389 toolbar->icon_size = icon_size;
2391 gtk_toolbar_reconfigured (toolbar);
2393 gtk_widget_queue_resize (GTK_WIDGET (toolbar));
2397 * gtk_toolbar_get_icon_size:
2398 * @toolbar: a #GtkToolbar
2400 * Retrieves the icon size fo the toolbar. See gtk_toolbar_set_icon_size().
2402 * Return value: the current icon size for the icons on the toolbar.
2405 gtk_toolbar_get_icon_size (GtkToolbar *toolbar)
2407 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), DEFAULT_ICON_SIZE);
2409 return toolbar->icon_size;
2413 gtk_toolbar_get_relief_style (GtkToolbar *toolbar)
2415 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), GTK_RELIEF_NONE);
2417 return get_button_relief (toolbar);
2421 * gtk_toolbar_unset_icon_size:
2422 * @toolbar: a #GtkToolbar
2424 * Unsets toolbar icon size set with gtk_toolbar_set_icon_size(), so that
2425 * user preferences will be used to determine the icon size.
2428 gtk_toolbar_unset_icon_size (GtkToolbar *toolbar)
2432 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2434 if (toolbar->icon_size_set)
2436 GtkSettings *settings = toolbar_get_settings (toolbar);
2440 g_object_get (settings,
2441 "gtk-toolbar-icon-size", &size,
2445 size = DEFAULT_ICON_SIZE;
2447 if (size != toolbar->icon_size)
2448 gtk_toolbar_set_icon_size (toolbar, size);
2450 toolbar->icon_size_set = FALSE;
2455 gtk_toolbar_set_show_arrow (GtkToolbar *toolbar,
2456 gboolean show_arrow)
2458 GtkToolbarPrivate *priv;
2460 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2462 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2463 show_arrow = show_arrow != FALSE;
2465 if (priv->show_arrow != show_arrow)
2467 priv->show_arrow = show_arrow;
2469 if (!priv->show_arrow)
2470 gtk_widget_hide (priv->arrow_button);
2472 gtk_widget_queue_resize (GTK_WIDGET (toolbar));
2473 g_object_notify (G_OBJECT (toolbar), "show_arrow");
2478 gtk_toolbar_get_show_arrow (GtkToolbar *toolbar)
2480 GtkToolbarPrivate *priv;
2482 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), FALSE);
2484 if (!gtk_toolbar_check_new_api (toolbar))
2487 priv = GTK_TOOLBAR_GET_PRIVATE (toolbar);
2489 return priv->show_arrow;
2493 gtk_toolbar_get_drop_index (GtkToolbar *toolbar,
2497 gint drop_index, drop_pos;
2499 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), FALSE);
2501 if (!gtk_toolbar_check_new_api (toolbar))
2504 find_drop_pos (toolbar, x, y, &drop_index, &drop_pos);
2510 * gtk_toolbar_append_item:
2511 * @toolbar: a #GtkToolbar.
2512 * @text: give your toolbar button a label.
2513 * @tooltip_text: a string that appears when the user holds the mouse over this item.
2514 * @tooltip_private_text: use with #GtkTipsQuery.
2515 * @icon: a #GtkWidget that should be used as the button's icon.
2516 * @callback: the function to be executed when the button is pressed.
2517 * @user_data: a pointer to any data you wish to be passed to the callback.
2519 * Inserts a new item into the toolbar. You must specify the position
2520 * in the toolbar where it will be inserted.
2522 * Return value: the new toolbar item as a #GtkWidget.
2525 gtk_toolbar_append_item (GtkToolbar *toolbar,
2527 const char *tooltip_text,
2528 const char *tooltip_private_text,
2530 GtkSignalFunc callback,
2533 return gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_BUTTON,
2535 tooltip_text, tooltip_private_text,
2536 icon, callback, user_data,
2537 toolbar->num_children);
2541 * gtk_toolbar_prepend_item:
2542 * @toolbar: a #GtkToolbar.
2543 * @text: give your toolbar button a label.
2544 * @tooltip_text: a string that appears when the user holds the mouse over this item.
2545 * @tooltip_private_text: use with #GtkTipsQuery.
2546 * @icon: a #GtkWidget that should be used as the button's icon.
2547 * @callback: the function to be executed when the button is pressed.
2548 * @user_data: a pointer to any data you wish to be passed to the callback.
2550 * Adds a new button to the beginning (top or left edges) of the given toolbar.
2552 * Return value: the new toolbar item as a #GtkWidget.
2555 gtk_toolbar_prepend_item (GtkToolbar *toolbar,
2557 const char *tooltip_text,
2558 const char *tooltip_private_text,
2560 GtkSignalFunc callback,
2563 return gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_BUTTON,
2565 tooltip_text, tooltip_private_text,
2566 icon, callback, user_data,
2571 * gtk_toolbar_insert_item:
2572 * @toolbar: a #GtkToolbar.
2573 * @text: give your toolbar button a label.
2574 * @tooltip_text: a string that appears when the user holds the mouse over this item.
2575 * @tooltip_private_text: use with #GtkTipsQuery.
2576 * @icon: a #GtkWidget that should be used as the button's icon.
2577 * @callback: the function to be executed when the button is pressed.
2578 * @user_data: a pointer to any data you wish to be passed to the callback.
2579 * @position: the number of widgets to insert this item after.
2581 * Inserts a new item into the toolbar. You must specify the position in the
2582 * toolbar where it will be inserted.
2584 * Return value: the new toolbar item as a #GtkWidget.
2587 gtk_toolbar_insert_item (GtkToolbar *toolbar,
2589 const char *tooltip_text,
2590 const char *tooltip_private_text,
2592 GtkSignalFunc callback,
2596 return gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_BUTTON,
2598 tooltip_text, tooltip_private_text,
2599 icon, callback, user_data,
2604 * gtk_toolbar_insert_stock:
2605 * @toolbar: A #GtkToolbar
2606 * @stock_id: The id of the stock item you want to insert
2607 * @tooltip_text: The text in the tooltip of the toolbar button
2608 * @tooltip_private_text: The private text of the tooltip
2609 * @callback: The callback called when the toolbar button is clicked.
2610 * @user_data: user data passed to callback
2611 * @position: The position the button shall be inserted at.
2612 * -1 means at the end.
2614 * Inserts a stock item at the specified position of the toolbar. If
2615 * @stock_id is not a known stock item ID, it's inserted verbatim,
2616 * except that underscores used to mark mnemonics are removed.
2618 * Returns: the inserted widget
2621 gtk_toolbar_insert_stock (GtkToolbar *toolbar,
2622 const gchar *stock_id,
2623 const char *tooltip_text,
2624 const char *tooltip_private_text,
2625 GtkSignalFunc callback,
2629 return gtk_toolbar_internal_insert_element (toolbar, GTK_TOOLBAR_CHILD_BUTTON,
2631 tooltip_text, tooltip_private_text,
2632 NULL, callback, user_data,
2637 * gtk_toolbar_append_space:
2638 * @toolbar: a #GtkToolbar.
2640 * Adds a new space to the end of the toolbar.
2643 gtk_toolbar_append_space (GtkToolbar *toolbar)
2645 gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_SPACE,
2649 toolbar->num_children);
2653 * gtk_toolbar_prepend_space:
2654 * @toolbar: a #GtkToolbar.
2656 * Adds a new space to the beginning of the toolbar.
2659 gtk_toolbar_prepend_space (GtkToolbar *toolbar)
2661 gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_SPACE,
2669 * gtk_toolbar_insert_space:
2670 * @toolbar: a #GtkToolbar
2671 * @position: the number of widgets after which a space should be inserted.
2673 * Inserts a new space in the toolbar at the specified position.
2676 gtk_toolbar_insert_space (GtkToolbar *toolbar,
2679 gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_SPACE,
2687 * gtk_toolbar_remove_space:
2688 * @toolbar: a #GtkToolbar.
2689 * @position: the index of the space to remove.
2691 * Removes a space from the specified position.
2694 gtk_toolbar_remove_space (GtkToolbar *toolbar,
2699 g_return_if_fail (GTK_IS_TOOLBAR (toolbar));
2701 if (!gtk_toolbar_check_old_api (toolbar))
2704 item = g_list_nth_data (toolbar->children, position);
2708 g_warning ("Toolbar position %d doesn't exist", position);
2712 if (!GTK_IS_SEPARATOR_TOOL_ITEM (item))
2714 g_warning ("Toolbar position %d is not a space", position);
2718 gtk_toolbar_remove_tool_item (toolbar, item);
2722 * gtk_toolbar_append_widget:
2723 * @toolbar: a #GtkToolbar.
2724 * @widget: a #GtkWidget to add to the toolbar.
2725 * @tooltip_text: the element's tooltip.
2726 * @tooltip_private_text: used for context-sensitive help about this toolbar element.
2728 * Adds a widget to the end of the given toolbar.
2731 gtk_toolbar_append_widget (GtkToolbar *toolbar,
2733 const gchar *tooltip_text,
2734 const gchar *tooltip_private_text)
2736 gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_WIDGET,
2738 tooltip_text, tooltip_private_text,
2740 toolbar->num_children);
2744 * gtk_toolbar_prepend_widget:
2745 * @toolbar: a #GtkToolbar.
2746 * @widget: a #GtkWidget to add to the toolbar.
2747 * @tooltip_text: the element's tooltip.
2748 * @tooltip_private_text: used for context-sensitive help about this toolbar element.
2750 * Adds a widget to the beginning of the given toolbar.
2753 gtk_toolbar_prepend_widget (GtkToolbar *toolbar,
2755 const gchar *tooltip_text,
2756 const gchar *tooltip_private_text)
2758 gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_WIDGET,
2760 tooltip_text, tooltip_private_text,
2766 * gtk_toolbar_insert_widget:
2767 * @toolbar: a #GtkToolbar.
2768 * @widget: a #GtkWidget to add to the toolbar.
2769 * @tooltip_text: the element's tooltip.
2770 * @tooltip_private_text: used for context-sensitive help about this toolbar element.
2771 * @position: the number of widgets to insert this widget after.
2773 * Inserts a widget in the toolbar at the given position.
2776 gtk_toolbar_insert_widget (GtkToolbar *toolbar,
2778 const char *tooltip_text,
2779 const char *tooltip_private_text,
2782 gtk_toolbar_insert_element (toolbar, GTK_TOOLBAR_CHILD_WIDGET,
2784 tooltip_text, tooltip_private_text,
2790 * gtk_toolbar_append_element:
2791 * @toolbar: a #GtkToolbar.
2792 * @type: a value of type #GtkToolbarChildType that determines what @widget will be.
2793 * @widget: a #GtkWidget, or %NULL.
2794 * @text: the element's label.
2795 * @tooltip_text: the element's tooltip.
2796 * @tooltip_private_text: used for context-sensitive help about this toolbar element.
2797 * @icon: a #GtkWidget that provides pictorial representation of the element's function.
2798 * @callback: the function to be executed when the button is pressed.
2799 * @user_data: any data you wish to pass to the callback.
2801 * Adds a new element to the end of a toolbar.
2803 * If @type == %GTK_TOOLBAR_CHILD_WIDGET, @widget is used as the new element.
2804 * If @type == %GTK_TOOLBAR_CHILD_RADIOBUTTON, @widget is used to determine
2805 * the radio group for the new element. In all other cases, @widget must
2808 * Return value: the new toolbar element as a #GtkWidget.
2811 gtk_toolbar_append_element (GtkToolbar *toolbar,
2812 GtkToolbarChildType type,
2815 const char *tooltip_text,
2816 const char *tooltip_private_text,
2818 GtkSignalFunc callback,
2821 return gtk_toolbar_insert_element (toolbar, type, widget, text,
2822 tooltip_text, tooltip_private_text,
2823 icon, callback, user_data,
2824 toolbar->num_children);
2828 * gtk_toolbar_prepend_element:
2829 * @toolbar: a #GtkToolbar.
2830 * @type: a value of type #GtkToolbarChildType that determines what @widget will be.
2831 * @widget: a #GtkWidget, or %NULL
2832 * @text: the element's label.
2833 * @tooltip_text: the element's tooltip.
2834 * @tooltip_private_text: used for context-sensitive help about this toolbar element.
2835 * @icon: a #GtkWidget that provides pictorial representation of the element's function.
2836 * @callback: the function to be executed when the button is pressed.
2837 * @user_data: any data you wish to pass to the callback.
2839 * Adds a new element to the beginning of a toolbar.
2841 * If @type == %GTK_TOOLBAR_CHILD_WIDGET, @widget is used as the new element.
2842 * If @type == %GTK_TOOLBAR_CHILD_RADIOBUTTON, @widget is used to determine
2843 * the radio group for the new element. In all other cases, @widget must
2846 * Return value: the new toolbar element as a #GtkWidget.
2849 gtk_toolbar_prepend_element (GtkToolbar *toolbar,
2850 GtkToolbarChildType type,
2853 const char *tooltip_text,
2854 const char *tooltip_private_text,
2856 GtkSignalFunc callback,
2859 return gtk_toolbar_insert_element (toolbar, type, widget, text,
2860 tooltip_text, tooltip_private_text,
2861 icon, callback, user_data, 0);
2865 * gtk_toolbar_insert_element:
2866 * @toolbar: a #GtkToolbar.
2867 * @type: a value of type #GtkToolbarChildType that determines what @widget
2869 * @widget: a #GtkWidget, or %NULL.
2870 * @text: the element's label.
2871 * @tooltip_text: the element's tooltip.
2872 * @tooltip_private_text: used for context-sensitive help about this toolbar element.
2873 * @icon: a #GtkWidget that provides pictorial representation of the element's function.
2874 * @callback: the function to be executed when the button is pressed.
2875 * @user_data: any data you wish to pass to the callback.
2876 * @position: the number of widgets to insert this element after.
2878 * Inserts a new element in the toolbar at the given position.
2880 * If @type == %GTK_TOOLBAR_CHILD_WIDGET, @widget is used as the new element.
2881 * If @type == %GTK_TOOLBAR_CHILD_RADIOBUTTON, @widget is used to determine
2882 * the radio group for the new element. In all other cases, @widget must
2885 * Return value: the new toolbar element as a #GtkWidget.
2888 gtk_toolbar_insert_element (GtkToolbar *toolbar,
2889 GtkToolbarChildType type,
2892 const char *tooltip_text,
2893 const char *tooltip_private_text,
2895 GtkSignalFunc callback,
2899 return gtk_toolbar_internal_insert_element (toolbar, type, widget, text,
2900 tooltip_text, tooltip_private_text,
2901 icon, callback, user_data, position, FALSE);
2905 _gtk_toolbar_elide_underscores (const gchar *original)
2909 gboolean last_underscore;
2911 q = result = g_malloc (strlen (original) + 1);
2912 last_underscore = FALSE;
2914 for (p = original; *p; p++)
2916 if (!last_underscore && *p == '_')
2917 last_underscore = TRUE;
2920 last_underscore = FALSE;
2931 gtk_toolbar_internal_insert_element (GtkToolbar *toolbar,
2932 GtkToolbarChildType type,
2935 const char *tooltip_text,
2936 const char *tooltip_private_text,
2938 GtkSignalFunc callback,
2943 GtkToolbarChild *child;
2944 GtkToolItem *item = NULL;
2946 g_return_val_if_fail (GTK_IS_TOOLBAR (toolbar), NULL);
2948 if (!gtk_toolbar_check_old_api (toolbar))
2951 if (type == GTK_TOOLBAR_CHILD_WIDGET)
2952 g_return_val_if_fail (GTK_IS_WIDGET (widget), NULL);
2953 else if (type != GTK_TOOLBAR_CHILD_RADIOBUTTON)
2954 g_return_val_if_fail (widget == NULL, NULL);
2956 child = g_new (GtkToolbarChild, 1);
2960 child->label = NULL;
2964 case GTK_TOOLBAR_CHILD_SPACE:
2965 item = gtk_separator_tool_item_new ();
2966 child->widget = NULL;
2969 case GTK_TOOLBAR_CHILD_WIDGET:
2970 item = gtk_tool_item_new ();
2971 child->widget = widget;
2972 gtk_container_add (GTK_CONTAINER (item), child->widget);
2975 case GTK_TOOLBAR_CHILD_BUTTON:
2976 item = gtk_tool_button_new (NULL, NULL);
2977 child->widget = _gtk_tool_button_get_button (GTK_TOOL_BUTTON (item));
2980 case GTK_TOOLBAR_CHILD_TOGGLEBUTTON:
2981 item = gtk_toggle_tool_button_new ();
2982 child->widget = _gtk_tool_button_get_button (GTK_TOOL_BUTTON (item));
2985 case GTK_TOOLBAR_CHILD_RADIOBUTTON:
2986 item = gtk_radio_tool_button_new (widget
2987 ? gtk_radio_button_get_group (GTK_RADIO_BUTTON (widget))
2989 child->widget = _gtk_tool_button_get_button (GTK_TOOL_BUTTON (item));
2993 gtk_widget_show (GTK_WIDGET (item));
2995 if (type == GTK_TOOLBAR_CHILD_BUTTON ||
2996 type == GTK_TOOLBAR_CHILD_RADIOBUTTON ||
2997 type == GTK_TOOLBAR_CHILD_TOGGLEBUTTON)
3003 GtkStockItem stock_item;
3006 gtk_tool_button_set_stock_id (GTK_TOOL_BUTTON (item), text);
3008 gtk_stock_lookup (text, &stock_item);
3009 label_text = _gtk_toolbar_elide_underscores (stock_item.label);
3010 child->label = GTK_WIDGET (gtk_label_new (label_text));
3011 g_free (label_text);
3015 child->label = gtk_label_new (text);
3017 gtk_tool_button_set_label_widget (GTK_TOOL_BUTTON (item), child->label);
3018 gtk_widget_show (child->label);
3024 gtk_tool_button_set_icon_widget (GTK_TOOL_BUTTON (item), icon);
3026 /* Applications depend on the toolbar showing the widget for them */
3027 gtk_widget_show (GTK_WIDGET (icon));
3031 * We need to connect to the button's clicked callback because some
3032 * programs may rely on that the widget in the callback is a GtkButton
3035 g_signal_connect (child->widget, "clicked",
3036 callback, user_data);
3039 if ((type != GTK_TOOLBAR_CHILD_SPACE) && tooltip_text)
3040 gtk_tool_item_set_tooltip (item, toolbar->tooltips,
3041 tooltip_text, tooltip_private_text);
3043 toolbar->children = g_list_insert (toolbar->children, child, position);
3045 gtk_toolbar_insert_tool_item (toolbar, item, position);
3047 return child->widget;
3051 gtk_toolbar_finalize (GObject *object)
3054 GtkToolbar *toolbar = GTK_TOOLBAR (object);
3056 if (toolbar->tooltips)
3057 g_object_unref (toolbar->tooltips);
3059 for (list = toolbar->children; list != NULL; list = list->next)
3060 g_free (list->data);
3062 g_list_free (toolbar->children);
3064 G_OBJECT_CLASS (parent_class)->finalize (object);