Pileus Git - ~andy/gtk/blob - gtk/gtktoolpalette.c

   1 /* GtkToolPalette -- A tool palette with categories and DnD support
   2  * Copyright (C) 2008  Openismus GmbH
   3  *
   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.
   8  *
   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.
  13  *
  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
  17  *
  18  * Authors:
  19  *      Mathias Hasselmann
  20  */
  21
  22 #include "config.h"
  23
  24 #include <string.h>
  25 #include <gtk/gtk.h>
  26
  27 #include "gtktoolpaletteprivate.h"
  28 #include "gtkmarshalers.h"
  29
  30 #include "gtkprivate.h"
  31 #include "gtkintl.h"
  32 #include "gtkalias.h"
  33
  34 #define DEFAULT_ICON_SIZE       GTK_ICON_SIZE_SMALL_TOOLBAR
  35 #define DEFAULT_ORIENTATION     GTK_ORIENTATION_VERTICAL
  36 #define DEFAULT_TOOLBAR_STYLE   GTK_TOOLBAR_ICONS
  37
  38 #define DEFAULT_CHILD_EXCLUSIVE FALSE
  39 #define DEFAULT_CHILD_EXPAND    FALSE
  40
  41 /**
  42  * SECTION:gtktoolpalette
  43  * @Short_description: A tool palette with categories
  44  * @Title: GtkToolPalette
  45  *
  46  * A #GtkToolPalette allows it to add #GtkToolItem<!-- -->s to a palette-like
  47  * container with different categories and drag and drop support.
  48  *
  49  * A #GtkToolPalette is created with a call to gtk_tool_palette_new().
  50  *
  51  * #GtkToolItem<!-- -->s cannot be added directly to a #GtkToolPalette,
  52  * instead they are added to a #GtkToolItemGroup which can than be added
  53  * to a #GtkToolPalette. To add a #GtkToolItemGroup to a #GtkToolPalette,
  54  * use gtk_container_add().
  55  *
  56  * |[
  57  * GtkWidget *palette, *group;
  58  * GtkToolItem *item;
  59  *
  60  * palette = gtk_tool_palette_new ();
  61  * group = gtk_tool_item_group_new (_("Test Category"));
  62  * gtk_container_add (GTK_CONTAINER (palette), group);
  63  *
  64  * item = gtk_tool_button_new_from_stock (GTK_STOCK_OK);
  65  * gtk_tool_item_group_insert (GTK_TOOL_ITEM_GROUP (group), item, -1);
  66  * ]|
  67  *
  68  * The easiest way to use drag and drop with #GtkToolPalette is to call
  69  * gtk_tool_palette_add_drag_dest() with the desired drag source @palette
  70  * and the desired drag target @widget. Then gtk_tool_palette_get_drag_item()
  71  * can be used to get the dragged item in the #GtkWidget::drag-data-received
  72  * signal handler of the drag target.
  73  *
  74  * |[
  75  * static void
  76  * passive_canvas_drag_data_received (GtkWidget        *widget,
  77  *                                    GdkDragContext   *context,
  78  *                                    gint              x,
  79  *                                    gint              y,
  80  *                                    GtkSelectionData *selection,
  81  *                                    guint             info,
  82  *                                    guint             time,
  83  *                                    gpointer          data)
  84  * {
  85  *   GtkWidget *palette;
  86  *   GtkWidget *item;
  87  *
  88  *   /<!-- -->* Get the dragged item *<!-- -->/
  89  *   palette = gtk_widget_get_ancestor (gtk_drag_get_source_widget (context),
  90  *                                      GTK_TYPE_TOOL_PALETTE);
  91  *   if (palette != NULL)
  92  *     item = gtk_tool_palette_get_drag_item (GTK_TOOL_PALETTE (palette),
  93  *                                            selection);
  94  *
  95  *   /<!-- -->* Do something with item *<!-- -->/
  96  * }
  97  *
  98  * GtkWidget *target, palette;
  99  *
 100  * palette = gtk_tool_palette_new ();
 101  * target = gtk_drawing_area_new ();
 102  *
 103  * g_signal_connect (G_OBJECT (target), "drag-data-received",
 104  *                   G_CALLBACK (passive_canvas_drag_data_received), NULL);
 105  * gtk_tool_palette_add_drag_dest (GTK_TOOL_PALETTE (palette), target,
 106  *                                 GTK_DEST_DEFAULT_ALL,
 107  *                                 GTK_TOOL_PALETTE_DRAG_ITEMS,
 108  *                                 GDK_ACTION_COPY);
 109  * ]|
 110  *
 111  * Since: 2.20
 112  */
 113
 114 typedef struct _GtkToolItemGroupInfo   GtkToolItemGroupInfo;
 115 typedef struct _GtkToolPaletteDragData GtkToolPaletteDragData;
 116
 117 enum
 118 {
 119   PROP_NONE,
 120   PROP_ICON_SIZE,
 121   PROP_ICON_SIZE_SET,
 122   PROP_ORIENTATION,
 123   PROP_TOOLBAR_STYLE,
 124 };
 125
 126 enum
 127 {
 128   CHILD_PROP_NONE,
 129   CHILD_PROP_EXCLUSIVE,
 130   CHILD_PROP_EXPAND,
 131 };
 132
 133 struct _GtkToolItemGroupInfo
 134 {
 135   GtkToolItemGroup *widget;
 136
 137   guint             notify_collapsed;
 138   guint             pos;
 139   guint             exclusive : 1;
 140   guint             expand : 1;
 141 };
 142
 143 struct _GtkToolPalettePrivate
 144 {
 145   GPtrArray* groups;
 146
 147   GtkAdjustment        *hadjustment;
 148   GtkAdjustment        *vadjustment;
 149
 150   GtkIconSize           icon_size;
 151   gboolean              icon_size_set;
 152   GtkOrientation        orientation;
 153   GtkToolbarStyle       style;
 154   gboolean              style_set;
 155
 156   GtkWidget            *expanding_child;
 157
 158   GtkSizeGroup         *text_size_group;
 159
 160   GtkSettings       *settings;
 161   gulong             settings_connection;
 162
 163   guint                 drag_source : 2;
 164 };
 165
 166 struct _GtkToolPaletteDragData
 167 {
 168   GtkToolPalette *palette;
 169   GtkWidget      *item;
 170 };
 171
 172 static GdkAtom dnd_target_atom_item = GDK_NONE;
 173 static GdkAtom dnd_target_atom_group = GDK_NONE;
 174
 175 static const GtkTargetEntry dnd_targets[] =
 176 {
 177   { "application/x-gtk-tool-palette-item", GTK_TARGET_SAME_APP, 0 },
 178   { "application/x-gtk-tool-palette-group", GTK_TARGET_SAME_APP, 0 },
 179 };
 180
 181 G_DEFINE_TYPE_WITH_CODE (GtkToolPalette,
 182                gtk_tool_palette,
 183                GTK_TYPE_CONTAINER,
 184                G_IMPLEMENT_INTERFACE (GTK_TYPE_ORIENTABLE, NULL));
 185
 186 static void
 187 gtk_tool_palette_init (GtkToolPalette *palette)
 188 {
 189   palette->priv = G_TYPE_INSTANCE_GET_PRIVATE (palette,
 190                                                GTK_TYPE_TOOL_PALETTE,
 191                                                GtkToolPalettePrivate);
 192
 193   palette->priv->groups = g_ptr_array_sized_new (4);
 194   g_ptr_array_set_free_func (palette->priv->groups, g_free);
 195
 196   palette->priv->icon_size = DEFAULT_ICON_SIZE;
 197   palette->priv->icon_size_set = FALSE;
 198   palette->priv->orientation = DEFAULT_ORIENTATION;
 199   palette->priv->style = DEFAULT_TOOLBAR_STYLE;
 200   palette->priv->style_set = FALSE;
 201
 202   palette->priv->text_size_group = gtk_size_group_new (GTK_SIZE_GROUP_BOTH);
 203 }
 204
 205 static void
 206 gtk_tool_palette_reconfigured (GtkToolPalette *palette)
 207 {
 208   guint i;
 209
 210   for (i = 0; i < palette->priv->groups->len; ++i)
 211     {
 212       GtkToolItemGroupInfo *info = g_ptr_array_index (palette->priv->groups, i);
 213       if (info->widget)
 214         _gtk_tool_item_group_palette_reconfigured (info->widget);
 215     }
 216
 217   gtk_widget_queue_resize_no_redraw (GTK_WIDGET (palette));
 218 }
 219
 220 static void
 221 gtk_tool_palette_set_property (GObject      *object,
 222                                guint         prop_id,
 223                                const GValue *value,
 224                                GParamSpec   *pspec)
 225 {
 226   GtkToolPalette *palette = GTK_TOOL_PALETTE (object);
 227
 228   switch (prop_id)
 229     {
 230       case PROP_ICON_SIZE:
 231         if ((guint) g_value_get_enum (value) != palette->priv->icon_size)
 232           {
 233             palette->priv->icon_size = g_value_get_enum (value);
 234             gtk_tool_palette_reconfigured (palette);
 235           }
 236         break;
 237
 238       case PROP_ICON_SIZE_SET:
 239         if ((guint) g_value_get_enum (value) != palette->priv->icon_size)
 240           {
 241             palette->priv->icon_size_set = g_value_get_enum (value);
 242             gtk_tool_palette_reconfigured (palette);
 243           }
 244         break;
 245
 246       case PROP_ORIENTATION:
 247         if ((guint) g_value_get_enum (value) != palette->priv->orientation)
 248           {
 249             palette->priv->orientation = g_value_get_enum (value);
 250             gtk_tool_palette_reconfigured (palette);
 251           }
 252         break;
 253
 254       case PROP_TOOLBAR_STYLE:
 255         if ((guint) g_value_get_enum (value) != palette->priv->style)
 256           {
 257             palette->priv->style = g_value_get_enum (value);
 258             gtk_tool_palette_reconfigured (palette);
 259           }
 260         break;
 261
 262       default:
 263         G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
 264         break;
 265     }
 266 }
 267
 268 static void
 269 gtk_tool_palette_get_property (GObject    *object,
 270                                guint       prop_id,
 271                                GValue     *value,
 272                                GParamSpec *pspec)
 273 {
 274   GtkToolPalette *palette = GTK_TOOL_PALETTE (object);
 275
 276   switch (prop_id)
 277     {
 278       case PROP_ICON_SIZE:
 279         g_value_set_enum (value, gtk_tool_palette_get_icon_size (palette));
 280         break;
 281
 282       case PROP_ICON_SIZE_SET:
 283         g_value_set_boolean (value, palette->priv->icon_size_set);
 284         break;
 285
 286       case PROP_ORIENTATION:
 287         g_value_set_enum (value, palette->priv->orientation);
 288         break;
 289
 290       case PROP_TOOLBAR_STYLE:
 291         g_value_set_enum (value, gtk_tool_palette_get_style (palette));
 292         break;
 293
 294       default:
 295         G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
 296         break;
 297     }
 298 }
 299
 300 static void
 301 gtk_tool_palette_dispose (GObject *object)
 302 {
 303   GtkToolPalette *palette = GTK_TOOL_PALETTE (object);
 304   guint i;
 305
 306   if (palette->priv->hadjustment)
 307     {
 308       g_object_unref (palette->priv->hadjustment);
 309       palette->priv->hadjustment = NULL;
 310     }
 311
 312   if (palette->priv->vadjustment)
 313     {
 314       g_object_unref (palette->priv->vadjustment);
 315       palette->priv->vadjustment = NULL;
 316     }
 317
 318   for (i = 0; i < palette->priv->groups->len; ++i)
 319     {
 320       GtkToolItemGroupInfo *group = g_ptr_array_index (palette->priv->groups, i);
 321
 322       if (group->notify_collapsed)
 323         {
 324           g_signal_handler_disconnect (group->widget, group->notify_collapsed);
 325           group->notify_collapsed = 0;
 326         }
 327     }
 328
 329   if (palette->priv->text_size_group)
 330     {
 331       g_object_unref (palette->priv->text_size_group);
 332       palette->priv->text_size_group = NULL;
 333     }
 334
 335   G_OBJECT_CLASS (gtk_tool_palette_parent_class)->dispose (object);
 336 }
 337
 338 static void
 339 gtk_tool_palette_finalize (GObject *object)
 340 {
 341   GtkToolPalette *palette = GTK_TOOL_PALETTE (object);
 342
 343   g_ptr_array_free (palette->priv->groups, TRUE);
 344
 345   G_OBJECT_CLASS (gtk_tool_palette_parent_class)->finalize (object);
 346 }
 347
 348 static void
 349 gtk_tool_palette_size_request (GtkWidget      *widget,
 350                                GtkRequisition *requisition)
 351 {
 352   const gint border_width = GTK_CONTAINER (widget)->border_width;
 353   GtkToolPalette *palette = GTK_TOOL_PALETTE (widget);
 354   GtkRequisition child_requisition;
 355   guint i;
 356
 357   requisition->width = 0;
 358   requisition->height = 0;
 359
 360   for (i = 0; i < palette->priv->groups->len; ++i)
 361     {
 362       GtkToolItemGroupInfo *group = g_ptr_array_index (palette->priv->groups, i);
 363
 364       if (!group->widget)
 365         continue;
 366
 367       gtk_widget_size_request (GTK_WIDGET (group->widget), &child_requisition);
 368
 369       if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
 370         {
 371           requisition->width = MAX (requisition->width, child_requisition.width);
 372           requisition->height += child_requisition.height;
 373         }
 374       else
 375         {
 376           requisition->width += child_requisition.width;
 377           requisition->height = MAX (requisition->height, child_requisition.height);
 378         }
 379     }
 380
 381   requisition->width += border_width * 2;
 382   requisition->height += border_width * 2;
 383 }
 384
 385 static void
 386 gtk_tool_palette_size_allocate (GtkWidget     *widget,
 387                                 GtkAllocation *allocation)
 388 {
 389   const gint border_width = GTK_CONTAINER (widget)->border_width;
 390   GtkToolPalette *palette = GTK_TOOL_PALETTE (widget);
 391   GtkAdjustment *adjustment = NULL;
 392   GtkAllocation child_allocation;
 393
 394   gint n_expand_groups = 0;
 395   gint remaining_space = 0;
 396   gint expand_space = 0;
 397
 398   gint page_start, page_size = 0;
 399   gint offset = 0;
 400   guint i;
 401
 402   gint min_offset = -1, max_offset = -1;
 403
 404   gint x;
 405
 406   gint *group_sizes = g_newa (gint, palette->priv->groups->len);
 407
 408   GtkTextDirection direction = gtk_widget_get_direction (widget);
 409
 410   GTK_WIDGET_CLASS (gtk_tool_palette_parent_class)->size_allocate (widget, allocation);
 411
 412   if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
 413     {
 414       adjustment = palette->priv->vadjustment;
 415       page_size = allocation->height;
 416     }
 417   else
 418     {
 419       adjustment = palette->priv->hadjustment;
 420       page_size = allocation->width;
 421     }
 422
 423   if (adjustment)
 424     offset = gtk_adjustment_get_value (adjustment);
 425   if (GTK_ORIENTATION_HORIZONTAL == palette->priv->orientation &&
 426       GTK_TEXT_DIR_RTL == direction)
 427     offset = -offset;
 428
 429   if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
 430     child_allocation.width = allocation->width - border_width * 2;
 431   else
 432     child_allocation.height = allocation->height - border_width * 2;
 433
 434   if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
 435     remaining_space = allocation->height;
 436   else
 437     remaining_space = allocation->width;
 438
 439   /* figure out the required size of all groups to be able to distribute the
 440    * remaining space on allocation
 441    */
 442   for (i = 0; i < palette->priv->groups->len; ++i)
 443     {
 444       GtkToolItemGroupInfo *group = g_ptr_array_index (palette->priv->groups, i);
 445       gint size;
 446
 447       if (!group->widget)
 448         continue;
 449
 450       widget = GTK_WIDGET (group->widget);
 451
 452       if (gtk_tool_item_group_get_n_items (group->widget))
 453         {
 454           if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
 455             size = _gtk_tool_item_group_get_height_for_width (group->widget, child_allocation.width);
 456           else
 457             size = _gtk_tool_item_group_get_width_for_height (group->widget, child_allocation.height);
 458
 459           if (group->expand && !gtk_tool_item_group_get_collapsed (group->widget))
 460             n_expand_groups += 1;
 461         }
 462       else
 463         size = 0;
 464
 465       remaining_space -= size;
 466       group_sizes[i] = size;
 467
 468       /* if the widget is currently expanding an offset which allows to
 469        * display as much of the widget as possible is calculated
 470        */
 471       if (widget == palette->priv->expanding_child)
 472         {
 473           gint limit =
 474             GTK_ORIENTATION_VERTICAL == palette->priv->orientation ?
 475             child_allocation.width : child_allocation.height;
 476
 477           gint real_size;
 478           guint j;
 479
 480           min_offset = 0;
 481
 482           for (j = 0; j < i; ++j)
 483             min_offset += group_sizes[j];
 484
 485           max_offset = min_offset + group_sizes[i];
 486
 487           real_size = _gtk_tool_item_group_get_size_for_limit
 488             (GTK_TOOL_ITEM_GROUP (widget), limit,
 489              GTK_ORIENTATION_VERTICAL == palette->priv->orientation,
 490              FALSE);
 491
 492           if (size == real_size)
 493             palette->priv->expanding_child = NULL;
 494         }
 495     }
 496
 497   if (n_expand_groups > 0)
 498     {
 499       remaining_space = MAX (0, remaining_space);
 500       expand_space = remaining_space / n_expand_groups;
 501     }
 502
 503   if (max_offset != -1)
 504     {
 505       gint limit =
 506         GTK_ORIENTATION_VERTICAL == palette->priv->orientation ?
 507         allocation->height : allocation->width;
 508
 509       offset = MIN (MAX (offset, max_offset - limit), min_offset);
 510     }
 511
 512   if (remaining_space > 0)
 513     offset = 0;
 514
 515   x = border_width;
 516   child_allocation.y = border_width;
 517
 518   if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
 519     child_allocation.y -= offset;
 520   else
 521     x -= offset;
 522
 523   /* allocate all groups at the calculated positions */
 524   for (i = 0; i < palette->priv->groups->len; ++i)
 525     {
 526       GtkToolItemGroupInfo *group = g_ptr_array_index (palette->priv->groups, i);
 527       GtkWidget *widget;
 528
 529       if (!group->widget)
 530         continue;
 531
 532       widget = GTK_WIDGET (group->widget);
 533
 534       if (gtk_tool_item_group_get_n_items (group->widget))
 535         {
 536           gint size = group_sizes[i];
 537
 538           if (group->expand && !gtk_tool_item_group_get_collapsed (group->widget))
 539             {
 540               size += MIN (expand_space, remaining_space);
 541               remaining_space -= expand_space;
 542             }
 543
 544           if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
 545             child_allocation.height = size;
 546           else
 547             child_allocation.width = size;
 548
 549           if (GTK_ORIENTATION_HORIZONTAL == palette->priv->orientation &&
 550               GTK_TEXT_DIR_RTL == direction)
 551             child_allocation.x = allocation->width - x - child_allocation.width;
 552           else
 553             child_allocation.x = x;
 554
 555           gtk_widget_size_allocate (widget, &child_allocation);
 556           gtk_widget_show (widget);
 557
 558           if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
 559             child_allocation.y += child_allocation.height;
 560           else
 561             x += child_allocation.width;
 562         }
 563       else
 564         gtk_widget_hide (widget);
 565     }
 566
 567   if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
 568     {
 569       child_allocation.y += border_width;
 570       child_allocation.y += offset;
 571
 572       page_start = child_allocation.y;
 573     }
 574   else
 575     {
 576       x += border_width;
 577       x += offset;
 578
 579       page_start = x;
 580     }
 581
 582   /* update the scrollbar to match the displayed adjustment */
 583   if (adjustment)
 584     {
 585       gdouble value;
 586
 587       adjustment->page_increment = page_size * 0.9;
 588       adjustment->step_increment = page_size * 0.1;
 589       adjustment->page_size = page_size;
 590
 591       if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation ||
 592           GTK_TEXT_DIR_LTR == direction)
 593         {
 594           adjustment->lower = 0;
 595           adjustment->upper = MAX (0, page_start);
 596
 597           value = MIN (offset, adjustment->upper - adjustment->page_size);
 598           gtk_adjustment_clamp_page (adjustment, value, offset + page_size);
 599         }
 600       else
 601         {
 602           adjustment->lower = page_size - MAX (0, page_start);
 603           adjustment->upper = page_size;
 604
 605           offset = -offset;
 606
 607           value = MAX (offset, adjustment->lower);
 608           gtk_adjustment_clamp_page (adjustment, offset, value + page_size);
 609         }
 610
 611       gtk_adjustment_changed (adjustment);
 612     }
 613 }
 614
 615 static gboolean
 616 gtk_tool_palette_expose_event (GtkWidget      *widget,
 617                                GdkEventExpose *event)
 618 {
 619   GtkToolPalette *palette = GTK_TOOL_PALETTE (widget);
 620   GdkDisplay *display;
 621   cairo_t *cr;
 622   guint i;
 623
 624   display = gdk_drawable_get_display (widget->window);
 625
 626   if (!gdk_display_supports_composite (display))
 627     return FALSE;
 628
 629   cr = gdk_cairo_create (widget->window);
 630   gdk_cairo_region (cr, event->region);
 631   cairo_clip (cr);
 632
 633   cairo_push_group (cr);
 634
 635   for (i = 0; i < palette->priv->groups->len; ++i)
 636   {
 637     GtkToolItemGroupInfo *info = g_ptr_array_index (palette->priv->groups, i);
 638     if (info->widget)
 639       _gtk_tool_item_group_paint (info->widget, cr);
 640   }
 641
 642   cairo_pop_group_to_source (cr);
 643
 644   cairo_paint (cr);
 645   cairo_destroy (cr);
 646
 647   return FALSE;
 648 }
 649
 650 static void
 651 gtk_tool_palette_realize (GtkWidget *widget)
 652 {
 653   const gint border_width = GTK_CONTAINER (widget)->border_width;
 654   gint attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
 655   GdkWindowAttr attributes;
 656
 657   attributes.window_type = GDK_WINDOW_CHILD;
 658   attributes.x = widget->allocation.x + border_width;
 659   attributes.y = widget->allocation.y + border_width;
 660   attributes.width = widget->allocation.width - border_width * 2;
 661   attributes.height = widget->allocation.height - border_width * 2;
 662   attributes.wclass = GDK_INPUT_OUTPUT;
 663   attributes.visual = gtk_widget_get_visual (widget);
 664   attributes.colormap = gtk_widget_get_colormap (widget);
 665   attributes.event_mask = GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK
 666                         | GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK
 667                         | GDK_BUTTON_MOTION_MASK;
 668
 669   widget->window = gdk_window_new (gtk_widget_get_parent_window (widget),
 670                                    &attributes, attributes_mask);
 671
 672   gdk_window_set_user_data (widget->window, widget);
 673   widget->style = gtk_style_attach (widget->style, widget->window);
 674   gtk_style_set_background (widget->style, widget->window, GTK_STATE_NORMAL);
 675   GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
 676
 677   gtk_container_forall (GTK_CONTAINER (widget),
 678                         (GtkCallback) gtk_widget_set_parent_window,
 679                         widget->window);
 680
 681   gtk_widget_queue_resize_no_redraw (widget);
 682 }
 683
 684 static void
 685 gtk_tool_palette_adjustment_value_changed (GtkAdjustment *adjustment,
 686                                            gpointer       data)
 687 {
 688   GtkWidget *widget = GTK_WIDGET (data);
 689   gtk_tool_palette_size_allocate (widget, &widget->allocation);
 690 }
 691
 692 static void
 693 gtk_tool_palette_set_scroll_adjustments (GtkWidget     *widget,
 694                                          GtkAdjustment *hadjustment,
 695                                          GtkAdjustment *vadjustment)
 696 {
 697   GtkToolPalette *palette = GTK_TOOL_PALETTE (widget);
 698
 699   if (hadjustment)
 700     g_object_ref_sink (hadjustment);
 701   if (vadjustment)
 702     g_object_ref_sink (vadjustment);
 703
 704   if (palette->priv->hadjustment)
 705     g_object_unref (palette->priv->hadjustment);
 706   if (palette->priv->vadjustment)
 707     g_object_unref (palette->priv->vadjustment);
 708
 709   palette->priv->hadjustment = hadjustment;
 710   palette->priv->vadjustment = vadjustment;
 711
 712   if (palette->priv->hadjustment)
 713     g_signal_connect (palette->priv->hadjustment, "value-changed",
 714                       G_CALLBACK (gtk_tool_palette_adjustment_value_changed),
 715                       palette);
 716   if (palette->priv->vadjustment)
 717     g_signal_connect (palette->priv->vadjustment, "value-changed",
 718                       G_CALLBACK (gtk_tool_palette_adjustment_value_changed),
 719                       palette);
 720 }
 721
 722 static void
 723 gtk_tool_palette_add (GtkContainer *container,
 724                       GtkWidget    *child)
 725 {
 726   GtkToolPalette *palette;
 727   GtkToolItemGroupInfo *info = g_new0(GtkToolItemGroupInfo, 1);
 728
 729   g_return_if_fail (GTK_IS_TOOL_PALETTE (container));
 730   g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (child));
 731
 732   palette = GTK_TOOL_PALETTE (container);
 733
 734   g_ptr_array_add (palette->priv->groups, info);
 735   info->pos = palette->priv->groups->len - 1;
 736   info->widget = g_object_ref_sink (child);
 737
 738   gtk_widget_set_parent (child, GTK_WIDGET (palette));
 739 }
 740
 741 static void
 742 gtk_tool_palette_remove (GtkContainer *container,
 743                          GtkWidget    *child)
 744 {
 745   GtkToolPalette *palette;
 746   guint i;
 747
 748   g_return_if_fail (GTK_IS_TOOL_PALETTE (container));
 749   palette = GTK_TOOL_PALETTE (container);
 750
 751   for (i = 0; i < palette->priv->groups->len; ++i)
 752     {
 753       GtkToolItemGroupInfo *info = g_ptr_array_index (palette->priv->groups, i);
 754       if (GTK_WIDGET(info->widget) == child)
 755         {
 756           g_object_unref (child);
 757           gtk_widget_unparent (child);
 758
 759           g_ptr_array_remove_index (palette->priv->groups, i);
 760         }
 761     }
 762 }
 763
 764 static void
 765 gtk_tool_palette_forall (GtkContainer *container,
 766                          gboolean      internals,
 767                          GtkCallback   callback,
 768                          gpointer      callback_data)
 769 {
 770   GtkToolPalette *palette = GTK_TOOL_PALETTE (container);
 771   guint i;
 772
 773
 774   for (i = 0; i < palette->priv->groups->len; ++i)
 775     {
 776       GtkToolItemGroupInfo *info = g_ptr_array_index (palette->priv->groups, i);
 777       if (info->widget)
 778         callback (GTK_WIDGET (info->widget),
 779                   callback_data);
 780     }
 781 }
 782
 783 static GType
 784 gtk_tool_palette_child_type (GtkContainer *container)
 785 {
 786   return GTK_TYPE_TOOL_ITEM_GROUP;
 787 }
 788
 789 static void
 790 gtk_tool_palette_set_child_property (GtkContainer *container,
 791                                      GtkWidget    *child,
 792                                      guint         prop_id,
 793                                      const GValue *value,
 794                                      GParamSpec   *pspec)
 795 {
 796   GtkToolPalette *palette = GTK_TOOL_PALETTE (container);
 797
 798   switch (prop_id)
 799     {
 800       case CHILD_PROP_EXCLUSIVE:
 801         gtk_tool_palette_set_exclusive (palette, child, g_value_get_boolean (value));
 802         break;
 803
 804       case CHILD_PROP_EXPAND:
 805         gtk_tool_palette_set_expand (palette, child, g_value_get_boolean (value));
 806         break;
 807
 808       default:
 809         GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, prop_id, pspec);
 810         break;
 811     }
 812 }
 813
 814 static void
 815 gtk_tool_palette_get_child_property (GtkContainer *container,
 816                                      GtkWidget    *child,
 817                                      guint         prop_id,
 818                                      GValue       *value,
 819                                      GParamSpec   *pspec)
 820 {
 821   GtkToolPalette *palette = GTK_TOOL_PALETTE (container);
 822
 823   switch (prop_id)
 824     {
 825       case CHILD_PROP_EXCLUSIVE:
 826         g_value_set_boolean (value, gtk_tool_palette_get_exclusive (palette, child));
 827         break;
 828
 829       case CHILD_PROP_EXPAND:
 830         g_value_set_boolean (value, gtk_tool_palette_get_expand (palette, child));
 831         break;
 832
 833       default:
 834         GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, prop_id, pspec);
 835         break;
 836     }
 837 }
 838
 839 static void
 840 style_change_notify (GtkToolPalette *palette)
 841 {
 842   GtkToolPalettePrivate* priv = palette->priv;
 843
 844   if (!priv->style_set)
 845     {
 846       /* pretend it was set, then unset, thus reverting to new default */
 847       priv->style_set = TRUE;
 848       gtk_tool_palette_unset_style (palette);
 849     }
 850 }
 851
 852 static void
 853 icon_size_change_notify (GtkToolPalette *palette)
 854 {
 855   GtkToolPalettePrivate* priv = palette->priv;
 856
 857   if (!priv->icon_size_set)
 858     {
 859       /* pretend it was set, then unset, thus reverting to new default */
 860       priv->icon_size_set = TRUE;
 861       gtk_tool_palette_unset_icon_size (palette);
 862     }
 863 }
 864
 865 static void
 866 gtk_tool_palette_settings_change_notify (GtkSettings      *settings,
 867                                          const GParamSpec *pspec,
 868                                          GtkToolPalette   *palette)
 869 {
 870   if (strcmp (pspec->name, "gtk-toolbar-style") == 0)
 871     style_change_notify (palette);
 872   else if (strcmp (pspec->name, "gtk-toolbar-icon-size") == 0)
 873     icon_size_change_notify (palette);
 874 }
 875
 876 static void
 877 gtk_tool_palette_screen_changed (GtkWidget *widget,
 878                                  GdkScreen *previous_screen)
 879 {
 880   GtkToolPalette *palette = GTK_TOOL_PALETTE (widget);
 881   GtkToolPalettePrivate* priv = palette->priv;
 882   GtkSettings *old_settings = priv->settings;
 883   GtkSettings *settings;
 884
 885   if (gtk_widget_has_screen (GTK_WIDGET (palette)))
 886     settings = gtk_widget_get_settings (GTK_WIDGET (palette));
 887   else
 888     settings = NULL;
 889
 890   if (settings == old_settings)
 891     return;
 892
 893   if (old_settings)
 894   {
 895     g_signal_handler_disconnect (old_settings, priv->settings_connection);
 896     g_object_unref (old_settings);
 897   }
 898
 899   if (settings)
 900   {
 901     priv->settings_connection =
 902       g_signal_connect (settings, "notify",
 903                         G_CALLBACK (gtk_tool_palette_settings_change_notify),
 904                         palette);
 905     priv->settings = g_object_ref (settings);
 906   }
 907   else
 908     priv->settings = NULL;
 909
 910   gtk_tool_palette_reconfigured (palette);
 911 }
 912
 913
 914 static void
 915 gtk_tool_palette_class_init (GtkToolPaletteClass *cls)
 916 {
 917   GObjectClass      *oclass   = G_OBJECT_CLASS (cls);
 918   GtkWidgetClass    *wclass   = GTK_WIDGET_CLASS (cls);
 919   GtkContainerClass *cclass   = GTK_CONTAINER_CLASS (cls);
 920
 921   oclass->set_property        = gtk_tool_palette_set_property;
 922   oclass->get_property        = gtk_tool_palette_get_property;
 923   oclass->dispose             = gtk_tool_palette_dispose;
 924   oclass->finalize            = gtk_tool_palette_finalize;
 925
 926   wclass->size_request        = gtk_tool_palette_size_request;
 927   wclass->size_allocate       = gtk_tool_palette_size_allocate;
 928   wclass->expose_event        = gtk_tool_palette_expose_event;
 929   wclass->realize             = gtk_tool_palette_realize;
 930
 931   cclass->add                 = gtk_tool_palette_add;
 932   cclass->remove              = gtk_tool_palette_remove;
 933   cclass->forall              = gtk_tool_palette_forall;
 934   cclass->child_type          = gtk_tool_palette_child_type;
 935   cclass->set_child_property  = gtk_tool_palette_set_child_property;
 936   cclass->get_child_property  = gtk_tool_palette_get_child_property;
 937
 938   cls->set_scroll_adjustments = gtk_tool_palette_set_scroll_adjustments;
 939
 940   /* Handle screen-changed so we can update our GtkSettings.
 941    */
 942   wclass->screen_changed      = gtk_tool_palette_screen_changed;
 943
 944   /**
 945    * GtkToolPalette::set-scroll-adjustments:
 946    * @widget: the GtkToolPalette that received the signal
 947    * @hadjustment: The horizontal adjustment
 948    * @vadjustment: The vertical adjustment
 949    *
 950    * Set the scroll adjustments for the viewport.
 951    * Usually scrolled containers like GtkScrolledWindow will emit this
 952    * signal to connect two instances of GtkScrollbar to the scroll
 953    * directions of the GtkToolpalette.
 954    *
 955    * Since: 2.20
 956    */
 957   wclass->set_scroll_adjustments_signal =
 958     g_signal_new ("set-scroll-adjustments",
 959                   G_TYPE_FROM_CLASS (oclass),
 960                   G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
 961                   G_STRUCT_OFFSET (GtkToolPaletteClass, set_scroll_adjustments),
 962                   NULL, NULL,
 963                   _gtk_marshal_VOID__OBJECT_OBJECT,
 964                   G_TYPE_NONE, 2,
 965                   GTK_TYPE_ADJUSTMENT,
 966                   GTK_TYPE_ADJUSTMENT);
 967
 968   g_object_class_override_property (oclass, PROP_ORIENTATION, "orientation");
 969
 970   /**
 971    * GtkToolPalette:icon-size:
 972    *
 973    * The size of the icons in a tool palette is normally determined by
 974    * the #GtkSettings:toolbar-icon-size setting. When this property is set,
 975    * it overrides the setting.
 976    *
 977    * This should only be used for special-purpose tool palettes, normal
 978    * application tool palettes should respect the user preferences for the
 979    * size of icons.
 980    *
 981    * Since: 2.20
 982    */
 983   g_object_class_install_property (oclass,
 984                                    PROP_ICON_SIZE,
 985                                    g_param_spec_enum ("icon-size",
 986                                                       P_("Icon size"),
 987                                                       P_("Size of icons in this tool palette"),
 988                                                       GTK_TYPE_ICON_SIZE,
 989                                                       DEFAULT_ICON_SIZE,
 990                                                       GTK_PARAM_READWRITE));
 991
 992   /**
 993    * GtkToolPalette:icon-size-set:
 994    *
 995    * Is %TRUE if the #GtkToolPalette:icon-size property has been set.
 996    *
 997    * Since: 2.20
 998    */
 999   g_object_class_install_property (oclass,
1000                                    PROP_ICON_SIZE_SET,
1001                                    g_param_spec_boolean ("icon-size-set",
1002                                                       P_("Icon size set"),
1003                                                       P_("Whether the icon-size property has been set"),
1004                                                       FALSE,
1005                                                       GTK_PARAM_READWRITE));
1006
1007   /**
1008    * GtkToolPalette:toolbar-style:
1009    *
1010    * The style of items in the tool palette.
1011    *
1012    * Since: 2.20
1013    */
1014   g_object_class_install_property (oclass, PROP_TOOLBAR_STYLE,
1015                                    g_param_spec_enum ("toolbar-style",
1016                                                       P_("Toolbar Style"),
1017                                                       P_("Style of items in the tool palette"),
1018                                                       GTK_TYPE_TOOLBAR_STYLE,
1019                                                       DEFAULT_TOOLBAR_STYLE,
1020                                                       GTK_PARAM_READWRITE));
1021
1022
1023   /**
1024    * GtkToolPalette:exclusive:
1025    *
1026    * Whether the item group should be the only one that is expanded
1027    * at a given time.
1028    *
1029    * Since: 2.20
1030    */
1031   gtk_container_class_install_child_property (cclass, CHILD_PROP_EXCLUSIVE,
1032                                               g_param_spec_boolean ("exclusive",
1033                                                                     P_("Exclusive"),
1034                                                                     P_("Whether the item group should be the only expanded at a given time"),
1035                                                                     DEFAULT_CHILD_EXCLUSIVE,
1036                                                                     GTK_PARAM_READWRITE));
1037
1038   /**
1039    * GtkToolPalette:expand:
1040    *
1041    * Whether the item group should receive extra space when the palette grows.
1042    * at a given time.
1043    *
1044    * Since: 2.20
1045    */
1046   gtk_container_class_install_child_property (cclass, CHILD_PROP_EXPAND,
1047                                               g_param_spec_boolean ("expand",
1048                                                                     P_("Expand"),
1049                                                                     P_("Whether the item group should receive extra space when the palette grows"),
1050                                                                     DEFAULT_CHILD_EXPAND,
1051                                                                     GTK_PARAM_READWRITE));
1052
1053   g_type_class_add_private (cls, sizeof (GtkToolPalettePrivate));
1054
1055   dnd_target_atom_item = gdk_atom_intern_static_string (dnd_targets[0].target);
1056   dnd_target_atom_group = gdk_atom_intern_static_string (dnd_targets[1].target);
1057 }
1058
1059 /**
1060  * gtk_tool_palette_new:
1061  *
1062  * Creates a new tool palette.
1063  *
1064  * Returns: a new #GtkToolPalette
1065  *
1066  * Since: 2.20
1067  */
1068 GtkWidget*
1069 gtk_tool_palette_new (void)
1070 {
1071   return g_object_new (GTK_TYPE_TOOL_PALETTE, NULL);
1072 }
1073
1074 /**
1075  * gtk_tool_palette_set_icon_size:
1076  * @palette: a #GtkToolPalette
1077  * @icon_size: the #GtkIconSize that icons in the tool palette shall have
1078  *
1079  * Sets the size of icons in the tool palette.
1080  *
1081  * Since: 2.20
1082  */
1083 void
1084 gtk_tool_palette_set_icon_size (GtkToolPalette *palette,
1085                                 GtkIconSize     icon_size)
1086 {
1087   GtkToolPalettePrivate *priv;
1088
1089   g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
1090   g_return_if_fail (icon_size != GTK_ICON_SIZE_INVALID);
1091
1092   priv = palette->priv;
1093
1094   if (!priv->icon_size_set)
1095     {
1096       priv->icon_size_set = TRUE;
1097       g_object_notify (G_OBJECT (palette), "icon-size-set");
1098     }
1099
1100   if (priv->icon_size == icon_size)
1101     return;
1102
1103   priv->icon_size = icon_size;
1104   g_object_notify (G_OBJECT (palette), "icon-size");
1105
1106   gtk_tool_palette_reconfigured (palette);
1107
1108   gtk_widget_queue_resize (GTK_WIDGET (palette));
1109 }
1110
1111 static GtkSettings *
1112 toolpalette_get_settings (GtkToolPalette *palette)
1113 {
1114   GtkToolPalettePrivate *priv = palette->priv;
1115   return priv->settings;
1116 }
1117
1118 /**
1119  * gtk_tool_palette_unset_icon_size:
1120  * @palette: a #GtkToolPalette
1121  *
1122  * Unsets the tool palette icon size set with gtk_tool_palette_set_icon_size(),
1123  * so that user preferences will be used to determine the icon size.
1124  *
1125  * Since: 2.20
1126  */
1127 void
1128 gtk_tool_palette_unset_icon_size (GtkToolPalette *palette)
1129 {
1130   GtkToolPalettePrivate* priv = palette->priv;
1131   GtkIconSize size;
1132
1133   g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
1134
1135   if (palette->priv->icon_size_set)
1136     {
1137       GtkSettings *settings = toolpalette_get_settings (palette);
1138
1139       if (settings)
1140         {
1141           g_object_get (settings,
1142             "gtk-toolbar-icon-size", &size,
1143             NULL);
1144         }
1145       else
1146         size = DEFAULT_ICON_SIZE;
1147
1148       if (size != palette->priv->icon_size)
1149       {
1150         gtk_tool_palette_set_icon_size (palette, size);
1151         g_object_notify (G_OBJECT (palette), "icon-size");
1152             }
1153
1154       priv->icon_size_set = FALSE;
1155       g_object_notify (G_OBJECT (palette), "icon-size-set");
1156     }
1157 }
1158
1159 /* Set the "toolbar-style" property and do appropriate things.
1160  * GtkToolbar does this by emitting a signal instead of just
1161  * calling a function...
1162  */
1163 static void
1164 gtk_tool_palette_change_style (GtkToolPalette  *palette,
1165                                GtkToolbarStyle  style)
1166 {
1167   GtkToolPalettePrivate* priv = palette->priv;
1168
1169   if (priv->style != style)
1170     {
1171       priv->style = style;
1172
1173       gtk_tool_palette_reconfigured (palette);
1174
1175       gtk_widget_queue_resize (GTK_WIDGET (palette));
1176       g_object_notify (G_OBJECT (palette), "toolbar-style");
1177     }
1178 }
1179
1180
1181 /**
1182  * gtk_tool_palette_set_style:
1183  * @palette: a #GtkToolPalette
1184  * @style: the #GtkToolbarStyle that items in the tool palette shall have
1185  *
1186  * Sets the style (text, icons or both) of items in the tool palette.
1187  *
1188  * Since: 2.20
1189  */
1190 void
1191 gtk_tool_palette_set_style (GtkToolPalette  *palette,
1192                             GtkToolbarStyle  style)
1193 {
1194   g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
1195
1196   palette->priv->style_set = TRUE;
1197   gtk_tool_palette_change_style (palette, style);
1198 }
1199
1200
1201 /**
1202  * gtk_tool_palette_unset_style:
1203  * @palette: a #GtkToolPalette
1204  *
1205  * Unsets a toolbar style set with gtk_tool_palette_set_style(),
1206  * so that user preferences will be used to determine the toolbar style.
1207  *
1208  * Since: 2.20
1209  */
1210 void
1211 gtk_tool_palette_unset_style (GtkToolPalette *palette)
1212 {
1213   GtkToolPalettePrivate* priv = palette->priv;
1214   GtkToolbarStyle style;
1215
1216   g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
1217
1218   if (priv->style_set)
1219     {
1220       GtkSettings *settings = toolpalette_get_settings (palette);
1221
1222       if (settings)
1223         g_object_get (settings,
1224                       "gtk-toolbar-style", &style,
1225                       NULL);
1226       else
1227         style = DEFAULT_TOOLBAR_STYLE;
1228
1229       if (style != priv->style)
1230         gtk_tool_palette_change_style (palette, style);
1231
1232       priv->style_set = FALSE;
1233     }
1234 }
1235
1236 /**
1237  * gtk_tool_palette_get_icon_size:
1238  * @palette: a #GtkToolPalette
1239  *
1240  * Gets the size of icons in the tool palette.
1241  * See gtk_tool_palette_set_icon_size().
1242  *
1243  * Returns: the #GtkIconSize of icons in the tool palette
1244  *
1245  * Since: 2.20
1246  */
1247 GtkIconSize
1248 gtk_tool_palette_get_icon_size (GtkToolPalette *palette)
1249 {
1250   g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), DEFAULT_ICON_SIZE);
1251
1252   return palette->priv->icon_size;
1253 }
1254
1255 /**
1256  * gtk_tool_palette_get_style:
1257  * @palette: a #GtkToolPalette
1258  *
1259  * Gets the style (icons, text or both) of items in the tool palette.
1260  *
1261  * Returns: the #GtkToolbarStyle of items in the tool palette.
1262  *
1263  * Since: 2.20
1264  */
1265 GtkToolbarStyle
1266 gtk_tool_palette_get_style (GtkToolPalette *palette)
1267 {
1268   g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), DEFAULT_TOOLBAR_STYLE);
1269
1270   return palette->priv->style;
1271 }
1272
1273 gint
1274 _gtk_tool_palette_compare_groups (gconstpointer a,
1275                                   gconstpointer b)
1276 {
1277   const GtkToolItemGroupInfo *group_a = a;
1278   const GtkToolItemGroupInfo *group_b = b;
1279
1280   return group_a->pos - group_b->pos;
1281 }
1282
1283 /**
1284  * gtk_tool_palette_set_group_position:
1285  * @palette: a #GtkToolPalette
1286  * @group: a #GtkToolItemGroup which is a child of palette
1287  * @position: a new index for group
1288  *
1289  * Sets the position of the group as an index of the tool palette.
1290  * If position is 0 the group will become the first child, if position is
1291  * -1 it will become the last child.
1292  *
1293  * Since: 2.20
1294  */
1295 void
1296 gtk_tool_palette_set_group_position (GtkToolPalette *palette,
1297                                      GtkWidget      *group,
1298                                      gint            position)
1299 {
1300   GtkToolItemGroupInfo *group_new;
1301   GtkToolItemGroupInfo *group_old;
1302   gint old_position;
1303
1304   g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
1305   g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
1306   g_return_if_fail (position >= -1);
1307
1308   if (-1 == position)
1309     position = palette->priv->groups->len - 1;
1310
1311   g_return_if_fail ((guint) position < palette->priv->groups->len);
1312
1313   group_new = g_ptr_array_index (palette->priv->groups, position);
1314
1315   if (GTK_TOOL_ITEM_GROUP (group) == group_new->widget)
1316     return;
1317
1318   old_position = gtk_tool_palette_get_group_position (palette, group);
1319   g_return_if_fail (old_position >= 0);
1320
1321   group_old = g_ptr_array_index (palette->priv->groups, old_position);
1322
1323   group_new->pos = position;
1324   group_old->pos = old_position;
1325
1326   g_ptr_array_sort (palette->priv->groups, _gtk_tool_palette_compare_groups);
1327
1328   gtk_widget_queue_resize (GTK_WIDGET (palette));
1329 }
1330
1331 static void
1332 gtk_tool_palette_group_notify_collapsed (GtkToolItemGroup *group,
1333                                          GParamSpec       *pspec,
1334                                          gpointer          data)
1335 {
1336   GtkToolPalette *palette = GTK_TOOL_PALETTE (data);
1337   guint i;
1338
1339   if (gtk_tool_item_group_get_collapsed (group))
1340     return;
1341
1342   for (i = 0; i < palette->priv->groups->len; ++i)
1343     {
1344       GtkToolItemGroupInfo *info = g_ptr_array_index (palette->priv->groups, i);
1345       GtkToolItemGroup *current_group = info->widget;
1346
1347       if (current_group && current_group != group)
1348         gtk_tool_item_group_set_collapsed (current_group, TRUE);
1349     }
1350 }
1351
1352 /**
1353  * gtk_tool_palette_set_exclusive:
1354  * @palette: a #GtkToolPalette
1355  * @group: a #GtkToolItemGroup which is a child of palette
1356  * @exclusive: whether the group should be exclusive or not
1357  *
1358  * Sets whether the group should be exclusive or not.
1359  * If an exclusive group is expanded all other groups are collapsed.
1360  *
1361  * Since: 2.20
1362  */
1363 void
1364 gtk_tool_palette_set_exclusive (GtkToolPalette *palette,
1365                                 GtkWidget      *group,
1366                                 gboolean        exclusive)
1367 {
1368   GtkToolItemGroupInfo *group_info;
1369   gint position;
1370
1371   g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
1372   g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
1373
1374   position = gtk_tool_palette_get_group_position (palette, group);
1375   g_return_if_fail (position >= 0);
1376
1377   group_info = g_ptr_array_index (palette->priv->groups, position);
1378
1379   if (exclusive == group_info->exclusive)
1380     return;
1381
1382   group_info->exclusive = exclusive;
1383
1384   if (group_info->exclusive != (0 != group_info->notify_collapsed))
1385     {
1386       if (group_info->exclusive)
1387         {
1388           group_info->notify_collapsed =
1389             g_signal_connect (group, "notify::collapsed",
1390                               G_CALLBACK (gtk_tool_palette_group_notify_collapsed),
1391                               palette);
1392         }
1393       else
1394         {
1395           g_signal_handler_disconnect (group, group_info->notify_collapsed);
1396           group_info->notify_collapsed = 0;
1397         }
1398     }
1399
1400   gtk_tool_palette_group_notify_collapsed (group_info->widget, NULL, palette);
1401   gtk_widget_child_notify (group, "exclusive");
1402 }
1403
1404 /**
1405  * gtk_tool_palette_set_expand:
1406  * @palette: a #GtkToolPalette
1407  * @group: a #GtkToolItemGroup which is a child of palette
1408  * @expand: whether the group should be given extra space
1409  *
1410  * Sets whether the group should be given extra space.
1411  *
1412  * Since: 2.20
1413  */
1414 void
1415 gtk_tool_palette_set_expand (GtkToolPalette *palette,
1416                              GtkWidget      *group,
1417                              gboolean        expand)
1418 {
1419   GtkToolItemGroupInfo *group_info;
1420   gint position;
1421
1422   g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
1423   g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
1424
1425   position = gtk_tool_palette_get_group_position (palette, group);
1426   g_return_if_fail (position >= 0);
1427
1428   group_info = g_ptr_array_index (palette->priv->groups, position);
1429
1430   if (expand != group_info->expand)
1431     {
1432       group_info->expand = expand;
1433       gtk_widget_queue_resize (GTK_WIDGET (palette));
1434       gtk_widget_child_notify (group, "expand");
1435     }
1436 }
1437
1438 /**
1439  * gtk_tool_palette_get_group_position:
1440  * @palette: a #GtkToolPalette
1441  * @group: a #GtkToolItemGroup
1442  *
1443  * Gets the position of @group in @palette as index.
1444  * See gtk_tool_palette_set_group_position().
1445  *
1446  * Returns: the index of group or -1 if @group is not a child of @palette
1447  *
1448  * Since: 2.20
1449  */
1450 gint
1451 gtk_tool_palette_get_group_position (GtkToolPalette *palette,
1452                                      GtkWidget      *group)
1453 {
1454   guint i;
1455
1456   g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), -1);
1457   g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (group), -1);
1458
1459   for (i = 0; i < palette->priv->groups->len; ++i)
1460     {
1461       GtkToolItemGroupInfo *info = g_ptr_array_index (palette->priv->groups, i);
1462       if ((gpointer) group == info->widget)
1463         return i;
1464     }
1465
1466   return -1;
1467 }
1468
1469 /**
1470  * gtk_tool_palette_get_exclusive:
1471  * @palette: a #GtkToolPalette
1472  * @group: a #GtkToolItemGroup which is a child of palette
1473  *
1474  * Gets whether @group is exclusive or not.
1475  * See gtk_tool_palette_set_exclusive().
1476  *
1477  * Returns: %TRUE if @group is exclusive
1478  *
1479  * Since: 2.20
1480  */
1481 gboolean
1482 gtk_tool_palette_get_exclusive (GtkToolPalette *palette,
1483                                 GtkWidget      *group)
1484 {
1485   gint position;
1486   GtkToolItemGroupInfo *info;
1487
1488   g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), DEFAULT_CHILD_EXCLUSIVE);
1489   g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (group), DEFAULT_CHILD_EXCLUSIVE);
1490
1491   position = gtk_tool_palette_get_group_position (palette, group);
1492   g_return_val_if_fail (position >= 0, DEFAULT_CHILD_EXCLUSIVE);
1493
1494   info = g_ptr_array_index (palette->priv->groups, position);
1495
1496   return info->exclusive;
1497 }
1498
1499 /**
1500  * gtk_tool_palette_get_expand:
1501  * @palette: a #GtkToolPalette
1502  * @group: a #GtkToolItemGroup which is a child of palette
1503  *
1504  * Gets whether group should be given extra space.
1505  * See gtk_tool_palette_set_expand().
1506  *
1507  * Returns: %TRUE if group should be given extra space, %FALSE otherwise
1508  *
1509  * Since: 2.20
1510  */
1511 gboolean
1512 gtk_tool_palette_get_expand (GtkToolPalette *palette,
1513                              GtkWidget      *group)
1514 {
1515   gint position;
1516   GtkToolItemGroupInfo *info;
1517
1518   g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), DEFAULT_CHILD_EXPAND);
1519   g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (group), DEFAULT_CHILD_EXPAND);
1520
1521   position = gtk_tool_palette_get_group_position (palette, group);
1522   g_return_val_if_fail (position >= 0, DEFAULT_CHILD_EXPAND);
1523
1524   info = g_ptr_array_index (palette->priv->groups, position);
1525
1526   return info->expand;
1527 }
1528
1529 /**
1530  * gtk_tool_palette_get_drop_item:
1531  * @palette: a #GtkToolPalette
1532  * @x: the x position
1533  * @y: the y position
1534  *
1535  * Gets the item at position (x, y).
1536  * See gtk_tool_palette_get_drop_group().
1537  *
1538  * Returns: the #GtkToolItem at position or %NULL if there is no such item
1539  *
1540  * Since: 2.20
1541  */
1542 GtkToolItem*
1543 gtk_tool_palette_get_drop_item (GtkToolPalette *palette,
1544                                 gint            x,
1545                                 gint            y)
1546 {
1547   GtkWidget *group = gtk_tool_palette_get_drop_group (palette, x, y);
1548
1549   if (group)
1550     return gtk_tool_item_group_get_drop_item (GTK_TOOL_ITEM_GROUP (group),
1551                                               x - group->allocation.x,
1552                                               y - group->allocation.y);
1553
1554   return NULL;
1555 }
1556
1557 /**
1558  * gtk_tool_palette_get_drop_group:
1559  * @palette: a #GtkToolPalette
1560  * @x: the x position
1561  * @y: the y position
1562  *
1563  * Gets the group at position (x, y).
1564  *
1565  * Returns: the #GtkToolItemGroup at position or %NULL
1566  *     if there is no such group
1567  *
1568  * Since: 2.20
1569  */
1570 GtkWidget*
1571 gtk_tool_palette_get_drop_group (GtkToolPalette *palette,
1572                                  gint            x,
1573                                  gint            y)
1574 {
1575   GtkAllocation *allocation;
1576   guint i;
1577
1578   g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), NULL);
1579
1580   allocation = &GTK_WIDGET (palette)->allocation;
1581
1582   g_return_val_if_fail (x >= 0 && x < allocation->width, NULL);
1583   g_return_val_if_fail (y >= 0 && y < allocation->height, NULL);
1584
1585   for (i = 0; i < palette->priv->groups->len; ++i)
1586     {
1587       GtkToolItemGroupInfo *group = g_ptr_array_index (palette->priv->groups, i);
1588       GtkWidget *widget;
1589       gint x0, y0;
1590
1591       if (!group->widget)
1592         continue;
1593
1594       widget = GTK_WIDGET (group->widget);
1595
1596       x0 = x - widget->allocation.x;
1597       y0 = y - widget->allocation.y;
1598
1599       if (x0 >= 0 && x0 < widget->allocation.width &&
1600           y0 >= 0 && y0 < widget->allocation.height)
1601         return widget;
1602     }
1603
1604   return NULL;
1605 }
1606
1607 /**
1608  * gtk_tool_palette_get_drag_item:
1609  * @palette: a #GtkToolPalette
1610  * @selection: a #GtkSelectionData
1611  *
1612  * Get the dragged item from the selection.
1613  * This could be a #GtkToolItem or a #GtkToolItemGroup.
1614  *
1615  * Returns: the dragged item in selection
1616  *
1617  * Since: 2.20
1618  */
1619 GtkWidget*
1620 gtk_tool_palette_get_drag_item (GtkToolPalette         *palette,
1621                                 const GtkSelectionData *selection)
1622 {
1623   GtkToolPaletteDragData *data;
1624
1625   g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), NULL);
1626   g_return_val_if_fail (NULL != selection, NULL);
1627
1628   g_return_val_if_fail (selection->format == 8, NULL);
1629   g_return_val_if_fail (selection->length == sizeof (GtkToolPaletteDragData), NULL);
1630   g_return_val_if_fail (selection->target == dnd_target_atom_item ||
1631                         selection->target == dnd_target_atom_group,
1632                         NULL);
1633
1634   data = (GtkToolPaletteDragData*) selection->data;
1635
1636   g_return_val_if_fail (data->palette == palette, NULL);
1637
1638   if (dnd_target_atom_item == selection->target)
1639     g_return_val_if_fail (GTK_IS_TOOL_ITEM (data->item), NULL);
1640   else if (dnd_target_atom_group == selection->target)
1641     g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (data->item), NULL);
1642
1643   return data->item;
1644 }
1645
1646 /**
1647  * gtk_tool_palette_set_drag_source:
1648  * @palette: a #GtkToolPalette
1649  * @targets: the #GtkToolPaletteDragTarget<!-- -->s
1650  *     which the widget should support
1651  *
1652  * Sets the tool palette as a drag source.
1653  * Enables all groups and items in the tool palette as drag sources
1654  * on button 1 and button 3 press with copy and move actions.
1655  * See gtk_drag_source_set().
1656  *
1657  * Since: 2.20
1658  */
1659 void
1660 gtk_tool_palette_set_drag_source (GtkToolPalette            *palette,
1661                                   GtkToolPaletteDragTargets  targets)
1662 {
1663   guint i;
1664
1665   g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
1666
1667   if ((palette->priv->drag_source & targets) == targets)
1668     return;
1669
1670   palette->priv->drag_source |= targets;
1671
1672   for (i = 0; i < palette->priv->groups->len; ++i)
1673     {
1674       GtkToolItemGroupInfo *info = g_ptr_array_index (palette->priv->groups, i);
1675       if (info->widget)
1676         gtk_container_forall (GTK_CONTAINER (info->widget),
1677                               _gtk_tool_palette_child_set_drag_source,
1678                               palette);
1679     }
1680 }
1681
1682 /**
1683  * gtk_tool_palette_add_drag_dest:
1684  * @palette: a #GtkToolPalette
1685  * @widget: a #GtkWidget which should be a drag destination for @palette
1686  * @flags: the flags that specify what actions GTK+ should take for drops
1687  *     on that widget
1688  * @targets: the #GtkToolPaletteDragTarget<!-- -->s which the widget
1689  *     should support
1690  * @actions: the #GdkDragAction<!-- -->s which the widget should suppport
1691  *
1692  * Sets @palette as drag source (see gtk_tool_palette_set_drag_source())
1693  * and sets @widget as a drag destination for drags from @palette.
1694  * See gtk_drag_dest_set().
1695  *
1696  * Since: 2.20
1697  */
1698 void
1699 gtk_tool_palette_add_drag_dest (GtkToolPalette            *palette,
1700                                 GtkWidget                 *widget,
1701                                 GtkDestDefaults            flags,
1702                                 GtkToolPaletteDragTargets  targets,
1703                                 GdkDragAction              actions)
1704 {
1705   GtkTargetEntry entries[G_N_ELEMENTS (dnd_targets)];
1706   gint n_entries = 0;
1707
1708   g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
1709   g_return_if_fail (GTK_IS_WIDGET (widget));
1710
1711   gtk_tool_palette_set_drag_source (palette,
1712                                     targets);
1713
1714   if (targets & GTK_TOOL_PALETTE_DRAG_ITEMS)
1715     entries[n_entries++] = dnd_targets[0];
1716   if (targets & GTK_TOOL_PALETTE_DRAG_GROUPS)
1717     entries[n_entries++] = dnd_targets[1];
1718
1719   gtk_drag_dest_set (widget, flags, entries, n_entries, actions);
1720 }
1721
1722 void
1723 _gtk_tool_palette_get_item_size (GtkToolPalette *palette,
1724                                  GtkRequisition *item_size,
1725                                  gboolean        homogeneous_only,
1726                                  gint           *requested_rows)
1727 {
1728   GtkRequisition max_requisition;
1729   gint max_rows;
1730   guint i;
1731
1732   g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
1733   g_return_if_fail (NULL != item_size);
1734
1735   max_requisition.width = 0;
1736   max_requisition.height = 0;
1737   max_rows = 0;
1738
1739   /* iterate over all groups and calculate the max item_size and max row request */
1740   for (i = 0; i < palette->priv->groups->len; ++i)
1741     {
1742       GtkRequisition requisition;
1743       gint rows;
1744       GtkToolItemGroupInfo *group = g_ptr_array_index (palette->priv->groups, i);
1745
1746       if (!group->widget)
1747         continue;
1748
1749       _gtk_tool_item_group_item_size_request (group->widget, &requisition, homogeneous_only, &rows);
1750
1751       max_requisition.width = MAX (max_requisition.width, requisition.width);
1752       max_requisition.height = MAX (max_requisition.height, requisition.height);
1753       max_rows = MAX (max_rows, rows);
1754     }
1755
1756   *item_size = max_requisition;
1757   if (requested_rows)
1758     *requested_rows = max_rows;
1759 }
1760
1761 static void
1762 gtk_tool_palette_item_drag_data_get (GtkWidget        *widget,
1763                                      GdkDragContext   *context,
1764                                      GtkSelectionData *selection,
1765                                      guint             info,
1766                                      guint             time,
1767                                      gpointer          data)
1768 {
1769   GtkToolPaletteDragData drag_data = { GTK_TOOL_PALETTE (data), NULL };
1770
1771   if (selection->target == dnd_target_atom_item)
1772     drag_data.item = gtk_widget_get_ancestor (widget, GTK_TYPE_TOOL_ITEM);
1773
1774   if (drag_data.item)
1775     gtk_selection_data_set (selection, selection->target, 8,
1776                             (guchar*) &drag_data, sizeof (drag_data));
1777 }
1778
1779 static void
1780 gtk_tool_palette_child_drag_data_get (GtkWidget        *widget,
1781                                       GdkDragContext   *context,
1782                                       GtkSelectionData *selection,
1783                                       guint             info,
1784                                       guint             time,
1785                                       gpointer          data)
1786 {
1787   GtkToolPaletteDragData drag_data = { GTK_TOOL_PALETTE (data), NULL };
1788
1789   if (selection->target == dnd_target_atom_group)
1790     drag_data.item = gtk_widget_get_ancestor (widget, GTK_TYPE_TOOL_ITEM_GROUP);
1791
1792   if (drag_data.item)
1793     gtk_selection_data_set (selection, selection->target, 8,
1794                             (guchar*) &drag_data, sizeof (drag_data));
1795 }
1796
1797 void
1798 _gtk_tool_palette_child_set_drag_source (GtkWidget *child,
1799                                          gpointer   data)
1800 {
1801   GtkToolPalette *palette = GTK_TOOL_PALETTE (data);
1802
1803   /* Check drag_source,
1804    * to work properly when called from gtk_tool_item_group_insert().
1805    */
1806   if (!palette->priv->drag_source)
1807     return;
1808
1809   if (GTK_IS_TOOL_ITEM (child) &&
1810       (palette->priv->drag_source & GTK_TOOL_PALETTE_DRAG_ITEMS))
1811     {
1812       /* Connect to child instead of the item itself,
1813        * to work arround bug 510377.
1814        */
1815       if (GTK_IS_TOOL_BUTTON (child))
1816         child = gtk_bin_get_child (GTK_BIN (child));
1817
1818       if (!child)
1819         return;
1820
1821       gtk_drag_source_set (child, GDK_BUTTON1_MASK | GDK_BUTTON3_MASK,
1822                            &dnd_targets[0], 1, GDK_ACTION_COPY | GDK_ACTION_MOVE);
1823
1824       g_signal_connect (child, "drag-data-get",
1825                         G_CALLBACK (gtk_tool_palette_item_drag_data_get),
1826                         palette);
1827     }
1828   else if (GTK_IS_BUTTON (child) &&
1829            (palette->priv->drag_source & GTK_TOOL_PALETTE_DRAG_GROUPS))
1830     {
1831       gtk_drag_source_set (child, GDK_BUTTON1_MASK | GDK_BUTTON3_MASK,
1832                            &dnd_targets[1], 1, GDK_ACTION_COPY | GDK_ACTION_MOVE);
1833
1834       g_signal_connect (child, "drag-data-get",
1835                         G_CALLBACK (gtk_tool_palette_child_drag_data_get),
1836                         palette);
1837     }
1838 }
1839
1840 /**
1841  * gtk_tool_palette_get_drag_target_item:
1842  *
1843  * Gets the target entry for a dragged #GtkToolItem.
1844  *
1845  * Returns: the #GtkTargetEntry for a dragged item.
1846  *
1847  * Since: 2.20
1848  */
1849 G_CONST_RETURN GtkTargetEntry*
1850 gtk_tool_palette_get_drag_target_item (void)
1851 {
1852   return &dnd_targets[0];
1853 }
1854
1855 /**
1856  * gtk_tool_palette_get_drag_target_group:
1857  *
1858  * Get the target entry for a dragged #GtkToolItemGroup.
1859  *
1860  * Returns: the #GtkTargetEntry for a dragged group
1861  *
1862  * Since: 2.20
1863  */
1864 G_CONST_RETURN GtkTargetEntry*
1865 gtk_tool_palette_get_drag_target_group (void)
1866 {
1867   return &dnd_targets[1];
1868 }
1869
1870 void
1871 _gtk_tool_palette_set_expanding_child (GtkToolPalette *palette,
1872                                        GtkWidget      *widget)
1873 {
1874   g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
1875   palette->priv->expanding_child = widget;
1876 }
1877
1878 /**
1879  * gtk_tool_palette_get_hadjustment:
1880  * @palette: a #GtkToolPalette
1881  *
1882  * Gets the horizontal adjustment of the tool palette.
1883  *
1884  * Returns: the horizontal adjustment of @palette
1885  *
1886  * Since: 2.20
1887  */
1888 GtkAdjustment*
1889 gtk_tool_palette_get_hadjustment (GtkToolPalette *palette)
1890 {
1891   g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), NULL);
1892
1893   return palette->priv->hadjustment;
1894 }
1895
1896 /**
1897  * gtk_tool_palette_get_vadjustment:
1898  * @palette: a #GtkToolPalette
1899  *
1900  * Gets the vertical adjustment of the tool palette.
1901  *
1902  * Returns: the vertical adjustment of @palette
1903  *
1904  * Since: 2.20
1905  */
1906 GtkAdjustment*
1907 gtk_tool_palette_get_vadjustment (GtkToolPalette *palette)
1908 {
1909   g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), NULL);
1910
1911   return palette->priv->vadjustment;
1912 }
1913
1914 GtkSizeGroup *
1915 _gtk_tool_palette_get_size_group (GtkToolPalette *palette)
1916 {
1917   g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), NULL);
1918
1919   return palette->priv->text_size_group;
1920 }
1921
1922
1923 #define __GTK_TOOL_PALETTE_C__
1924 #include "gtkaliasdef.c"