1 /* GtkToolPalette -- A tool palette with categories and DnD support
2 * Copyright (C) 2008 Openismus GmbH
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
25 #include "gtktoolpaletteprivate.h"
30 #include "gtkprivate.h"
34 #define ANIMATION_TIMEOUT 50
35 #define ANIMATION_DURATION (ANIMATION_TIMEOUT * 4)
36 #define DEFAULT_ANIMATION_STATE TRUE
37 #define DEFAULT_EXPANDER_SIZE 16
38 #define DEFAULT_HEADER_SPACING 2
40 #define DEFAULT_LABEL ""
41 #define DEFAULT_COLLAPSED FALSE
42 #define DEFAULT_ELLIPSIZE PANGO_ELLIPSIZE_NONE
45 * SECTION:gtktoolitemgroup
46 * @Short_description: A sub container used in a tool palette
47 * @Title: GtkToolItemGroup
49 * A #GtkToolItemGroup is used together with #GtkToolPalette to add
50 * #GtkToolItem<!-- -->s to a palette like container with different
51 * categories and drag and drop support.
69 CHILD_PROP_HOMOGENEOUS,
76 typedef struct _GtkToolItemGroupChild GtkToolItemGroupChild;
78 struct _GtkToolItemGroupPrivate
81 GtkWidget *label_widget;
86 gint64 animation_start;
87 GSource *animation_timeout;
88 GtkExpanderStyle expander_style;
91 PangoEllipsizeMode ellipsize;
96 GtkSettings *settings;
97 gulong settings_connection;
102 struct _GtkToolItemGroupChild
106 guint homogeneous : 1;
112 static void gtk_tool_item_group_tool_shell_init (GtkToolShellIface *iface);
114 G_DEFINE_TYPE_WITH_CODE (GtkToolItemGroup, gtk_tool_item_group, GTK_TYPE_CONTAINER,
115 G_IMPLEMENT_INTERFACE (GTK_TYPE_TOOL_SHELL, gtk_tool_item_group_tool_shell_init));
118 gtk_tool_item_group_get_alignment (GtkToolItemGroup *group)
120 return gtk_bin_get_child (GTK_BIN (group->priv->header));
123 static GtkOrientation
124 gtk_tool_item_group_get_orientation (GtkToolShell *shell)
126 GtkWidget *parent = gtk_widget_get_parent (GTK_WIDGET (shell));
128 if (GTK_IS_TOOL_PALETTE (parent))
129 return gtk_orientable_get_orientation (GTK_ORIENTABLE (parent));
131 return GTK_ORIENTATION_VERTICAL;
134 static GtkToolbarStyle
135 gtk_tool_item_group_get_style (GtkToolShell *shell)
137 GtkWidget *parent = gtk_widget_get_parent (GTK_WIDGET (shell));
139 if (GTK_IS_TOOL_PALETTE (parent))
140 return gtk_tool_palette_get_style (GTK_TOOL_PALETTE (parent));
142 return GTK_TOOLBAR_ICONS;
146 gtk_tool_item_group_get_icon_size (GtkToolShell *shell)
148 GtkWidget *parent = gtk_widget_get_parent (GTK_WIDGET (shell));
150 if (GTK_IS_TOOL_PALETTE (parent))
151 return gtk_tool_palette_get_icon_size (GTK_TOOL_PALETTE (parent));
153 return GTK_ICON_SIZE_SMALL_TOOLBAR;
156 static PangoEllipsizeMode
157 gtk_tool_item_group_get_ellipsize_mode (GtkToolShell *shell)
159 return GTK_TOOL_ITEM_GROUP (shell)->priv->ellipsize;
163 gtk_tool_item_group_get_text_alignment (GtkToolShell *shell)
165 if (GTK_TOOLBAR_TEXT == gtk_tool_item_group_get_style (shell) ||
166 GTK_TOOLBAR_BOTH_HORIZ == gtk_tool_item_group_get_style (shell))
172 static GtkOrientation
173 gtk_tool_item_group_get_text_orientation (GtkToolShell *shell)
175 return GTK_ORIENTATION_HORIZONTAL;
178 static GtkSizeGroup *
179 gtk_tool_item_group_get_text_size_group (GtkToolShell *shell)
181 GtkWidget *parent = gtk_widget_get_parent (GTK_WIDGET (shell));
183 if (GTK_IS_TOOL_PALETTE (parent))
184 return _gtk_tool_palette_get_size_group (GTK_TOOL_PALETTE (parent));
190 animation_change_notify (GtkToolItemGroup *group)
192 GtkSettings *settings = group->priv->settings;
196 g_object_get (settings,
197 "gtk-enable-animations", &animation,
200 animation = DEFAULT_ANIMATION_STATE;
202 group->priv->animation = animation;
206 gtk_tool_item_group_settings_change_notify (GtkSettings *settings,
207 const GParamSpec *pspec,
208 GtkToolItemGroup *group)
210 if (strcmp (pspec->name, "gtk-enable-animations") == 0)
211 animation_change_notify (group);
215 gtk_tool_item_group_screen_changed (GtkWidget *widget,
216 GdkScreen *previous_screen)
218 GtkToolItemGroup *group = GTK_TOOL_ITEM_GROUP (widget);
219 GtkToolItemGroupPrivate* priv = group->priv;
220 GtkSettings *old_settings = priv->settings;
221 GtkSettings *settings;
223 if (gtk_widget_has_screen (GTK_WIDGET (group)))
224 settings = gtk_widget_get_settings (GTK_WIDGET (group));
228 if (settings == old_settings)
233 g_signal_handler_disconnect (old_settings, priv->settings_connection);
234 g_object_unref (old_settings);
239 priv->settings_connection =
240 g_signal_connect (settings, "notify",
241 G_CALLBACK (gtk_tool_item_group_settings_change_notify),
243 priv->settings = g_object_ref (settings);
246 priv->settings = NULL;
248 animation_change_notify (group);
252 gtk_tool_item_group_tool_shell_init (GtkToolShellIface *iface)
254 iface->get_icon_size = gtk_tool_item_group_get_icon_size;
255 iface->get_orientation = gtk_tool_item_group_get_orientation;
256 iface->get_style = gtk_tool_item_group_get_style;
257 iface->get_text_alignment = gtk_tool_item_group_get_text_alignment;
258 iface->get_text_orientation = gtk_tool_item_group_get_text_orientation;
259 iface->get_text_size_group = gtk_tool_item_group_get_text_size_group;
260 iface->get_ellipsize_mode = gtk_tool_item_group_get_ellipsize_mode;
264 gtk_tool_item_group_header_expose_event_cb (GtkWidget *widget,
265 GdkEventExpose *event,
268 GtkToolItemGroup *group = GTK_TOOL_ITEM_GROUP (data);
269 GtkToolItemGroupPrivate* priv = group->priv;
270 GtkExpanderStyle expander_style;
271 GtkOrientation orientation;
273 GtkTextDirection direction;
275 orientation = gtk_tool_shell_get_orientation (GTK_TOOL_SHELL (group));
276 expander_style = priv->expander_style;
277 direction = gtk_widget_get_direction (widget);
279 if (GTK_ORIENTATION_VERTICAL == orientation)
281 if (GTK_TEXT_DIR_RTL == direction)
282 x = widget->allocation.x + widget->allocation.width - priv->expander_size / 2;
284 x = widget->allocation.x + priv->expander_size / 2;
285 y = widget->allocation.y + widget->allocation.height / 2;
289 x = widget->allocation.x + widget->allocation.width / 2;
290 y = widget->allocation.y + priv->expander_size / 2;
292 /* Unfortunatly gtk_paint_expander() doesn't support rotated drawing
293 * modes. Luckily the following shady arithmetics produce the desired
295 expander_style = GTK_EXPANDER_EXPANDED - expander_style;
298 gtk_paint_expander (widget->style, widget->window,
300 &event->area, GTK_WIDGET (group),
301 "tool-palette-header", x, y,
308 gtk_tool_item_group_header_size_request_cb (GtkWidget *widget,
309 GtkRequisition *requisition,
312 GtkToolItemGroup *group = GTK_TOOL_ITEM_GROUP (data);
313 requisition->height = MAX (requisition->height, group->priv->expander_size);
317 gtk_tool_item_group_header_clicked_cb (GtkButton *button,
320 GtkToolItemGroup *group = GTK_TOOL_ITEM_GROUP (data);
321 GtkToolItemGroupPrivate* priv = group->priv;
322 GtkWidget *parent = gtk_widget_get_parent (data);
324 if (priv->collapsed ||
325 !GTK_IS_TOOL_PALETTE (parent) ||
326 !gtk_tool_palette_get_exclusive (GTK_TOOL_PALETTE (parent), data))
327 gtk_tool_item_group_set_collapsed (group, !priv->collapsed);
331 gtk_tool_item_group_header_adjust_style (GtkToolItemGroup *group)
333 GtkWidget *alignment = gtk_tool_item_group_get_alignment (group);
334 GtkWidget *label_widget = gtk_bin_get_child (GTK_BIN (alignment));
335 GtkWidget *widget = GTK_WIDGET (group);
336 GtkToolItemGroupPrivate* priv = group->priv;
338 GtkTextDirection direction = gtk_widget_get_direction (widget);
340 gtk_widget_style_get (widget,
341 "header-spacing", &(priv->header_spacing),
342 "expander-size", &(priv->expander_size),
345 switch (gtk_tool_shell_get_orientation (GTK_TOOL_SHELL (group)))
347 case GTK_ORIENTATION_HORIZONTAL:
348 dy = priv->header_spacing + priv->expander_size;
350 if (GTK_IS_LABEL (label_widget))
352 gtk_label_set_ellipsize (GTK_LABEL (label_widget), PANGO_ELLIPSIZE_NONE);
353 if (GTK_TEXT_DIR_RTL == direction)
354 gtk_label_set_angle (GTK_LABEL (label_widget), -90);
356 gtk_label_set_angle (GTK_LABEL (label_widget), 90);
360 case GTK_ORIENTATION_VERTICAL:
361 dx = priv->header_spacing + priv->expander_size;
363 if (GTK_IS_LABEL (label_widget))
365 gtk_label_set_ellipsize (GTK_LABEL (label_widget), priv->ellipsize);
366 gtk_label_set_angle (GTK_LABEL (label_widget), 0);
371 gtk_alignment_set_padding (GTK_ALIGNMENT (alignment), dy, 0, dx, 0);
375 gtk_tool_item_group_init (GtkToolItemGroup *group)
377 GtkWidget *alignment;
378 GtkToolItemGroupPrivate* priv;
380 gtk_widget_set_redraw_on_allocate (GTK_WIDGET (group), FALSE);
382 group->priv = priv = G_TYPE_INSTANCE_GET_PRIVATE (group,
383 GTK_TYPE_TOOL_ITEM_GROUP,
384 GtkToolItemGroupPrivate);
386 priv->children = NULL;
387 priv->header_spacing = DEFAULT_HEADER_SPACING;
388 priv->expander_size = DEFAULT_EXPANDER_SIZE;
389 priv->expander_style = GTK_EXPANDER_EXPANDED;
391 priv->label_widget = gtk_label_new (NULL);
392 gtk_misc_set_alignment (GTK_MISC (priv->label_widget), 0.0, 0.5);
393 alignment = gtk_alignment_new (0.5, 0.5, 1.0, 1.0);
394 gtk_container_add (GTK_CONTAINER (alignment), priv->label_widget);
395 gtk_widget_show_all (alignment);
397 gtk_widget_push_composite_child ();
398 priv->header = gtk_button_new ();
399 gtk_widget_set_composite_name (priv->header, "header");
400 gtk_widget_pop_composite_child ();
402 g_object_ref_sink (priv->header);
403 gtk_button_set_focus_on_click (GTK_BUTTON (priv->header), FALSE);
404 gtk_container_add (GTK_CONTAINER (priv->header), alignment);
405 gtk_widget_set_parent (priv->header, GTK_WIDGET (group));
407 gtk_tool_item_group_header_adjust_style (group);
409 g_signal_connect_after (alignment, "expose-event",
410 G_CALLBACK (gtk_tool_item_group_header_expose_event_cb),
412 g_signal_connect_after (alignment, "size-request",
413 G_CALLBACK (gtk_tool_item_group_header_size_request_cb),
416 g_signal_connect (priv->header, "clicked",
417 G_CALLBACK (gtk_tool_item_group_header_clicked_cb),
422 gtk_tool_item_group_set_property (GObject *object,
427 GtkToolItemGroup *group = GTK_TOOL_ITEM_GROUP (object);
432 gtk_tool_item_group_set_label (group, g_value_get_string (value));
435 case PROP_LABEL_WIDGET:
436 gtk_tool_item_group_set_label_widget (group, g_value_get_object (value));
440 gtk_tool_item_group_set_collapsed (group, g_value_get_boolean (value));
444 gtk_tool_item_group_set_ellipsize (group, g_value_get_enum (value));
448 gtk_tool_item_group_set_header_relief (group, g_value_get_enum(value));
452 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
458 gtk_tool_item_group_get_property (GObject *object,
463 GtkToolItemGroup *group = GTK_TOOL_ITEM_GROUP (object);
468 g_value_set_string (value, gtk_tool_item_group_get_label (group));
471 case PROP_LABEL_WIDGET:
472 g_value_set_object (value,
473 gtk_tool_item_group_get_label_widget (group));
477 g_value_set_boolean (value, gtk_tool_item_group_get_collapsed (group));
481 g_value_set_enum (value, gtk_tool_item_group_get_ellipsize (group));
485 g_value_set_enum (value, gtk_tool_item_group_get_header_relief (group));
489 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
495 gtk_tool_item_group_finalize (GObject *object)
497 GtkToolItemGroup *group = GTK_TOOL_ITEM_GROUP (object);
499 if (group->priv->children)
501 g_list_free (group->priv->children);
502 group->priv->children = NULL;
505 G_OBJECT_CLASS (gtk_tool_item_group_parent_class)->finalize (object);
509 gtk_tool_item_group_dispose (GObject *object)
511 GtkToolItemGroup *group = GTK_TOOL_ITEM_GROUP (object);
512 GtkToolItemGroupPrivate* priv = group->priv;
516 /* disconnect focus tracking handler */
517 g_signal_handler_disconnect (priv->toplevel,
520 priv->focus_set_id = 0;
521 priv->toplevel = NULL;
524 G_OBJECT_CLASS (gtk_tool_item_group_parent_class)->dispose (object);
528 gtk_tool_item_group_get_item_size (GtkToolItemGroup *group,
529 GtkRequisition *item_size,
530 gboolean homogeneous_only,
531 gint *requested_rows)
533 GtkWidget *parent = gtk_widget_get_parent (GTK_WIDGET (group));
535 if (GTK_IS_TOOL_PALETTE (parent))
536 _gtk_tool_palette_get_item_size (GTK_TOOL_PALETTE (parent), item_size, homogeneous_only, requested_rows);
538 _gtk_tool_item_group_item_size_request (group, item_size, homogeneous_only, requested_rows);
542 gtk_tool_item_group_size_request (GtkWidget *widget,
543 GtkRequisition *requisition)
545 const gint border_width = GTK_CONTAINER (widget)->border_width;
546 GtkToolItemGroup *group = GTK_TOOL_ITEM_GROUP (widget);
547 GtkToolItemGroupPrivate* priv = group->priv;
548 GtkOrientation orientation;
549 GtkRequisition item_size;
552 if (priv->children && gtk_tool_item_group_get_label_widget (group))
554 gtk_widget_size_request (priv->header, requisition);
555 gtk_widget_show (priv->header);
559 requisition->width = requisition->height = 0;
560 gtk_widget_hide (priv->header);
563 gtk_tool_item_group_get_item_size (group, &item_size, FALSE, &requested_rows);
565 orientation = gtk_tool_shell_get_orientation (GTK_TOOL_SHELL (group));
567 if (GTK_ORIENTATION_VERTICAL == orientation)
568 requisition->width = MAX (requisition->width, item_size.width);
570 requisition->height = MAX (requisition->height, item_size.height * requested_rows);
572 requisition->width += border_width * 2;
573 requisition->height += border_width * 2;
577 gtk_tool_item_group_is_item_visible (GtkToolItemGroup *group,
578 GtkToolItemGroupChild *child)
580 GtkToolbarStyle style;
581 GtkOrientation orientation;
583 orientation = gtk_tool_shell_get_orientation (GTK_TOOL_SHELL (group));
584 style = gtk_tool_shell_get_style (GTK_TOOL_SHELL (group));
586 /* horizontal tool palettes with text style support only homogeneous items */
587 if (!child->homogeneous &&
588 GTK_ORIENTATION_HORIZONTAL == orientation &&
589 GTK_TOOLBAR_TEXT == style)
593 (gtk_widget_get_visible (GTK_WIDGET (child->item))) &&
594 (GTK_ORIENTATION_VERTICAL == orientation ?
595 gtk_tool_item_get_visible_vertical (child->item) :
596 gtk_tool_item_get_visible_horizontal (child->item));
599 static inline unsigned
603 return (x + y - 1) / y;
607 gtk_tool_item_group_real_size_query (GtkWidget *widget,
608 GtkAllocation *allocation,
609 GtkRequisition *inquery)
611 const gint border_width = GTK_CONTAINER (widget)->border_width;
612 GtkToolItemGroup *group = GTK_TOOL_ITEM_GROUP (widget);
613 GtkToolItemGroupPrivate* priv = group->priv;
615 GtkRequisition item_size;
616 GtkAllocation item_area;
618 GtkOrientation orientation;
619 GtkToolbarStyle style;
623 orientation = gtk_tool_shell_get_orientation (GTK_TOOL_SHELL (group));
624 style = gtk_tool_shell_get_style (GTK_TOOL_SHELL (group));
626 /* figure out the size of homogeneous items */
627 gtk_tool_item_group_get_item_size (group, &item_size, TRUE, &min_rows);
629 if (GTK_ORIENTATION_VERTICAL == orientation)
630 item_size.width = MIN (item_size.width, allocation->width);
632 item_size.height = MIN (item_size.height, allocation->height);
635 item_area.height = 0;
637 /* figure out the required columns (n_columns) and rows (n_rows) to place all items */
638 if (!priv->collapsed || !priv->animation || priv->animation_timeout)
644 if (GTK_ORIENTATION_VERTICAL == orientation)
646 gboolean new_row = FALSE;
650 item_area.width = allocation->width - 2 * border_width;
651 n_columns = MAX (item_area.width / item_size.width, 1);
653 /* calculate required rows for n_columns columns */
654 for (it = priv->children; it != NULL; it = it->next)
656 GtkToolItemGroupChild *child = it->data;
658 if (!gtk_tool_item_group_is_item_visible (group, child))
661 if (new_row || child->new_row)
671 if (child->homogeneous)
674 if (col >= n_columns)
679 GtkRequisition req = {0, 0};
682 gtk_widget_size_request (GTK_WIDGET (child->item), &req);
684 width = udiv (req.width, item_size.width);
692 if (col >= n_columns)
700 guint *row_min_width;
702 gboolean new_row = TRUE;
703 guint col = 0, min_col, max_col = 0, all_items = 0;
706 item_area.height = allocation->height - 2 * border_width;
707 n_rows = MAX (item_area.height / item_size.height, min_rows);
709 row_min_width = g_new0 (guint, n_rows);
711 /* calculate minimal and maximal required cols and minimal required rows */
712 for (it = priv->children; it != NULL; it = it->next)
714 GtkToolItemGroupChild *child = it->data;
716 if (!gtk_tool_item_group_is_item_visible (group, child))
719 if (new_row || child->new_row)
724 row_min_width[row] = 1;
730 if (child->homogeneous)
737 GtkRequisition req = {0, 0};
740 gtk_widget_size_request (GTK_WIDGET (child->item), &req);
742 width = udiv (req.width, item_size.width);
747 row_min_width[row] = MAX (row_min_width[row], width);
750 max_col = MAX (max_col, col);
753 /* calculate minimal required cols */
754 min_col = udiv (all_items, n_rows);
756 for (i = 0; i <= row; i++)
758 min_col = MAX (min_col, row_min_width[i]);
761 /* simple linear search for minimal required columns for the given maximal number of rows (n_rows) */
762 for (n_columns = min_col; n_columns < max_col; n_columns ++)
766 /* calculate required rows for n_columns columns */
767 for (it = priv->children; it != NULL; it = it->next)
769 GtkToolItemGroupChild *child = it->data;
771 if (!gtk_tool_item_group_is_item_visible (group, child))
774 if (new_row || child->new_row)
784 if (child->homogeneous)
787 if (col >= n_columns)
792 GtkRequisition req = {0, 0};
795 gtk_widget_size_request (GTK_WIDGET (child->item), &req);
797 width = udiv (req.width, item_size.width);
805 if (col >= n_columns)
815 item_area.width = item_size.width * n_columns;
816 item_area.height = item_size.height * n_rows;
822 /* figure out header widget size */
823 if (gtk_widget_get_visible (priv->header))
825 GtkRequisition child_requisition;
827 gtk_widget_size_request (priv->header, &child_requisition);
829 if (GTK_ORIENTATION_VERTICAL == orientation)
830 inquery->height += child_requisition.height;
832 inquery->width += child_requisition.width;
835 /* report effective widget size */
836 inquery->width += item_area.width + 2 * border_width;
837 inquery->height += item_area.height + 2 * border_width;
841 gtk_tool_item_group_real_size_allocate (GtkWidget *widget,
842 GtkAllocation *allocation)
844 const gint border_width = GTK_CONTAINER (widget)->border_width;
845 GtkToolItemGroup *group = GTK_TOOL_ITEM_GROUP (widget);
846 GtkToolItemGroupPrivate* priv = group->priv;
847 GtkRequisition child_requisition;
848 GtkAllocation child_allocation;
850 GtkRequisition item_size;
851 GtkAllocation item_area;
853 GtkOrientation orientation;
854 GtkToolbarStyle style;
858 gint n_columns, n_rows = 1;
861 GtkTextDirection direction = gtk_widget_get_direction (widget);
863 orientation = gtk_tool_shell_get_orientation (GTK_TOOL_SHELL (group));
864 style = gtk_tool_shell_get_style (GTK_TOOL_SHELL (group));
867 GTK_WIDGET_CLASS (gtk_tool_item_group_parent_class)->size_allocate (widget, allocation);
869 child_allocation.x = border_width;
870 child_allocation.y = border_width;
872 /* place the header widget */
873 if (gtk_widget_get_visible (priv->header))
875 gtk_widget_size_request (priv->header, &child_requisition);
877 if (GTK_ORIENTATION_VERTICAL == orientation)
879 child_allocation.width = allocation->width;
880 child_allocation.height = child_requisition.height;
884 child_allocation.width = child_requisition.width;
885 child_allocation.height = allocation->height;
887 if (GTK_TEXT_DIR_RTL == direction)
888 child_allocation.x = allocation->width - border_width - child_allocation.width;
891 gtk_widget_size_allocate (priv->header, &child_allocation);
893 if (GTK_ORIENTATION_VERTICAL == orientation)
894 child_allocation.y += child_allocation.height;
895 else if (GTK_TEXT_DIR_RTL != direction)
896 child_allocation.x += child_allocation.width;
898 child_allocation.x = border_width;
901 child_requisition.width = child_requisition.height = 0;
903 /* figure out the size of homogeneous items */
904 gtk_tool_item_group_get_item_size (group, &item_size, TRUE, &min_rows);
906 /* figure out the available columns and size of item_area */
907 if (GTK_ORIENTATION_VERTICAL == orientation)
909 item_size.width = MIN (item_size.width, allocation->width);
911 item_area.width = allocation->width - 2 * border_width;
912 item_area.height = allocation->height - 2 * border_width - child_requisition.height;
914 n_columns = MAX (item_area.width / item_size.width, 1);
916 item_size.width = item_area.width / n_columns;
920 item_size.height = MIN (item_size.height, allocation->height);
922 item_area.width = allocation->width - 2 * border_width - child_requisition.width;
923 item_area.height = allocation->height - 2 * border_width;
925 n_columns = MAX (item_area.width / item_size.width, 1);
926 n_rows = MAX (item_area.height / item_size.height, min_rows);
928 item_size.height = item_area.height / n_rows;
931 item_area.x = child_allocation.x;
932 item_area.y = child_allocation.y;
934 /* when expanded or in transition, place the tool items in a grid like layout */
935 if (!priv->collapsed || !priv->animation || priv->animation_timeout)
937 gint col = 0, row = 0;
939 for (it = priv->children; it != NULL; it = it->next)
941 GtkToolItemGroupChild *child = it->data;
944 if (!gtk_tool_item_group_is_item_visible (group, child))
946 gtk_widget_set_child_visible (GTK_WIDGET (child->item), FALSE);
951 /* for non homogeneous widgets request the required size */
952 child_requisition.width = 0;
954 if (!child->homogeneous)
956 gtk_widget_size_request (GTK_WIDGET (child->item), &child_requisition);
957 child_requisition.width = MIN (child_requisition.width, item_area.width);
960 /* select next row if at end of row */
961 if (col > 0 && (child->new_row || (col * item_size.width) + MAX (child_requisition.width, item_size.width) > item_area.width))
965 child_allocation.y += child_allocation.height;
970 /* calculate the position and size of the item */
971 if (!child->homogeneous)
977 col_width = udiv (child_requisition.width, item_size.width);
979 col_width = n_columns - col;
981 width = col_width * item_size.width;
983 if (GTK_TEXT_DIR_RTL == direction)
984 col_child = (n_columns - col - col_width);
988 child_allocation.x = item_area.x + col_child * item_size.width;
989 child_allocation.width = width;
994 (item_area.x + col_child * item_size.width +
995 (width - child_requisition.width) / 2);
996 child_allocation.width = child_requisition.width;
1003 if (GTK_TEXT_DIR_RTL == direction)
1004 col_child = (n_columns - col - 1);
1006 child_allocation.x = item_area.x + col_child * item_size.width;
1007 child_allocation.width = item_size.width;
1012 child_allocation.height = item_size.height;
1014 gtk_widget_size_allocate (GTK_WIDGET (child->item), &child_allocation);
1015 gtk_widget_set_child_visible (GTK_WIDGET (child->item), TRUE);
1018 child_allocation.y += item_size.height;
1021 /* or just hide all items, when collapsed */
1025 for (it = priv->children; it != NULL; it = it->next)
1027 GtkToolItemGroupChild *child = it->data;
1029 gtk_widget_set_child_visible (GTK_WIDGET (child->item), FALSE);
1035 gtk_tool_item_group_size_allocate (GtkWidget *widget,
1036 GtkAllocation *allocation)
1038 gtk_tool_item_group_real_size_allocate (widget, allocation);
1040 if (gtk_widget_get_mapped (widget))
1041 gdk_window_invalidate_rect (widget->window, NULL, FALSE);
1045 gtk_tool_item_group_set_focus_cb (GtkWidget *window,
1049 GtkAdjustment *adjustment;
1052 /* Find this group's parent widget in the focused widget's anchestry. */
1053 for (p = widget; p; p = gtk_widget_get_parent (p))
1056 p = gtk_widget_get_parent (p);
1060 if (GTK_IS_TOOL_PALETTE (p))
1062 /* Check that the focused widgets is fully visible within
1063 * the group's parent widget and make it visible otherwise. */
1065 adjustment = gtk_tool_palette_get_hadjustment (GTK_TOOL_PALETTE (p));
1066 adjustment = gtk_tool_palette_get_vadjustment (GTK_TOOL_PALETTE (p));
1072 /* Handle vertical adjustment. */
1073 if (gtk_widget_translate_coordinates
1074 (widget, p, 0, 0, NULL, &y) && y < 0)
1076 y += adjustment->value;
1077 gtk_adjustment_clamp_page (adjustment, y, y + widget->allocation.height);
1079 else if (gtk_widget_translate_coordinates
1080 (widget, p, 0, widget->allocation.height, NULL, &y) &&
1081 y > p->allocation.height)
1083 y += adjustment->value;
1084 gtk_adjustment_clamp_page (adjustment, y - widget->allocation.height, y);
1088 adjustment = gtk_tool_palette_get_hadjustment (GTK_TOOL_PALETTE (p));
1094 /* Handle horizontal adjustment. */
1095 if (gtk_widget_translate_coordinates
1096 (widget, p, 0, 0, &x, NULL) && x < 0)
1098 x += adjustment->value;
1099 gtk_adjustment_clamp_page (adjustment, x, x + widget->allocation.width);
1101 else if (gtk_widget_translate_coordinates
1102 (widget, p, widget->allocation.width, 0, &x, NULL) &&
1103 x > p->allocation.width)
1105 x += adjustment->value;
1106 gtk_adjustment_clamp_page (adjustment, x - widget->allocation.width, x);
1115 gtk_tool_item_group_set_toplevel_window (GtkToolItemGroup *group,
1116 GtkWidget *toplevel)
1118 GtkToolItemGroupPrivate* priv = group->priv;
1120 if (toplevel != priv->toplevel)
1124 /* Disconnect focus tracking handler. */
1125 g_signal_handler_disconnect (priv->toplevel,
1126 priv->focus_set_id);
1128 priv->focus_set_id = 0;
1129 priv->toplevel = NULL;
1134 /* Install focus tracking handler. We connect to the window's
1135 * set-focus signal instead of connecting to the focus signal of
1138 * 1) Reduce the number of signal handlers used.
1139 * 2) Avoid special handling for group headers.
1140 * 3) Catch focus grabs not only for direct children,
1141 * but also for nested widgets.
1143 priv->focus_set_id =
1144 g_signal_connect (toplevel, "set-focus",
1145 G_CALLBACK (gtk_tool_item_group_set_focus_cb),
1148 priv->toplevel = toplevel;
1154 gtk_tool_item_group_realize (GtkWidget *widget)
1156 GtkWidget *toplevel_window;
1157 const gint border_width = GTK_CONTAINER (widget)->border_width;
1158 gint attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
1159 GdkWindowAttr attributes;
1160 GdkDisplay *display;
1162 attributes.window_type = GDK_WINDOW_CHILD;
1163 attributes.x = widget->allocation.x + border_width;
1164 attributes.y = widget->allocation.y + border_width;
1165 attributes.width = widget->allocation.width - border_width * 2;
1166 attributes.height = widget->allocation.height - border_width * 2;
1167 attributes.wclass = GDK_INPUT_OUTPUT;
1168 attributes.visual = gtk_widget_get_visual (widget);
1169 attributes.colormap = gtk_widget_get_colormap (widget);
1170 attributes.event_mask = gtk_widget_get_events (widget)
1171 | GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK
1172 | GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK
1173 | GDK_BUTTON_MOTION_MASK;
1175 widget->window = gdk_window_new (gtk_widget_get_parent_window (widget),
1176 &attributes, attributes_mask);
1178 display = gdk_drawable_get_display (widget->window);
1180 if (gdk_display_supports_composite (display))
1181 gdk_window_set_composited (widget->window, TRUE);
1183 gdk_window_set_user_data (widget->window, widget);
1184 widget->style = gtk_style_attach (widget->style, widget->window);
1185 gtk_style_set_background (widget->style, widget->window, GTK_STATE_NORMAL);
1186 gtk_widget_set_realized (widget, TRUE);
1188 gtk_container_forall (GTK_CONTAINER (widget),
1189 (GtkCallback) gtk_widget_set_parent_window,
1192 gtk_widget_queue_resize_no_redraw (widget);
1194 toplevel_window = gtk_widget_get_ancestor (widget, GTK_TYPE_WINDOW);
1195 gtk_tool_item_group_set_toplevel_window (GTK_TOOL_ITEM_GROUP (widget),
1200 gtk_tool_item_group_unrealize (GtkWidget *widget)
1202 gtk_tool_item_group_set_toplevel_window (GTK_TOOL_ITEM_GROUP (widget), NULL);
1203 GTK_WIDGET_CLASS (gtk_tool_item_group_parent_class)->unrealize (widget);
1207 gtk_tool_item_group_style_set (GtkWidget *widget,
1208 GtkStyle *previous_style)
1210 gtk_tool_item_group_header_adjust_style (GTK_TOOL_ITEM_GROUP (widget));
1211 GTK_WIDGET_CLASS (gtk_tool_item_group_parent_class)->style_set (widget, previous_style);
1215 gtk_tool_item_group_add (GtkContainer *container,
1218 g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (container));
1219 g_return_if_fail (GTK_IS_TOOL_ITEM (widget));
1221 gtk_tool_item_group_insert (GTK_TOOL_ITEM_GROUP (container),
1222 GTK_TOOL_ITEM (widget), -1);
1226 gtk_tool_item_group_remove (GtkContainer *container,
1229 GtkToolItemGroup *group;
1230 GtkToolItemGroupPrivate* priv;
1233 g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (container));
1234 group = GTK_TOOL_ITEM_GROUP (container);
1237 for (it = priv->children; it != NULL; it = it->next)
1239 GtkToolItemGroupChild *child_info = it->data;
1241 if ((GtkWidget *)child_info->item == child)
1243 g_object_unref (child);
1244 gtk_widget_unparent (child);
1246 g_free (child_info);
1247 priv->children = g_list_delete_link (priv->children, it);
1249 gtk_widget_queue_resize (GTK_WIDGET (container));
1256 gtk_tool_item_group_forall (GtkContainer *container,
1258 GtkCallback callback,
1259 gpointer callback_data)
1261 GtkToolItemGroup *group = GTK_TOOL_ITEM_GROUP (container);
1262 GtkToolItemGroupPrivate* priv = group->priv;
1265 if (internals && priv->header)
1266 callback (priv->header, callback_data);
1268 children = priv->children;
1271 GtkToolItemGroupChild *child = children->data;
1272 children = children->next; /* store pointer before call to callback
1273 because the child pointer is invalid if the
1274 child->item is removed from the item group
1277 callback (GTK_WIDGET (child->item), callback_data);
1282 gtk_tool_item_group_child_type (GtkContainer *container)
1284 return GTK_TYPE_TOOL_ITEM;
1287 static GtkToolItemGroupChild *
1288 gtk_tool_item_group_get_child (GtkToolItemGroup *group,
1296 g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (group), NULL);
1297 g_return_val_if_fail (GTK_IS_TOOL_ITEM (item), NULL);
1299 for (it = group->priv->children, i = 0; it != NULL; it = it->next, ++i)
1301 GtkToolItemGroupChild *child = it->data;
1303 if (child->item == item)
1319 gtk_tool_item_group_get_item_packing (GtkToolItemGroup *group,
1321 gboolean *homogeneous,
1326 GtkToolItemGroupChild *child;
1328 g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
1329 g_return_if_fail (GTK_IS_TOOL_ITEM (item));
1331 child = gtk_tool_item_group_get_child (group, item, NULL, NULL);
1336 *expand = child->expand;
1339 *homogeneous = child->homogeneous;
1342 *fill = child->fill;
1345 *new_row = child->new_row;
1349 gtk_tool_item_group_set_item_packing (GtkToolItemGroup *group,
1351 gboolean homogeneous,
1356 GtkToolItemGroupChild *child;
1357 gboolean changed = FALSE;
1359 g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
1360 g_return_if_fail (GTK_IS_TOOL_ITEM (item));
1362 child = gtk_tool_item_group_get_child (group, item, NULL, NULL);
1366 gtk_widget_freeze_child_notify (GTK_WIDGET (item));
1368 if (child->homogeneous != homogeneous)
1370 child->homogeneous = homogeneous;
1372 gtk_widget_child_notify (GTK_WIDGET (item), "homogeneous");
1374 if (child->expand != expand)
1376 child->expand = expand;
1378 gtk_widget_child_notify (GTK_WIDGET (item), "expand");
1380 if (child->fill != fill)
1384 gtk_widget_child_notify (GTK_WIDGET (item), "fill");
1386 if (child->new_row != new_row)
1388 child->new_row = new_row;
1390 gtk_widget_child_notify (GTK_WIDGET (item), "new-row");
1393 gtk_widget_thaw_child_notify (GTK_WIDGET (item));
1396 && gtk_widget_get_visible (GTK_WIDGET (group))
1397 && gtk_widget_get_visible (GTK_WIDGET (item)))
1398 gtk_widget_queue_resize (GTK_WIDGET (group));
1402 gtk_tool_item_group_set_child_property (GtkContainer *container,
1405 const GValue *value,
1408 GtkToolItemGroup *group = GTK_TOOL_ITEM_GROUP (container);
1409 GtkToolItem *item = GTK_TOOL_ITEM (child);
1410 gboolean homogeneous, expand, fill, new_row;
1412 if (prop_id != CHILD_PROP_POSITION)
1413 gtk_tool_item_group_get_item_packing (group, item,
1421 case CHILD_PROP_HOMOGENEOUS:
1422 gtk_tool_item_group_set_item_packing (group, item,
1423 g_value_get_boolean (value),
1429 case CHILD_PROP_EXPAND:
1430 gtk_tool_item_group_set_item_packing (group, item,
1432 g_value_get_boolean (value),
1437 case CHILD_PROP_FILL:
1438 gtk_tool_item_group_set_item_packing (group, item,
1441 g_value_get_boolean (value),
1445 case CHILD_PROP_NEW_ROW:
1446 gtk_tool_item_group_set_item_packing (group, item,
1450 g_value_get_boolean (value));
1453 case CHILD_PROP_POSITION:
1454 gtk_tool_item_group_set_item_position (group, item, g_value_get_int (value));
1458 GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, prop_id, pspec);
1464 gtk_tool_item_group_get_child_property (GtkContainer *container,
1470 GtkToolItemGroup *group = GTK_TOOL_ITEM_GROUP (container);
1471 GtkToolItem *item = GTK_TOOL_ITEM (child);
1472 gboolean homogeneous, expand, fill, new_row;
1474 if (prop_id != CHILD_PROP_POSITION)
1475 gtk_tool_item_group_get_item_packing (group, item,
1483 case CHILD_PROP_HOMOGENEOUS:
1484 g_value_set_boolean (value, homogeneous);
1487 case CHILD_PROP_EXPAND:
1488 g_value_set_boolean (value, expand);
1491 case CHILD_PROP_FILL:
1492 g_value_set_boolean (value, fill);
1495 case CHILD_PROP_NEW_ROW:
1496 g_value_set_boolean (value, new_row);
1499 case CHILD_PROP_POSITION:
1500 g_value_set_int (value, gtk_tool_item_group_get_item_position (group, item));
1504 GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, prop_id, pspec);
1510 gtk_tool_item_group_class_init (GtkToolItemGroupClass *cls)
1512 GObjectClass *oclass = G_OBJECT_CLASS (cls);
1513 GtkWidgetClass *wclass = GTK_WIDGET_CLASS (cls);
1514 GtkContainerClass *cclass = GTK_CONTAINER_CLASS (cls);
1516 oclass->set_property = gtk_tool_item_group_set_property;
1517 oclass->get_property = gtk_tool_item_group_get_property;
1518 oclass->finalize = gtk_tool_item_group_finalize;
1519 oclass->dispose = gtk_tool_item_group_dispose;
1521 wclass->size_request = gtk_tool_item_group_size_request;
1522 wclass->size_allocate = gtk_tool_item_group_size_allocate;
1523 wclass->realize = gtk_tool_item_group_realize;
1524 wclass->unrealize = gtk_tool_item_group_unrealize;
1525 wclass->style_set = gtk_tool_item_group_style_set;
1526 wclass->screen_changed = gtk_tool_item_group_screen_changed;
1528 cclass->add = gtk_tool_item_group_add;
1529 cclass->remove = gtk_tool_item_group_remove;
1530 cclass->forall = gtk_tool_item_group_forall;
1531 cclass->child_type = gtk_tool_item_group_child_type;
1532 cclass->set_child_property = gtk_tool_item_group_set_child_property;
1533 cclass->get_child_property = gtk_tool_item_group_get_child_property;
1535 g_object_class_install_property (oclass, PROP_LABEL,
1536 g_param_spec_string ("label",
1538 P_("The human-readable title of this item group"),
1540 GTK_PARAM_READWRITE));
1542 g_object_class_install_property (oclass, PROP_LABEL_WIDGET,
1543 g_param_spec_object ("label-widget",
1545 P_("A widget to display in place of the usual label"),
1547 GTK_PARAM_READWRITE));
1549 g_object_class_install_property (oclass, PROP_COLLAPSED,
1550 g_param_spec_boolean ("collapsed",
1552 P_("Wether the group has been collapsed and items are hidden"),
1554 GTK_PARAM_READWRITE));
1556 g_object_class_install_property (oclass, PROP_ELLIPSIZE,
1557 g_param_spec_enum ("ellipsize",
1559 P_("Ellipsize for item group headers"),
1560 PANGO_TYPE_ELLIPSIZE_MODE, DEFAULT_ELLIPSIZE,
1561 GTK_PARAM_READWRITE));
1563 g_object_class_install_property (oclass, PROP_RELIEF,
1564 g_param_spec_enum ("header-relief",
1565 P_("Header Relief"),
1566 P_("Relief of the group header button"),
1567 GTK_TYPE_RELIEF_STYLE, GTK_RELIEF_NORMAL,
1568 GTK_PARAM_READWRITE));
1570 gtk_widget_class_install_style_property (wclass,
1571 g_param_spec_int ("expander-size",
1572 P_("Expander Size"),
1573 P_("Size of the expander arrow"),
1576 DEFAULT_EXPANDER_SIZE,
1577 GTK_PARAM_READABLE));
1579 gtk_widget_class_install_style_property (wclass,
1580 g_param_spec_int ("header-spacing",
1581 P_("Header Spacing"),
1582 P_("Spacing between expander arrow and caption"),
1585 DEFAULT_HEADER_SPACING,
1586 GTK_PARAM_READABLE));
1588 gtk_container_class_install_child_property (cclass, CHILD_PROP_HOMOGENEOUS,
1589 g_param_spec_boolean ("homogeneous",
1591 P_("Whether the item should be the same size as other homogeneous items"),
1593 GTK_PARAM_READWRITE));
1595 gtk_container_class_install_child_property (cclass, CHILD_PROP_EXPAND,
1596 g_param_spec_boolean ("expand",
1598 P_("Whether the item should receive extra space when the group grows"),
1600 GTK_PARAM_READWRITE));
1602 gtk_container_class_install_child_property (cclass, CHILD_PROP_FILL,
1603 g_param_spec_boolean ("fill",
1605 P_("Whether the item should fill the available space"),
1607 GTK_PARAM_READWRITE));
1609 gtk_container_class_install_child_property (cclass, CHILD_PROP_NEW_ROW,
1610 g_param_spec_boolean ("new-row",
1612 P_("Whether the item should start a new row"),
1614 GTK_PARAM_READWRITE));
1616 gtk_container_class_install_child_property (cclass, CHILD_PROP_POSITION,
1617 g_param_spec_int ("position",
1619 P_("Position of the item within this group"),
1623 GTK_PARAM_READWRITE));
1625 g_type_class_add_private (cls, sizeof (GtkToolItemGroupPrivate));
1629 * gtk_tool_item_group_new:
1630 * @label: the label of the new group
1632 * Creates a new tool item group with label @label.
1634 * Returns: a new #GtkToolItemGroup.
1639 gtk_tool_item_group_new (const gchar *label)
1641 return g_object_new (GTK_TYPE_TOOL_ITEM_GROUP, "label", label, NULL);
1645 * gtk_tool_item_group_set_label:
1646 * @group: a #GtkToolItemGroup
1647 * @label: the new human-readable label of of the group
1649 * Sets the label of the tool item group. The label is displayed in the header
1655 gtk_tool_item_group_set_label (GtkToolItemGroup *group,
1658 g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
1661 gtk_tool_item_group_set_label_widget (group, NULL);
1664 GtkWidget *child = gtk_label_new (label);
1665 gtk_widget_show (child);
1667 gtk_tool_item_group_set_label_widget (group, child);
1670 g_object_notify (G_OBJECT (group), "label");
1674 * gtk_tool_item_group_set_label_widget:
1675 * @group: a #GtkToolItemGroup
1676 * @label_widget: the widget to be displayed in place of the usual label
1678 * Sets the label of the tool item group.
1679 * The label widget is displayed in the header of the group, in place
1680 * of the usual label.
1685 gtk_tool_item_group_set_label_widget (GtkToolItemGroup *group,
1686 GtkWidget *label_widget)
1688 GtkToolItemGroupPrivate* priv;
1689 GtkWidget *alignment;
1691 g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
1692 g_return_if_fail (label_widget == NULL || GTK_IS_WIDGET (label_widget));
1693 g_return_if_fail (label_widget == NULL || label_widget->parent == NULL);
1697 if (priv->label_widget == label_widget)
1700 alignment = gtk_tool_item_group_get_alignment (group);
1702 if (priv->label_widget)
1704 gtk_widget_set_state (priv->label_widget, GTK_STATE_NORMAL);
1705 gtk_container_remove (GTK_CONTAINER (alignment), priv->label_widget);
1710 gtk_container_add (GTK_CONTAINER (alignment), label_widget);
1712 priv->label_widget = label_widget;
1714 if (gtk_widget_get_visible (GTK_WIDGET (group)))
1715 gtk_widget_queue_resize (GTK_WIDGET (group));
1717 /* Only show the header widget if the group has children: */
1718 if (label_widget && priv->children)
1719 gtk_widget_show (priv->header);
1721 gtk_widget_hide (priv->header);
1723 g_object_freeze_notify (G_OBJECT (group));
1724 g_object_notify (G_OBJECT (group), "label-widget");
1725 g_object_notify (G_OBJECT (group), "label");
1726 g_object_thaw_notify (G_OBJECT (group));
1730 * gtk_tool_item_group_set_header_relief:
1731 * @group: a #GtkToolItemGroup
1732 * @style: the #GtkReliefStyle
1734 * Set the button relief of the group header.
1735 * See gtk_button_set_relief() for details.
1740 gtk_tool_item_group_set_header_relief (GtkToolItemGroup *group,
1741 GtkReliefStyle style)
1743 g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
1745 gtk_button_set_relief (GTK_BUTTON (group->priv->header), style);
1749 gtk_tool_item_group_get_animation_timestamp (GtkToolItemGroup *group)
1753 g_source_get_current_time (group->priv->animation_timeout, &now);
1754 return (now.tv_sec * G_USEC_PER_SEC + now.tv_usec - group->priv->animation_start) / 1000;
1758 gtk_tool_item_group_force_expose (GtkToolItemGroup *group)
1760 GtkToolItemGroupPrivate* priv = group->priv;
1761 GtkWidget *widget = GTK_WIDGET (group);
1763 if (gtk_widget_get_realized (priv->header))
1765 GtkWidget *alignment = gtk_tool_item_group_get_alignment (group);
1768 /* Find the header button's arrow area... */
1769 area.x = alignment->allocation.x;
1770 area.y = alignment->allocation.y + (alignment->allocation.height - priv->expander_size) / 2;
1771 area.height = priv->expander_size;
1772 area.width = priv->expander_size;
1774 /* ... and invalidated it to get it animated. */
1775 gdk_window_invalidate_rect (priv->header->window, &area, TRUE);
1778 if (gtk_widget_get_realized (widget))
1780 GtkWidget *parent = gtk_widget_get_parent (widget);
1781 int x, y, width, height;
1783 /* Find the tool item area button's arrow area... */
1784 width = widget->allocation.width;
1785 height = widget->allocation.height;
1787 gtk_widget_translate_coordinates (widget, parent, 0, 0, &x, &y);
1789 if (gtk_widget_get_visible (priv->header))
1791 height -= priv->header->allocation.height;
1792 y += priv->header->allocation.height;
1795 /* ... and invalidated it to get it animated. */
1796 gtk_widget_queue_draw_area (parent, x, y, width, height);
1801 gtk_tool_item_group_animation_cb (gpointer data)
1803 GtkToolItemGroup *group = GTK_TOOL_ITEM_GROUP (data);
1804 GtkToolItemGroupPrivate* priv = group->priv;
1805 gint64 timestamp = gtk_tool_item_group_get_animation_timestamp (group);
1808 GDK_THREADS_ENTER ();
1810 /* Enque this early to reduce number of expose events. */
1811 gtk_widget_queue_resize_no_redraw (GTK_WIDGET (group));
1813 /* Figure out current style of the expander arrow. */
1814 if (priv->collapsed)
1816 if (priv->expander_style == GTK_EXPANDER_EXPANDED)
1817 priv->expander_style = GTK_EXPANDER_SEMI_COLLAPSED;
1819 priv->expander_style = GTK_EXPANDER_COLLAPSED;
1823 if (priv->expander_style == GTK_EXPANDER_COLLAPSED)
1824 priv->expander_style = GTK_EXPANDER_SEMI_EXPANDED;
1826 priv->expander_style = GTK_EXPANDER_EXPANDED;
1829 gtk_tool_item_group_force_expose (group);
1831 /* Finish animation when done. */
1832 if (timestamp >= ANIMATION_DURATION)
1833 priv->animation_timeout = NULL;
1835 retval = (priv->animation_timeout != NULL);
1837 GDK_THREADS_LEAVE ();
1843 * gtk_tool_item_group_set_collapsed:
1844 * @group: a #GtkToolItemGroup
1845 * @collapsed: whether the @group should be collapsed or expanded
1847 * Sets whether the @group should be collapsed or expanded.
1852 gtk_tool_item_group_set_collapsed (GtkToolItemGroup *group,
1856 GtkToolItemGroupPrivate* priv;
1858 g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
1862 parent = gtk_widget_get_parent (GTK_WIDGET (group));
1863 if (GTK_IS_TOOL_PALETTE (parent) && !collapsed)
1864 _gtk_tool_palette_set_expanding_child (GTK_TOOL_PALETTE (parent),
1865 GTK_WIDGET (group));
1866 if (collapsed != priv->collapsed)
1868 if (priv->animation)
1872 g_get_current_time (&now);
1874 if (priv->animation_timeout)
1875 g_source_destroy (priv->animation_timeout);
1877 priv->animation_start = (now.tv_sec * G_USEC_PER_SEC + now.tv_usec);
1878 priv->animation_timeout = g_timeout_source_new (ANIMATION_TIMEOUT);
1880 g_source_set_callback (priv->animation_timeout,
1881 gtk_tool_item_group_animation_cb,
1884 g_source_attach (priv->animation_timeout, NULL);
1888 priv->expander_style = GTK_EXPANDER_COLLAPSED;
1889 gtk_tool_item_group_force_expose (group);
1892 priv->collapsed = collapsed;
1893 g_object_notify (G_OBJECT (group), "collapsed");
1898 * gtk_tool_item_group_set_ellipsize:
1899 * @group: a #GtkToolItemGroup
1900 * @ellipsize: the #PangoEllipsizeMode labels in @group should use
1902 * Sets the ellipsization mode which should be used by labels in @group.
1907 gtk_tool_item_group_set_ellipsize (GtkToolItemGroup *group,
1908 PangoEllipsizeMode ellipsize)
1910 g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
1912 if (ellipsize != group->priv->ellipsize)
1914 group->priv->ellipsize = ellipsize;
1915 gtk_tool_item_group_header_adjust_style (group);
1916 g_object_notify (G_OBJECT (group), "ellipsize");
1917 _gtk_tool_item_group_palette_reconfigured (group);
1922 * gtk_tool_item_group_get_label:
1923 * @group: a #GtkToolItemGroup
1925 * Gets the label of @group.
1927 * Returns: the label of @group. The label is an internal string of @group
1928 * and must not be modified. Note that %NULL is returned if a custom
1929 * label has been set with gtk_tool_item_group_set_label_widget()
1933 G_CONST_RETURN gchar*
1934 gtk_tool_item_group_get_label (GtkToolItemGroup *group)
1936 GtkToolItemGroupPrivate *priv;
1938 g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (group), NULL);
1942 if (GTK_IS_LABEL (priv->label_widget))
1943 return gtk_label_get_label (GTK_LABEL (priv->label_widget));
1949 * gtk_tool_item_group_get_label_widget:
1950 * @group: a #GtkToolItemGroup
1952 * Gets the label widget of @group.
1953 * See gtk_tool_item_group_set_label_widget().
1955 * Returns: the label widget of @group
1960 gtk_tool_item_group_get_label_widget (GtkToolItemGroup *group)
1962 GtkWidget *alignment = gtk_tool_item_group_get_alignment (group);
1964 return gtk_bin_get_child (GTK_BIN (alignment));
1968 * gtk_tool_item_group_get_collapsed:
1969 * @group: a GtkToolItemGroup
1971 * Gets whether @group is collapsed or expanded.
1973 * Returns: %TRUE if @group is collapsed, %FALSE if it is expanded
1978 gtk_tool_item_group_get_collapsed (GtkToolItemGroup *group)
1980 g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (group), DEFAULT_COLLAPSED);
1982 return group->priv->collapsed;
1986 * gtk_tool_item_group_get_ellipsize:
1987 * @group: a #GtkToolItemGroup
1989 * Gets the ellipsization mode of @group.
1991 * Returns: the #PangoEllipsizeMode of @group
1996 gtk_tool_item_group_get_ellipsize (GtkToolItemGroup *group)
1998 g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (group), DEFAULT_ELLIPSIZE);
2000 return group->priv->ellipsize;
2004 * gtk_tool_item_group_get_header_relief:
2005 * @group: a #GtkToolItemGroup
2007 * Gets the relief mode of the header button of @group.
2009 * Returns: the #GtkReliefStyle
2014 gtk_tool_item_group_get_header_relief (GtkToolItemGroup *group)
2016 g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (group), GTK_RELIEF_NORMAL);
2018 return gtk_button_get_relief (GTK_BUTTON (group->priv->header));
2022 * gtk_tool_item_group_insert:
2023 * @group: a #GtkToolItemGroup
2024 * @item: the #GtkToolItem to insert into @group
2025 * @position: the position of @item in @group, starting with 0.
2026 * The position -1 means end of list.
2028 * Inserts @item at @position in the list of children of @group.
2033 gtk_tool_item_group_insert (GtkToolItemGroup *group,
2037 GtkWidget *parent, *child_widget;
2038 GtkToolItemGroupChild *child;
2040 g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
2041 g_return_if_fail (GTK_IS_TOOL_ITEM (item));
2042 g_return_if_fail (position >= -1);
2044 parent = gtk_widget_get_parent (GTK_WIDGET (group));
2046 child = g_new (GtkToolItemGroupChild, 1);
2047 child->item = g_object_ref_sink (item);
2048 child->homogeneous = TRUE;
2049 child->expand = FALSE;
2051 child->new_row = FALSE;
2053 group->priv->children = g_list_insert (group->priv->children, child, position);
2055 if (GTK_IS_TOOL_PALETTE (parent))
2056 _gtk_tool_palette_child_set_drag_source (GTK_WIDGET (item), parent);
2058 child_widget = gtk_bin_get_child (GTK_BIN (item));
2060 if (GTK_IS_BUTTON (child_widget))
2061 gtk_button_set_focus_on_click (GTK_BUTTON (child_widget), TRUE);
2063 gtk_widget_set_parent (GTK_WIDGET (item), GTK_WIDGET (group));
2067 * gtk_tool_item_group_set_item_position:
2068 * @group: a #GtkToolItemGroup
2069 * @item: the #GtkToolItem to move to a new position, should
2070 * be a child of @group.
2071 * @position: the new position of @item in @group, starting with 0.
2072 * The position -1 means end of list.
2074 * Sets the position of @item in the list of children of @group.
2079 gtk_tool_item_group_set_item_position (GtkToolItemGroup *group,
2085 GtkToolItemGroupChild *child;
2086 GtkToolItemGroupPrivate* priv;
2088 g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
2089 g_return_if_fail (GTK_IS_TOOL_ITEM (item));
2090 g_return_if_fail (position >= -1);
2092 child = gtk_tool_item_group_get_child (group, item, &old_position, &link);
2095 g_return_if_fail (child != NULL);
2097 if (position == old_position)
2100 priv->children = g_list_delete_link (priv->children, link);
2101 priv->children = g_list_insert (priv->children, child, position);
2103 gtk_widget_child_notify (GTK_WIDGET (item), "position");
2104 if (gtk_widget_get_visible (GTK_WIDGET (group)) &&
2105 gtk_widget_get_visible (GTK_WIDGET (item)))
2106 gtk_widget_queue_resize (GTK_WIDGET (group));
2110 * gtk_tool_item_group_get_item_position:
2111 * @group: a #GtkToolItemGroup
2112 * @item: a #GtkToolItem
2114 * Gets the position of @item in @group as index.
2116 * Returns: the index of @item in @group or -1 if @item is no child of @group
2121 gtk_tool_item_group_get_item_position (GtkToolItemGroup *group,
2126 g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (group), -1);
2127 g_return_val_if_fail (GTK_IS_TOOL_ITEM (item), -1);
2129 if (gtk_tool_item_group_get_child (group, item, &position, NULL))
2136 * gtk_tool_item_group_get_n_items:
2137 * @group: a #GtkToolItemGroup
2139 * Gets the number of tool items in @group.
2141 * Returns: the number of tool items in @group
2146 gtk_tool_item_group_get_n_items (GtkToolItemGroup *group)
2148 g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (group), 0);
2150 return g_list_length (group->priv->children);
2154 * gtk_tool_item_group_get_nth_item:
2155 * @group: a #GtkToolItemGroup
2158 * Gets the tool item at @index in group.
2160 * Returns: the #GtkToolItem at index
2165 gtk_tool_item_group_get_nth_item (GtkToolItemGroup *group,
2168 GtkToolItemGroupChild *child;
2170 g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (group), NULL);
2172 child = g_list_nth_data (group->priv->children, index);
2174 return child != NULL ? child->item : NULL;
2178 * gtk_tool_item_group_get_drop_item:
2179 * @group: a #GtkToolItemGroup
2180 * @x: the x position
2181 * @y: the y position
2183 * Gets the tool item at position (x, y).
2185 * Returns: the #GtkToolItem at position (x, y)
2190 gtk_tool_item_group_get_drop_item (GtkToolItemGroup *group,
2194 GtkAllocation *allocation;
2195 GtkOrientation orientation;
2198 g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (group), NULL);
2200 allocation = >K_WIDGET (group)->allocation;
2201 orientation = gtk_tool_shell_get_orientation (GTK_TOOL_SHELL (group));
2203 g_return_val_if_fail (x >= 0 && x < allocation->width, NULL);
2204 g_return_val_if_fail (y >= 0 && y < allocation->height, NULL);
2206 for (it = group->priv->children; it != NULL; it = it->next)
2208 GtkToolItemGroupChild *child = it->data;
2209 GtkToolItem *item = child->item;
2212 if (!item || !gtk_tool_item_group_is_item_visible (group, child))
2215 allocation = >K_WIDGET (item)->allocation;
2217 x0 = x - allocation->x;
2218 y0 = y - allocation->y;
2220 if (x0 >= 0 && x0 < allocation->width &&
2221 y0 >= 0 && y0 < allocation->height)
2229 _gtk_tool_item_group_item_size_request (GtkToolItemGroup *group,
2230 GtkRequisition *item_size,
2231 gboolean homogeneous_only,
2232 gint *requested_rows)
2234 GtkRequisition child_requisition;
2237 gboolean new_row = TRUE;
2238 GtkOrientation orientation;
2239 GtkToolbarStyle style;
2241 g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
2242 g_return_if_fail (NULL != item_size);
2244 orientation = gtk_tool_shell_get_orientation (GTK_TOOL_SHELL (group));
2245 style = gtk_tool_shell_get_style (GTK_TOOL_SHELL (group));
2247 item_size->width = item_size->height = 0;
2249 for (it = group->priv->children; it != NULL; it = it->next)
2251 GtkToolItemGroupChild *child = it->data;
2253 if (!gtk_tool_item_group_is_item_visible (group, child))
2256 if (child->new_row || new_row)
2262 if (!child->homogeneous && child->expand)
2265 gtk_widget_size_request (GTK_WIDGET (child->item), &child_requisition);
2267 if (!homogeneous_only || child->homogeneous)
2268 item_size->width = MAX (item_size->width, child_requisition.width);
2269 item_size->height = MAX (item_size->height, child_requisition.height);
2273 *requested_rows = rows;
2277 _gtk_tool_item_group_paint (GtkToolItemGroup *group,
2280 GtkWidget *widget = GTK_WIDGET (group);
2281 GtkToolItemGroupPrivate* priv = group->priv;
2283 gdk_cairo_set_source_pixmap (cr, widget->window,
2284 widget->allocation.x,
2285 widget->allocation.y);
2287 if (priv->animation_timeout)
2289 GtkOrientation orientation = gtk_tool_item_group_get_orientation (GTK_TOOL_SHELL (group));
2290 cairo_pattern_t *mask;
2293 if (GTK_ORIENTATION_VERTICAL == orientation)
2294 v1 = widget->allocation.height;
2296 v1 = widget->allocation.width;
2300 if (!gtk_widget_get_visible (priv->header))
2302 else if (GTK_ORIENTATION_VERTICAL == orientation)
2303 v0 = MAX (v0, priv->header->allocation.height);
2305 v0 = MAX (v0, priv->header->allocation.width);
2307 v1 = MIN (v0 + 256, v1);
2309 if (GTK_ORIENTATION_VERTICAL == orientation)
2311 v0 += widget->allocation.y;
2312 v1 += widget->allocation.y;
2314 mask = cairo_pattern_create_linear (0.0, v0, 0.0, v1);
2318 v0 += widget->allocation.x;
2319 v1 += widget->allocation.x;
2321 mask = cairo_pattern_create_linear (v0, 0.0, v1, 0.0);
2324 cairo_pattern_add_color_stop_rgba (mask, 0.00, 0.0, 0.0, 0.0, 1.00);
2325 cairo_pattern_add_color_stop_rgba (mask, 0.25, 0.0, 0.0, 0.0, 0.25);
2326 cairo_pattern_add_color_stop_rgba (mask, 0.50, 0.0, 0.0, 0.0, 0.10);
2327 cairo_pattern_add_color_stop_rgba (mask, 0.75, 0.0, 0.0, 0.0, 0.01);
2328 cairo_pattern_add_color_stop_rgba (mask, 1.00, 0.0, 0.0, 0.0, 0.00);
2330 cairo_mask (cr, mask);
2331 cairo_pattern_destroy (mask);
2338 _gtk_tool_item_group_get_size_for_limit (GtkToolItemGroup *group,
2343 GtkRequisition requisition;
2344 GtkToolItemGroupPrivate* priv = group->priv;
2346 gtk_widget_size_request (GTK_WIDGET (group), &requisition);
2348 if (!priv->collapsed || priv->animation_timeout)
2350 GtkAllocation allocation = { 0, 0, requisition.width, requisition.height };
2351 GtkRequisition inquery;
2354 allocation.width = limit;
2356 allocation.height = limit;
2358 gtk_tool_item_group_real_size_query (GTK_WIDGET (group),
2359 &allocation, &inquery);
2362 inquery.height -= requisition.height;
2364 inquery.width -= requisition.width;
2366 if (priv->animation_timeout && animation)
2368 gint64 timestamp = gtk_tool_item_group_get_animation_timestamp (group);
2370 timestamp = MIN (timestamp, ANIMATION_DURATION);
2372 if (priv->collapsed)
2373 timestamp = ANIMATION_DURATION - timestamp;
2377 inquery.height *= timestamp;
2378 inquery.height /= ANIMATION_DURATION;
2382 inquery.width *= timestamp;
2383 inquery.width /= ANIMATION_DURATION;
2388 requisition.height += inquery.height;
2390 requisition.width += inquery.width;
2393 return (vertical ? requisition.height : requisition.width);
2397 _gtk_tool_item_group_get_height_for_width (GtkToolItemGroup *group,
2400 return _gtk_tool_item_group_get_size_for_limit (group, width, TRUE, group->priv->animation);
2404 _gtk_tool_item_group_get_width_for_height (GtkToolItemGroup *group,
2407 return _gtk_tool_item_group_get_size_for_limit (group, height, FALSE, TRUE);
2411 gtk_tool_palette_reconfigured_foreach_item (GtkWidget *child,
2414 if (GTK_IS_TOOL_ITEM (child))
2415 gtk_tool_item_toolbar_reconfigured (GTK_TOOL_ITEM (child));
2420 _gtk_tool_item_group_palette_reconfigured (GtkToolItemGroup *group)
2422 gtk_container_foreach (GTK_CONTAINER (group),
2423 gtk_tool_palette_reconfigured_foreach_item,
2426 gtk_tool_item_group_header_adjust_style (group);
2430 #define __GTK_TOOL_ITEM_GROUP_C__
2431 #include "gtkaliasdef.c"