gtk2/gtk/gtktoolpalette.c
Murray Cumming f91c04e284 Minor documentation improvements
Mostly correcting it's to its and changing some , to .
2011-02-23 10:26:21 +01:00

2051 lines
60 KiB
C

/* GtkToolPalette -- A tool palette with categories and DnD support
* Copyright (C) 2008 Openismus GmbH
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*
* Authors:
* Mathias Hasselmann
*/
#include "config.h"
#include <string.h>
#include <gtk/gtk.h>
#include "gtktoolpaletteprivate.h"
#include "gtkmarshalers.h"
#include "gtktypebuiltins.h"
#include "gtkprivate.h"
#include "gtkscrollable.h"
#include "gtkorientableprivate.h"
#include "gtkintl.h"
#define DEFAULT_ICON_SIZE GTK_ICON_SIZE_SMALL_TOOLBAR
#define DEFAULT_ORIENTATION GTK_ORIENTATION_VERTICAL
#define DEFAULT_TOOLBAR_STYLE GTK_TOOLBAR_ICONS
#define DEFAULT_CHILD_EXCLUSIVE FALSE
#define DEFAULT_CHILD_EXPAND FALSE
/**
* SECTION:gtktoolpalette
* @Short_description: A tool palette with categories
* @Title: GtkToolPalette
*
* A #GtkToolPalette allows you to add #GtkToolItem<!-- -->s to a palette-like
* container with different categories and drag and drop support.
*
* A #GtkToolPalette is created with a call to gtk_tool_palette_new().
*
* #GtkToolItem<!-- -->s cannot be added directly to a #GtkToolPalette -
* instead they are added to a #GtkToolItemGroup which can than be added
* to a #GtkToolPalette. To add a #GtkToolItemGroup to a #GtkToolPalette,
* use gtk_container_add().
*
* |[
* GtkWidget *palette, *group;
* GtkToolItem *item;
*
* palette = gtk_tool_palette_new ();
* group = gtk_tool_item_group_new (_("Test Category"));
* gtk_container_add (GTK_CONTAINER (palette), group);
*
* item = gtk_tool_button_new_from_stock (GTK_STOCK_OK);
* gtk_tool_item_group_insert (GTK_TOOL_ITEM_GROUP (group), item, -1);
* ]|
*
* The easiest way to use drag and drop with #GtkToolPalette is to call
* gtk_tool_palette_add_drag_dest() with the desired drag source @palette
* and the desired drag target @widget. Then gtk_tool_palette_get_drag_item()
* can be used to get the dragged item in the #GtkWidget::drag-data-received
* signal handler of the drag target.
*
* |[
* static void
* passive_canvas_drag_data_received (GtkWidget *widget,
* GdkDragContext *context,
* gint x,
* gint y,
* GtkSelectionData *selection,
* guint info,
* guint time,
* gpointer data)
* {
* GtkWidget *palette;
* GtkWidget *item;
*
* /<!-- -->* Get the dragged item *<!-- -->/
* palette = gtk_widget_get_ancestor (gtk_drag_get_source_widget (context),
* GTK_TYPE_TOOL_PALETTE);
* if (palette != NULL)
* item = gtk_tool_palette_get_drag_item (GTK_TOOL_PALETTE (palette),
* selection);
*
* /<!-- -->* Do something with item *<!-- -->/
* }
*
* GtkWidget *target, palette;
*
* palette = gtk_tool_palette_new ();
* target = gtk_drawing_area_new ();
*
* g_signal_connect (G_OBJECT (target), "drag-data-received",
* G_CALLBACK (passive_canvas_drag_data_received), NULL);
* gtk_tool_palette_add_drag_dest (GTK_TOOL_PALETTE (palette), target,
* GTK_DEST_DEFAULT_ALL,
* GTK_TOOL_PALETTE_DRAG_ITEMS,
* GDK_ACTION_COPY);
* ]|
*
* Since: 2.20
*/
typedef struct _GtkToolItemGroupInfo GtkToolItemGroupInfo;
typedef struct _GtkToolPaletteDragData GtkToolPaletteDragData;
enum
{
PROP_NONE,
PROP_ICON_SIZE,
PROP_ICON_SIZE_SET,
PROP_ORIENTATION,
PROP_TOOLBAR_STYLE,
PROP_HADJUSTMENT,
PROP_VADJUSTMENT,
PROP_HSCROLL_POLICY,
PROP_VSCROLL_POLICY
};
enum
{
CHILD_PROP_NONE,
CHILD_PROP_EXCLUSIVE,
CHILD_PROP_EXPAND,
};
struct _GtkToolItemGroupInfo
{
GtkToolItemGroup *widget;
gulong notify_collapsed;
guint pos;
guint exclusive : 1;
guint expand : 1;
};
struct _GtkToolPalettePrivate
{
GPtrArray* groups;
GtkAdjustment *hadjustment;
GtkAdjustment *vadjustment;
GtkIconSize icon_size;
gboolean icon_size_set;
GtkOrientation orientation;
GtkToolbarStyle style;
gboolean style_set;
GtkWidget *expanding_child;
GtkSizeGroup *text_size_group;
GtkSettings *settings;
gulong settings_connection;
guint drag_source : 2;
/* GtkScrollablePolicy needs to be checked when
* driving the scrollable adjustment values */
guint hscroll_policy : 1;
guint vscroll_policy : 1;
};
struct _GtkToolPaletteDragData
{
GtkToolPalette *palette;
GtkWidget *item;
};
static GdkAtom dnd_target_atom_item = GDK_NONE;
static GdkAtom dnd_target_atom_group = GDK_NONE;
static const GtkTargetEntry dnd_targets[] =
{
{ "application/x-gtk-tool-palette-item", GTK_TARGET_SAME_APP, 0 },
{ "application/x-gtk-tool-palette-group", GTK_TARGET_SAME_APP, 0 },
};
static void gtk_tool_palette_set_hadjustment (GtkToolPalette *palette,
GtkAdjustment *adjustment);
static void gtk_tool_palette_set_vadjustment (GtkToolPalette *palette,
GtkAdjustment *adjustment);
G_DEFINE_TYPE_WITH_CODE (GtkToolPalette,
gtk_tool_palette,
GTK_TYPE_CONTAINER,
G_IMPLEMENT_INTERFACE (GTK_TYPE_ORIENTABLE, NULL)
G_IMPLEMENT_INTERFACE (GTK_TYPE_SCROLLABLE, NULL))
static void
gtk_tool_palette_init (GtkToolPalette *palette)
{
palette->priv = G_TYPE_INSTANCE_GET_PRIVATE (palette,
GTK_TYPE_TOOL_PALETTE,
GtkToolPalettePrivate);
palette->priv->groups = g_ptr_array_sized_new (4);
g_ptr_array_set_free_func (palette->priv->groups, g_free);
palette->priv->icon_size = DEFAULT_ICON_SIZE;
palette->priv->icon_size_set = FALSE;
palette->priv->orientation = DEFAULT_ORIENTATION;
palette->priv->style = DEFAULT_TOOLBAR_STYLE;
palette->priv->style_set = FALSE;
palette->priv->text_size_group = gtk_size_group_new (GTK_SIZE_GROUP_BOTH);
}
static void
gtk_tool_palette_reconfigured (GtkToolPalette *palette)
{
guint i;
for (i = 0; i < palette->priv->groups->len; ++i)
{
GtkToolItemGroupInfo *info = g_ptr_array_index (palette->priv->groups, i);
if (info->widget)
_gtk_tool_item_group_palette_reconfigured (info->widget);
}
gtk_widget_queue_resize_no_redraw (GTK_WIDGET (palette));
}
static void
gtk_tool_palette_set_property (GObject *object,
guint prop_id,
const GValue *value,
GParamSpec *pspec)
{
GtkToolPalette *palette = GTK_TOOL_PALETTE (object);
switch (prop_id)
{
case PROP_ICON_SIZE:
if ((guint) g_value_get_enum (value) != palette->priv->icon_size)
{
palette->priv->icon_size = g_value_get_enum (value);
gtk_tool_palette_reconfigured (palette);
}
break;
case PROP_ICON_SIZE_SET:
if ((guint) g_value_get_enum (value) != palette->priv->icon_size)
{
palette->priv->icon_size_set = g_value_get_enum (value);
gtk_tool_palette_reconfigured (palette);
}
break;
case PROP_ORIENTATION:
if ((guint) g_value_get_enum (value) != palette->priv->orientation)
{
palette->priv->orientation = g_value_get_enum (value);
_gtk_orientable_set_style_classes (GTK_ORIENTABLE (palette));
gtk_tool_palette_reconfigured (palette);
}
break;
case PROP_TOOLBAR_STYLE:
if ((guint) g_value_get_enum (value) != palette->priv->style)
{
palette->priv->style = g_value_get_enum (value);
gtk_tool_palette_reconfigured (palette);
}
break;
case PROP_HADJUSTMENT:
gtk_tool_palette_set_hadjustment (palette, g_value_get_object (value));
break;
case PROP_VADJUSTMENT:
gtk_tool_palette_set_vadjustment (palette, g_value_get_object (value));
break;
case PROP_HSCROLL_POLICY:
palette->priv->hscroll_policy = g_value_get_enum (value);
gtk_widget_queue_resize (GTK_WIDGET (palette));
break;
case PROP_VSCROLL_POLICY:
palette->priv->vscroll_policy = g_value_get_enum (value);
gtk_widget_queue_resize (GTK_WIDGET (palette));
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
break;
}
}
static void
gtk_tool_palette_get_property (GObject *object,
guint prop_id,
GValue *value,
GParamSpec *pspec)
{
GtkToolPalette *palette = GTK_TOOL_PALETTE (object);
switch (prop_id)
{
case PROP_ICON_SIZE:
g_value_set_enum (value, gtk_tool_palette_get_icon_size (palette));
break;
case PROP_ICON_SIZE_SET:
g_value_set_boolean (value, palette->priv->icon_size_set);
break;
case PROP_ORIENTATION:
g_value_set_enum (value, palette->priv->orientation);
break;
case PROP_TOOLBAR_STYLE:
g_value_set_enum (value, gtk_tool_palette_get_style (palette));
break;
case PROP_HADJUSTMENT:
g_value_set_object (value, palette->priv->hadjustment);
break;
case PROP_VADJUSTMENT:
g_value_set_object (value, palette->priv->vadjustment);
break;
case PROP_HSCROLL_POLICY:
g_value_set_enum (value, palette->priv->hscroll_policy);
break;
case PROP_VSCROLL_POLICY:
g_value_set_enum (value, palette->priv->vscroll_policy);
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
break;
}
}
static void
gtk_tool_palette_dispose (GObject *object)
{
GtkToolPalette *palette = GTK_TOOL_PALETTE (object);
guint i;
if (palette->priv->hadjustment)
{
g_object_unref (palette->priv->hadjustment);
palette->priv->hadjustment = NULL;
}
if (palette->priv->vadjustment)
{
g_object_unref (palette->priv->vadjustment);
palette->priv->vadjustment = NULL;
}
for (i = 0; i < palette->priv->groups->len; ++i)
{
GtkToolItemGroupInfo *group = g_ptr_array_index (palette->priv->groups, i);
if (group->notify_collapsed)
{
g_signal_handler_disconnect (group->widget, group->notify_collapsed);
group->notify_collapsed = 0;
}
}
if (palette->priv->text_size_group)
{
g_object_unref (palette->priv->text_size_group);
palette->priv->text_size_group = NULL;
}
G_OBJECT_CLASS (gtk_tool_palette_parent_class)->dispose (object);
}
static void
gtk_tool_palette_finalize (GObject *object)
{
GtkToolPalette *palette = GTK_TOOL_PALETTE (object);
g_ptr_array_free (palette->priv->groups, TRUE);
G_OBJECT_CLASS (gtk_tool_palette_parent_class)->finalize (object);
}
static void
gtk_tool_palette_size_request (GtkWidget *widget,
GtkRequisition *requisition)
{
GtkToolPalette *palette = GTK_TOOL_PALETTE (widget);
GtkRequisition child_requisition;
guint border_width;
guint i;
border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
requisition->width = 0;
requisition->height = 0;
for (i = 0; i < palette->priv->groups->len; ++i)
{
GtkToolItemGroupInfo *group = g_ptr_array_index (palette->priv->groups, i);
if (!group->widget)
continue;
gtk_widget_get_preferred_size (GTK_WIDGET (group->widget),
&child_requisition, NULL);
if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
{
requisition->width = MAX (requisition->width, child_requisition.width);
requisition->height += child_requisition.height;
}
else
{
requisition->width += child_requisition.width;
requisition->height = MAX (requisition->height, child_requisition.height);
}
}
requisition->width += border_width * 2;
requisition->height += border_width * 2;
}
static void
gtk_tool_palette_get_preferred_width (GtkWidget *widget,
gint *minimum,
gint *natural)
{
GtkRequisition requisition;
gtk_tool_palette_size_request (widget, &requisition);
*minimum = *natural = requisition.width;
}
static void
gtk_tool_palette_get_preferred_height (GtkWidget *widget,
gint *minimum,
gint *natural)
{
GtkRequisition requisition;
gtk_tool_palette_size_request (widget, &requisition);
*minimum = *natural = requisition.height;
}
static void
gtk_tool_palette_size_allocate (GtkWidget *widget,
GtkAllocation *allocation)
{
GtkToolPalette *palette = GTK_TOOL_PALETTE (widget);
GtkAdjustment *adjustment = NULL;
GtkAllocation child_allocation;
gint n_expand_groups = 0;
gint remaining_space = 0;
gint expand_space = 0;
gint page_start, page_size = 0;
gint offset = 0;
guint i;
guint border_width;
gint min_offset = -1, max_offset = -1;
gint x;
gint *group_sizes = g_newa (gint, palette->priv->groups->len);
GtkTextDirection direction;
border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
direction = gtk_widget_get_direction (widget);
GTK_WIDGET_CLASS (gtk_tool_palette_parent_class)->size_allocate (widget, allocation);
if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
{
adjustment = palette->priv->vadjustment;
page_size = allocation->height;
}
else
{
adjustment = palette->priv->hadjustment;
page_size = allocation->width;
}
if (adjustment)
offset = gtk_adjustment_get_value (adjustment);
if (GTK_ORIENTATION_HORIZONTAL == palette->priv->orientation &&
GTK_TEXT_DIR_RTL == direction)
offset = -offset;
if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
child_allocation.width = allocation->width - border_width * 2;
else
child_allocation.height = allocation->height - border_width * 2;
if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
remaining_space = allocation->height;
else
remaining_space = allocation->width;
/* figure out the required size of all groups to be able to distribute the
* remaining space on allocation
*/
for (i = 0; i < palette->priv->groups->len; ++i)
{
GtkToolItemGroupInfo *group = g_ptr_array_index (palette->priv->groups, i);
gint size;
if (!group->widget)
continue;
widget = GTK_WIDGET (group->widget);
if (gtk_tool_item_group_get_n_items (group->widget))
{
if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
size = _gtk_tool_item_group_get_height_for_width (group->widget, child_allocation.width);
else
size = _gtk_tool_item_group_get_width_for_height (group->widget, child_allocation.height);
if (group->expand && !gtk_tool_item_group_get_collapsed (group->widget))
n_expand_groups += 1;
}
else
size = 0;
remaining_space -= size;
group_sizes[i] = size;
/* if the widget is currently expanding an offset which allows to
* display as much of the widget as possible is calculated
*/
if (widget == palette->priv->expanding_child)
{
gint limit =
GTK_ORIENTATION_VERTICAL == palette->priv->orientation ?
child_allocation.width : child_allocation.height;
gint real_size;
guint j;
min_offset = 0;
for (j = 0; j < i; ++j)
min_offset += group_sizes[j];
max_offset = min_offset + group_sizes[i];
real_size = _gtk_tool_item_group_get_size_for_limit
(GTK_TOOL_ITEM_GROUP (widget), limit,
GTK_ORIENTATION_VERTICAL == palette->priv->orientation,
FALSE);
if (size == real_size)
palette->priv->expanding_child = NULL;
}
}
if (n_expand_groups > 0)
{
remaining_space = MAX (0, remaining_space);
expand_space = remaining_space / n_expand_groups;
}
if (max_offset != -1)
{
gint limit =
GTK_ORIENTATION_VERTICAL == palette->priv->orientation ?
allocation->height : allocation->width;
offset = MIN (MAX (offset, max_offset - limit), min_offset);
}
if (remaining_space > 0)
offset = 0;
x = border_width;
child_allocation.y = border_width;
if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
child_allocation.y -= offset;
else
x -= offset;
/* allocate all groups at the calculated positions */
for (i = 0; i < palette->priv->groups->len; ++i)
{
GtkToolItemGroupInfo *group = g_ptr_array_index (palette->priv->groups, i);
GtkWidget *widget;
if (!group->widget)
continue;
widget = GTK_WIDGET (group->widget);
if (gtk_tool_item_group_get_n_items (group->widget))
{
gint size = group_sizes[i];
if (group->expand && !gtk_tool_item_group_get_collapsed (group->widget))
{
size += MIN (expand_space, remaining_space);
remaining_space -= expand_space;
}
if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
child_allocation.height = size;
else
child_allocation.width = size;
if (GTK_ORIENTATION_HORIZONTAL == palette->priv->orientation &&
GTK_TEXT_DIR_RTL == direction)
child_allocation.x = allocation->width - x - child_allocation.width;
else
child_allocation.x = x;
gtk_widget_size_allocate (widget, &child_allocation);
gtk_widget_show (widget);
if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
child_allocation.y += child_allocation.height;
else
x += child_allocation.width;
}
else
gtk_widget_hide (widget);
}
if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation)
{
child_allocation.y += border_width;
child_allocation.y += offset;
page_start = child_allocation.y;
}
else
{
x += border_width;
x += offset;
page_start = x;
}
/* update the scrollbar to match the displayed adjustment */
if (adjustment)
{
gdouble value, lower, upper;
if (GTK_ORIENTATION_VERTICAL == palette->priv->orientation ||
GTK_TEXT_DIR_LTR == direction)
{
lower = 0;
upper = MAX (0, page_start);
value = MIN (offset, upper - page_size);
gtk_adjustment_clamp_page (adjustment, value, offset + page_size);
}
else
{
lower = page_size - MAX (0, page_start);
upper = page_size;
offset = -offset;
value = MAX (offset, lower);
gtk_adjustment_clamp_page (adjustment, offset, value + page_size);
}
gtk_adjustment_configure (adjustment,
value,
lower,
upper,
page_size * 0.1,
page_size * 0.9,
page_size);
}
}
static gboolean
gtk_tool_palette_draw (GtkWidget *widget,
cairo_t *cr)
{
GtkToolPalette *palette = GTK_TOOL_PALETTE (widget);
GdkDisplay *display;
GdkWindow *window;
guint i;
window = gtk_widget_get_window (widget);
display = gdk_window_get_display (window);
if (!gdk_display_supports_composite (display))
return FALSE;
cairo_push_group (cr);
for (i = 0; i < palette->priv->groups->len; ++i)
{
GtkToolItemGroupInfo *info = g_ptr_array_index (palette->priv->groups, i);
if (info->widget)
_gtk_tool_item_group_paint (info->widget, cr);
}
cairo_pop_group_to_source (cr);
cairo_paint (cr);
return FALSE;
}
static void
gtk_tool_palette_realize (GtkWidget *widget)
{
GtkAllocation allocation;
GdkWindow *window;
GdkWindowAttr attributes;
gint attributes_mask;
guint border_width;
gtk_widget_set_realized (widget, TRUE);
border_width = gtk_container_get_border_width (GTK_CONTAINER (widget));
gtk_widget_get_allocation (widget, &allocation);
attributes.window_type = GDK_WINDOW_CHILD;
attributes.x = allocation.x + border_width;
attributes.y = allocation.y + border_width;
attributes.width = allocation.width - border_width * 2;
attributes.height = allocation.height - border_width * 2;
attributes.wclass = GDK_INPUT_OUTPUT;
attributes.visual = gtk_widget_get_visual (widget);
attributes.event_mask = gtk_widget_get_events (widget)
| GDK_VISIBILITY_NOTIFY_MASK | GDK_EXPOSURE_MASK
| GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK
| GDK_BUTTON_MOTION_MASK;
attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL;
window = gdk_window_new (gtk_widget_get_parent_window (widget),
&attributes, attributes_mask);
gtk_widget_set_window (widget, window);
gdk_window_set_user_data (window, widget);
gtk_style_context_set_background (gtk_widget_get_style_context (widget),
window);
gtk_container_forall (GTK_CONTAINER (widget),
(GtkCallback) gtk_widget_set_parent_window,
window);
gtk_widget_queue_resize_no_redraw (widget);
}
static void
gtk_tool_palette_adjustment_value_changed (GtkAdjustment *adjustment,
gpointer data)
{
GtkAllocation allocation;
GtkWidget *widget = GTK_WIDGET (data);
gtk_widget_get_allocation (widget, &allocation);
gtk_tool_palette_size_allocate (widget, &allocation);
}
static void
gtk_tool_palette_add (GtkContainer *container,
GtkWidget *child)
{
GtkToolPalette *palette;
GtkToolItemGroupInfo *info = g_new0(GtkToolItemGroupInfo, 1);
g_return_if_fail (GTK_IS_TOOL_PALETTE (container));
g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (child));
palette = GTK_TOOL_PALETTE (container);
g_ptr_array_add (palette->priv->groups, info);
info->pos = palette->priv->groups->len - 1;
info->widget = g_object_ref_sink (child);
gtk_widget_set_parent (child, GTK_WIDGET (palette));
}
static void
gtk_tool_palette_remove (GtkContainer *container,
GtkWidget *child)
{
GtkToolPalette *palette;
guint i;
g_return_if_fail (GTK_IS_TOOL_PALETTE (container));
palette = GTK_TOOL_PALETTE (container);
for (i = 0; i < palette->priv->groups->len; ++i)
{
GtkToolItemGroupInfo *info = g_ptr_array_index (palette->priv->groups, i);
if (GTK_WIDGET(info->widget) == child)
{
g_object_unref (child);
gtk_widget_unparent (child);
g_ptr_array_remove_index (palette->priv->groups, i);
}
}
}
static void
gtk_tool_palette_forall (GtkContainer *container,
gboolean internals,
GtkCallback callback,
gpointer callback_data)
{
GtkToolPalette *palette = GTK_TOOL_PALETTE (container);
guint i, len;
for (i = 0; i < palette->priv->groups->len; ++i)
{
GtkToolItemGroupInfo *info = g_ptr_array_index (palette->priv->groups, i);
len = palette->priv->groups->len;
if (info->widget)
callback (GTK_WIDGET (info->widget),
callback_data);
/* At destroy time, 'callback' results in removing a widget,
* here we just reset the current index to account for the removed widget. */
i -= (len - palette->priv->groups->len);
}
}
static GType
gtk_tool_palette_child_type (GtkContainer *container)
{
return GTK_TYPE_TOOL_ITEM_GROUP;
}
static void
gtk_tool_palette_set_child_property (GtkContainer *container,
GtkWidget *child,
guint prop_id,
const GValue *value,
GParamSpec *pspec)
{
GtkToolPalette *palette = GTK_TOOL_PALETTE (container);
switch (prop_id)
{
case CHILD_PROP_EXCLUSIVE:
gtk_tool_palette_set_exclusive (palette, GTK_TOOL_ITEM_GROUP (child),
g_value_get_boolean (value));
break;
case CHILD_PROP_EXPAND:
gtk_tool_palette_set_expand (palette, GTK_TOOL_ITEM_GROUP (child),
g_value_get_boolean (value));
break;
default:
GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, prop_id, pspec);
break;
}
}
static void
gtk_tool_palette_get_child_property (GtkContainer *container,
GtkWidget *child,
guint prop_id,
GValue *value,
GParamSpec *pspec)
{
GtkToolPalette *palette = GTK_TOOL_PALETTE (container);
switch (prop_id)
{
case CHILD_PROP_EXCLUSIVE:
g_value_set_boolean (value,
gtk_tool_palette_get_exclusive (palette, GTK_TOOL_ITEM_GROUP (child)));
break;
case CHILD_PROP_EXPAND:
g_value_set_boolean (value,
gtk_tool_palette_get_expand (palette, GTK_TOOL_ITEM_GROUP (child)));
break;
default:
GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID (container, prop_id, pspec);
break;
}
}
static void
style_change_notify (GtkToolPalette *palette)
{
GtkToolPalettePrivate* priv = palette->priv;
if (!priv->style_set)
{
/* pretend it was set, then unset, thus reverting to new default */
priv->style_set = TRUE;
gtk_tool_palette_unset_style (palette);
}
}
static void
icon_size_change_notify (GtkToolPalette *palette)
{
GtkToolPalettePrivate* priv = palette->priv;
if (!priv->icon_size_set)
{
/* pretend it was set, then unset, thus reverting to new default */
priv->icon_size_set = TRUE;
gtk_tool_palette_unset_icon_size (palette);
}
}
static void
gtk_tool_palette_settings_change_notify (GtkSettings *settings,
const GParamSpec *pspec,
GtkToolPalette *palette)
{
if (strcmp (pspec->name, "gtk-toolbar-style") == 0)
style_change_notify (palette);
else if (strcmp (pspec->name, "gtk-toolbar-icon-size") == 0)
icon_size_change_notify (palette);
}
static void
gtk_tool_palette_screen_changed (GtkWidget *widget,
GdkScreen *previous_screen)
{
GtkToolPalette *palette = GTK_TOOL_PALETTE (widget);
GtkToolPalettePrivate* priv = palette->priv;
GtkSettings *old_settings = priv->settings;
GtkSettings *settings;
if (gtk_widget_has_screen (GTK_WIDGET (palette)))
settings = gtk_widget_get_settings (GTK_WIDGET (palette));
else
settings = NULL;
if (settings == old_settings)
return;
if (old_settings)
{
g_signal_handler_disconnect (old_settings, priv->settings_connection);
g_object_unref (old_settings);
}
if (settings)
{
priv->settings_connection =
g_signal_connect (settings, "notify",
G_CALLBACK (gtk_tool_palette_settings_change_notify),
palette);
priv->settings = g_object_ref (settings);
}
else
priv->settings = NULL;
gtk_tool_palette_reconfigured (palette);
}
static void
gtk_tool_palette_class_init (GtkToolPaletteClass *cls)
{
GObjectClass *oclass = G_OBJECT_CLASS (cls);
GtkWidgetClass *wclass = GTK_WIDGET_CLASS (cls);
GtkContainerClass *cclass = GTK_CONTAINER_CLASS (cls);
oclass->set_property = gtk_tool_palette_set_property;
oclass->get_property = gtk_tool_palette_get_property;
oclass->dispose = gtk_tool_palette_dispose;
oclass->finalize = gtk_tool_palette_finalize;
wclass->get_preferred_width = gtk_tool_palette_get_preferred_width;
wclass->get_preferred_height= gtk_tool_palette_get_preferred_height;
wclass->size_allocate = gtk_tool_palette_size_allocate;
wclass->draw = gtk_tool_palette_draw;
wclass->realize = gtk_tool_palette_realize;
cclass->add = gtk_tool_palette_add;
cclass->remove = gtk_tool_palette_remove;
cclass->forall = gtk_tool_palette_forall;
cclass->child_type = gtk_tool_palette_child_type;
cclass->set_child_property = gtk_tool_palette_set_child_property;
cclass->get_child_property = gtk_tool_palette_get_child_property;
/* Handle screen-changed so we can update our GtkSettings.
*/
wclass->screen_changed = gtk_tool_palette_screen_changed;
g_object_class_override_property (oclass, PROP_ORIENTATION, "orientation");
g_object_class_override_property (oclass, PROP_HADJUSTMENT, "hadjustment");
g_object_class_override_property (oclass, PROP_VADJUSTMENT, "vadjustment");
g_object_class_override_property (oclass, PROP_HSCROLL_POLICY, "hscroll-policy");
g_object_class_override_property (oclass, PROP_VSCROLL_POLICY, "vscroll-policy");
/**
* GtkToolPalette:icon-size:
*
* The size of the icons in a tool palette is normally determined by
* the #GtkSettings:toolbar-icon-size setting. When this property is set,
* it overrides the setting.
*
* This should only be used for special-purpose tool palettes, normal
* application tool palettes should respect the user preferences for the
* size of icons.
*
* Since: 2.20
*/
g_object_class_install_property (oclass,
PROP_ICON_SIZE,
g_param_spec_enum ("icon-size",
P_("Icon size"),
P_("Size of icons in this tool palette"),
GTK_TYPE_ICON_SIZE,
DEFAULT_ICON_SIZE,
GTK_PARAM_READWRITE));
/**
* GtkToolPalette:icon-size-set:
*
* Is %TRUE if the #GtkToolPalette:icon-size property has been set.
*
* Since: 2.20
*/
g_object_class_install_property (oclass,
PROP_ICON_SIZE_SET,
g_param_spec_boolean ("icon-size-set",
P_("Icon size set"),
P_("Whether the icon-size property has been set"),
FALSE,
GTK_PARAM_READWRITE));
/**
* GtkToolPalette:toolbar-style:
*
* The style of items in the tool palette.
*
* Since: 2.20
*/
g_object_class_install_property (oclass, PROP_TOOLBAR_STYLE,
g_param_spec_enum ("toolbar-style",
P_("Toolbar Style"),
P_("Style of items in the tool palette"),
GTK_TYPE_TOOLBAR_STYLE,
DEFAULT_TOOLBAR_STYLE,
GTK_PARAM_READWRITE));
/**
* GtkToolPalette:exclusive:
*
* Whether the item group should be the only one that is expanded
* at a given time.
*
* Since: 2.20
*/
gtk_container_class_install_child_property (cclass, CHILD_PROP_EXCLUSIVE,
g_param_spec_boolean ("exclusive",
P_("Exclusive"),
P_("Whether the item group should be the only expanded at a given time"),
DEFAULT_CHILD_EXCLUSIVE,
GTK_PARAM_READWRITE));
/**
* GtkToolPalette:expand:
*
* Whether the item group should receive extra space when the palette grows.
* at a given time.
*
* Since: 2.20
*/
gtk_container_class_install_child_property (cclass, CHILD_PROP_EXPAND,
g_param_spec_boolean ("expand",
P_("Expand"),
P_("Whether the item group should receive extra space when the palette grows"),
DEFAULT_CHILD_EXPAND,
GTK_PARAM_READWRITE));
g_type_class_add_private (cls, sizeof (GtkToolPalettePrivate));
dnd_target_atom_item = gdk_atom_intern_static_string (dnd_targets[0].target);
dnd_target_atom_group = gdk_atom_intern_static_string (dnd_targets[1].target);
}
/**
* gtk_tool_palette_new:
*
* Creates a new tool palette.
*
* Returns: a new #GtkToolPalette
*
* Since: 2.20
*/
GtkWidget*
gtk_tool_palette_new (void)
{
return g_object_new (GTK_TYPE_TOOL_PALETTE, NULL);
}
/**
* gtk_tool_palette_set_icon_size:
* @palette: a #GtkToolPalette
* @icon_size: (type int): the #GtkIconSize that icons in the tool
* palette shall have
*
* Sets the size of icons in the tool palette.
*
* Since: 2.20
*/
void
gtk_tool_palette_set_icon_size (GtkToolPalette *palette,
GtkIconSize icon_size)
{
GtkToolPalettePrivate *priv;
g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
g_return_if_fail (icon_size != GTK_ICON_SIZE_INVALID);
priv = palette->priv;
if (!priv->icon_size_set)
{
priv->icon_size_set = TRUE;
g_object_notify (G_OBJECT (palette), "icon-size-set");
}
if (priv->icon_size == icon_size)
return;
priv->icon_size = icon_size;
g_object_notify (G_OBJECT (palette), "icon-size");
gtk_tool_palette_reconfigured (palette);
gtk_widget_queue_resize (GTK_WIDGET (palette));
}
static GtkSettings *
toolpalette_get_settings (GtkToolPalette *palette)
{
GtkToolPalettePrivate *priv = palette->priv;
return priv->settings;
}
/**
* gtk_tool_palette_unset_icon_size:
* @palette: a #GtkToolPalette
*
* Unsets the tool palette icon size set with gtk_tool_palette_set_icon_size(),
* so that user preferences will be used to determine the icon size.
*
* Since: 2.20
*/
void
gtk_tool_palette_unset_icon_size (GtkToolPalette *palette)
{
GtkToolPalettePrivate* priv = palette->priv;
GtkIconSize size;
g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
if (palette->priv->icon_size_set)
{
GtkSettings *settings = toolpalette_get_settings (palette);
if (settings)
{
g_object_get (settings,
"gtk-toolbar-icon-size", &size,
NULL);
}
else
size = DEFAULT_ICON_SIZE;
if (size != palette->priv->icon_size)
{
gtk_tool_palette_set_icon_size (palette, size);
g_object_notify (G_OBJECT (palette), "icon-size");
}
priv->icon_size_set = FALSE;
g_object_notify (G_OBJECT (palette), "icon-size-set");
}
}
/* Set the "toolbar-style" property and do appropriate things.
* GtkToolbar does this by emitting a signal instead of just
* calling a function...
*/
static void
gtk_tool_palette_change_style (GtkToolPalette *palette,
GtkToolbarStyle style)
{
GtkToolPalettePrivate* priv = palette->priv;
if (priv->style != style)
{
priv->style = style;
gtk_tool_palette_reconfigured (palette);
gtk_widget_queue_resize (GTK_WIDGET (palette));
g_object_notify (G_OBJECT (palette), "toolbar-style");
}
}
/**
* gtk_tool_palette_set_style:
* @palette: a #GtkToolPalette
* @style: the #GtkToolbarStyle that items in the tool palette shall have
*
* Sets the style (text, icons or both) of items in the tool palette.
*
* Since: 2.20
*/
void
gtk_tool_palette_set_style (GtkToolPalette *palette,
GtkToolbarStyle style)
{
g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
palette->priv->style_set = TRUE;
gtk_tool_palette_change_style (palette, style);
}
/**
* gtk_tool_palette_unset_style:
* @palette: a #GtkToolPalette
*
* Unsets a toolbar style set with gtk_tool_palette_set_style(),
* so that user preferences will be used to determine the toolbar style.
*
* Since: 2.20
*/
void
gtk_tool_palette_unset_style (GtkToolPalette *palette)
{
GtkToolPalettePrivate* priv = palette->priv;
GtkToolbarStyle style;
g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
if (priv->style_set)
{
GtkSettings *settings = toolpalette_get_settings (palette);
if (settings)
g_object_get (settings,
"gtk-toolbar-style", &style,
NULL);
else
style = DEFAULT_TOOLBAR_STYLE;
if (style != priv->style)
gtk_tool_palette_change_style (palette, style);
priv->style_set = FALSE;
}
}
/**
* gtk_tool_palette_get_icon_size:
* @palette: a #GtkToolPalette
*
* Gets the size of icons in the tool palette.
* See gtk_tool_palette_set_icon_size().
*
* Returns: (type int): the #GtkIconSize of icons in the tool palette
*
* Since: 2.20
*/
GtkIconSize
gtk_tool_palette_get_icon_size (GtkToolPalette *palette)
{
g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), DEFAULT_ICON_SIZE);
return palette->priv->icon_size;
}
/**
* gtk_tool_palette_get_style:
* @palette: a #GtkToolPalette
*
* Gets the style (icons, text or both) of items in the tool palette.
*
* Returns: the #GtkToolbarStyle of items in the tool palette.
*
* Since: 2.20
*/
GtkToolbarStyle
gtk_tool_palette_get_style (GtkToolPalette *palette)
{
g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), DEFAULT_TOOLBAR_STYLE);
return palette->priv->style;
}
gint
_gtk_tool_palette_compare_groups (gconstpointer a,
gconstpointer b)
{
const GtkToolItemGroupInfo *group_a = a;
const GtkToolItemGroupInfo *group_b = b;
return group_a->pos - group_b->pos;
}
/**
* gtk_tool_palette_set_group_position:
* @palette: a #GtkToolPalette
* @group: a #GtkToolItemGroup which is a child of palette
* @position: a new index for group
*
* Sets the position of the group as an index of the tool palette.
* If position is 0 the group will become the first child, if position is
* -1 it will become the last child.
*
* Since: 2.20
*/
void
gtk_tool_palette_set_group_position (GtkToolPalette *palette,
GtkToolItemGroup *group,
gint position)
{
GtkToolItemGroupInfo *group_new;
GtkToolItemGroupInfo *group_old;
gint old_position;
g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
g_return_if_fail (position >= -1);
if (-1 == position)
position = palette->priv->groups->len - 1;
g_return_if_fail ((guint) position < palette->priv->groups->len);
group_new = g_ptr_array_index (palette->priv->groups, position);
if (GTK_TOOL_ITEM_GROUP (group) == group_new->widget)
return;
old_position = gtk_tool_palette_get_group_position (palette, group);
g_return_if_fail (old_position >= 0);
group_old = g_ptr_array_index (palette->priv->groups, old_position);
group_new->pos = position;
group_old->pos = old_position;
g_ptr_array_sort (palette->priv->groups, _gtk_tool_palette_compare_groups);
gtk_widget_queue_resize (GTK_WIDGET (palette));
}
static void
gtk_tool_palette_group_notify_collapsed (GtkToolItemGroup *group,
GParamSpec *pspec,
gpointer data)
{
GtkToolPalette *palette = GTK_TOOL_PALETTE (data);
guint i;
if (gtk_tool_item_group_get_collapsed (group))
return;
for (i = 0; i < palette->priv->groups->len; ++i)
{
GtkToolItemGroupInfo *info = g_ptr_array_index (palette->priv->groups, i);
GtkToolItemGroup *current_group = info->widget;
if (current_group && current_group != group)
gtk_tool_item_group_set_collapsed (current_group, TRUE);
}
}
/**
* gtk_tool_palette_set_exclusive:
* @palette: a #GtkToolPalette
* @group: a #GtkToolItemGroup which is a child of palette
* @exclusive: whether the group should be exclusive or not
*
* Sets whether the group should be exclusive or not.
* If an exclusive group is expanded all other groups are collapsed.
*
* Since: 2.20
*/
void
gtk_tool_palette_set_exclusive (GtkToolPalette *palette,
GtkToolItemGroup *group,
gboolean exclusive)
{
GtkToolItemGroupInfo *group_info;
gint position;
g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
position = gtk_tool_palette_get_group_position (palette, group);
g_return_if_fail (position >= 0);
group_info = g_ptr_array_index (palette->priv->groups, position);
if (exclusive == group_info->exclusive)
return;
group_info->exclusive = exclusive;
if (group_info->exclusive != (0 != group_info->notify_collapsed))
{
if (group_info->exclusive)
{
group_info->notify_collapsed =
g_signal_connect (group, "notify::collapsed",
G_CALLBACK (gtk_tool_palette_group_notify_collapsed),
palette);
}
else
{
g_signal_handler_disconnect (group, group_info->notify_collapsed);
group_info->notify_collapsed = 0;
}
}
gtk_tool_palette_group_notify_collapsed (group_info->widget, NULL, palette);
gtk_widget_child_notify (GTK_WIDGET (group), "exclusive");
}
/**
* gtk_tool_palette_set_expand:
* @palette: a #GtkToolPalette
* @group: a #GtkToolItemGroup which is a child of palette
* @expand: whether the group should be given extra space
*
* Sets whether the group should be given extra space.
*
* Since: 2.20
*/
void
gtk_tool_palette_set_expand (GtkToolPalette *palette,
GtkToolItemGroup *group,
gboolean expand)
{
GtkToolItemGroupInfo *group_info;
gint position;
g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
g_return_if_fail (GTK_IS_TOOL_ITEM_GROUP (group));
position = gtk_tool_palette_get_group_position (palette, group);
g_return_if_fail (position >= 0);
group_info = g_ptr_array_index (palette->priv->groups, position);
if (expand != group_info->expand)
{
group_info->expand = expand;
gtk_widget_queue_resize (GTK_WIDGET (palette));
gtk_widget_child_notify (GTK_WIDGET (group), "expand");
}
}
/**
* gtk_tool_palette_get_group_position:
* @palette: a #GtkToolPalette
* @group: a #GtkToolItemGroup
*
* Gets the position of @group in @palette as index.
* See gtk_tool_palette_set_group_position().
*
* Returns: the index of group or -1 if @group is not a child of @palette
*
* Since: 2.20
*/
gint
gtk_tool_palette_get_group_position (GtkToolPalette *palette,
GtkToolItemGroup *group)
{
guint i;
g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), -1);
g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (group), -1);
for (i = 0; i < palette->priv->groups->len; ++i)
{
GtkToolItemGroupInfo *info = g_ptr_array_index (palette->priv->groups, i);
if ((gpointer) group == info->widget)
return i;
}
return -1;
}
/**
* gtk_tool_palette_get_exclusive:
* @palette: a #GtkToolPalette
* @group: a #GtkToolItemGroup which is a child of palette
*
* Gets whether @group is exclusive or not.
* See gtk_tool_palette_set_exclusive().
*
* Returns: %TRUE if @group is exclusive
*
* Since: 2.20
*/
gboolean
gtk_tool_palette_get_exclusive (GtkToolPalette *palette,
GtkToolItemGroup *group)
{
gint position;
GtkToolItemGroupInfo *info;
g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), DEFAULT_CHILD_EXCLUSIVE);
g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (group), DEFAULT_CHILD_EXCLUSIVE);
position = gtk_tool_palette_get_group_position (palette, group);
g_return_val_if_fail (position >= 0, DEFAULT_CHILD_EXCLUSIVE);
info = g_ptr_array_index (palette->priv->groups, position);
return info->exclusive;
}
/**
* gtk_tool_palette_get_expand:
* @palette: a #GtkToolPalette
* @group: a #GtkToolItemGroup which is a child of palette
*
* Gets whether group should be given extra space.
* See gtk_tool_palette_set_expand().
*
* Returns: %TRUE if group should be given extra space, %FALSE otherwise
*
* Since: 2.20
*/
gboolean
gtk_tool_palette_get_expand (GtkToolPalette *palette,
GtkToolItemGroup *group)
{
gint position;
GtkToolItemGroupInfo *info;
g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), DEFAULT_CHILD_EXPAND);
g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (group), DEFAULT_CHILD_EXPAND);
position = gtk_tool_palette_get_group_position (palette, group);
g_return_val_if_fail (position >= 0, DEFAULT_CHILD_EXPAND);
info = g_ptr_array_index (palette->priv->groups, position);
return info->expand;
}
/**
* gtk_tool_palette_get_drop_item:
* @palette: a #GtkToolPalette
* @x: the x position
* @y: the y position
*
* Gets the item at position (x, y).
* See gtk_tool_palette_get_drop_group().
*
* Returns: (transfer none): the #GtkToolItem at position or %NULL if there is no such item
*
* Since: 2.20
*/
GtkToolItem*
gtk_tool_palette_get_drop_item (GtkToolPalette *palette,
gint x,
gint y)
{
GtkAllocation allocation;
GtkToolItemGroup *group = gtk_tool_palette_get_drop_group (palette, x, y);
GtkWidget *widget = GTK_WIDGET (group);
if (group)
{
gtk_widget_get_allocation (widget, &allocation);
return gtk_tool_item_group_get_drop_item (group,
x - allocation.x,
y - allocation.y);
}
return NULL;
}
/**
* gtk_tool_palette_get_drop_group:
* @palette: a #GtkToolPalette
* @x: the x position
* @y: the y position
*
* Gets the group at position (x, y).
*
* Returns: (transfer none): the #GtkToolItemGroup at position or %NULL
* if there is no such group
*
* Since: 2.20
*/
GtkToolItemGroup*
gtk_tool_palette_get_drop_group (GtkToolPalette *palette,
gint x,
gint y)
{
GtkAllocation allocation;
guint i;
g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), NULL);
gtk_widget_get_allocation (GTK_WIDGET (palette), &allocation);
g_return_val_if_fail (x >= 0 && x < allocation.width, NULL);
g_return_val_if_fail (y >= 0 && y < allocation.height, NULL);
for (i = 0; i < palette->priv->groups->len; ++i)
{
GtkToolItemGroupInfo *group = g_ptr_array_index (palette->priv->groups, i);
GtkWidget *widget;
gint x0, y0;
if (!group->widget)
continue;
widget = GTK_WIDGET (group->widget);
gtk_widget_get_allocation (widget, &allocation);
x0 = x - allocation.x;
y0 = y - allocation.y;
if (x0 >= 0 && x0 < allocation.width &&
y0 >= 0 && y0 < allocation.height)
return GTK_TOOL_ITEM_GROUP (widget);
}
return NULL;
}
/**
* gtk_tool_palette_get_drag_item:
* @palette: a #GtkToolPalette
* @selection: a #GtkSelectionData
*
* Get the dragged item from the selection.
* This could be a #GtkToolItem or a #GtkToolItemGroup.
*
* Returns: (transfer none): the dragged item in selection
*
* Since: 2.20
*/
GtkWidget*
gtk_tool_palette_get_drag_item (GtkToolPalette *palette,
const GtkSelectionData *selection)
{
GtkToolPaletteDragData *data;
GdkAtom target;
g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), NULL);
g_return_val_if_fail (NULL != selection, NULL);
g_return_val_if_fail (gtk_selection_data_get_format (selection) == 8, NULL);
g_return_val_if_fail (gtk_selection_data_get_length (selection) == sizeof (GtkToolPaletteDragData), NULL);
target = gtk_selection_data_get_target (selection);
g_return_val_if_fail (target == dnd_target_atom_item ||
target == dnd_target_atom_group,
NULL);
data = (GtkToolPaletteDragData*) gtk_selection_data_get_data (selection);
g_return_val_if_fail (data->palette == palette, NULL);
if (dnd_target_atom_item == target)
g_return_val_if_fail (GTK_IS_TOOL_ITEM (data->item), NULL);
else if (dnd_target_atom_group == target)
g_return_val_if_fail (GTK_IS_TOOL_ITEM_GROUP (data->item), NULL);
return data->item;
}
/**
* gtk_tool_palette_set_drag_source:
* @palette: a #GtkToolPalette
* @targets: the #GtkToolPaletteDragTarget<!-- -->s
* which the widget should support
*
* Sets the tool palette as a drag source.
* Enables all groups and items in the tool palette as drag sources
* on button 1 and button 3 press with copy and move actions.
* See gtk_drag_source_set().
*
* Since: 2.20
*/
void
gtk_tool_palette_set_drag_source (GtkToolPalette *palette,
GtkToolPaletteDragTargets targets)
{
guint i;
g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
if ((palette->priv->drag_source & targets) == targets)
return;
palette->priv->drag_source |= targets;
for (i = 0; i < palette->priv->groups->len; ++i)
{
GtkToolItemGroupInfo *info = g_ptr_array_index (palette->priv->groups, i);
if (info->widget)
gtk_container_forall (GTK_CONTAINER (info->widget),
_gtk_tool_palette_child_set_drag_source,
palette);
}
}
/**
* gtk_tool_palette_add_drag_dest:
* @palette: a #GtkToolPalette
* @widget: a #GtkWidget which should be a drag destination for @palette
* @flags: the flags that specify what actions GTK+ should take for drops
* on that widget
* @targets: the #GtkToolPaletteDragTarget<!-- -->s which the widget
* should support
* @actions: the #GdkDragAction<!-- -->s which the widget should suppport
*
* Sets @palette as drag source (see gtk_tool_palette_set_drag_source())
* and sets @widget as a drag destination for drags from @palette.
* See gtk_drag_dest_set().
*
* Since: 2.20
*/
void
gtk_tool_palette_add_drag_dest (GtkToolPalette *palette,
GtkWidget *widget,
GtkDestDefaults flags,
GtkToolPaletteDragTargets targets,
GdkDragAction actions)
{
GtkTargetEntry entries[G_N_ELEMENTS (dnd_targets)];
gint n_entries = 0;
g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
g_return_if_fail (GTK_IS_WIDGET (widget));
gtk_tool_palette_set_drag_source (palette,
targets);
if (targets & GTK_TOOL_PALETTE_DRAG_ITEMS)
entries[n_entries++] = dnd_targets[0];
if (targets & GTK_TOOL_PALETTE_DRAG_GROUPS)
entries[n_entries++] = dnd_targets[1];
gtk_drag_dest_set (widget, flags, entries, n_entries, actions);
}
void
_gtk_tool_palette_get_item_size (GtkToolPalette *palette,
GtkRequisition *item_size,
gboolean homogeneous_only,
gint *requested_rows)
{
GtkRequisition max_requisition;
gint max_rows;
guint i;
g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
g_return_if_fail (NULL != item_size);
max_requisition.width = 0;
max_requisition.height = 0;
max_rows = 0;
/* iterate over all groups and calculate the max item_size and max row request */
for (i = 0; i < palette->priv->groups->len; ++i)
{
GtkRequisition requisition;
gint rows;
GtkToolItemGroupInfo *group = g_ptr_array_index (palette->priv->groups, i);
if (!group->widget)
continue;
_gtk_tool_item_group_item_size_request (group->widget, &requisition, homogeneous_only, &rows);
max_requisition.width = MAX (max_requisition.width, requisition.width);
max_requisition.height = MAX (max_requisition.height, requisition.height);
max_rows = MAX (max_rows, rows);
}
*item_size = max_requisition;
if (requested_rows)
*requested_rows = max_rows;
}
static void
gtk_tool_palette_item_drag_data_get (GtkWidget *widget,
GdkDragContext *context,
GtkSelectionData *selection,
guint info,
guint time,
gpointer data)
{
GtkToolPaletteDragData drag_data = { GTK_TOOL_PALETTE (data), NULL };
GdkAtom target;
target = gtk_selection_data_get_target (selection);
if (target == dnd_target_atom_item)
drag_data.item = gtk_widget_get_ancestor (widget, GTK_TYPE_TOOL_ITEM);
if (drag_data.item)
gtk_selection_data_set (selection, target, 8,
(guchar*) &drag_data, sizeof (drag_data));
}
static void
gtk_tool_palette_child_drag_data_get (GtkWidget *widget,
GdkDragContext *context,
GtkSelectionData *selection,
guint info,
guint time,
gpointer data)
{
GtkToolPaletteDragData drag_data = { GTK_TOOL_PALETTE (data), NULL };
GdkAtom target;
target = gtk_selection_data_get_target (selection);
if (target == dnd_target_atom_group)
drag_data.item = gtk_widget_get_ancestor (widget, GTK_TYPE_TOOL_ITEM_GROUP);
if (drag_data.item)
gtk_selection_data_set (selection, target, 8,
(guchar*) &drag_data, sizeof (drag_data));
}
void
_gtk_tool_palette_child_set_drag_source (GtkWidget *child,
gpointer data)
{
GtkToolPalette *palette = GTK_TOOL_PALETTE (data);
/* Check drag_source,
* to work properly when called from gtk_tool_item_group_insert().
*/
if (!palette->priv->drag_source)
return;
if (GTK_IS_TOOL_ITEM (child) &&
(palette->priv->drag_source & GTK_TOOL_PALETTE_DRAG_ITEMS))
{
/* Connect to child instead of the item itself,
* to work arround bug 510377.
*/
if (GTK_IS_TOOL_BUTTON (child))
child = gtk_bin_get_child (GTK_BIN (child));
if (!child)
return;
gtk_drag_source_set (child, GDK_BUTTON1_MASK | GDK_BUTTON3_MASK,
&dnd_targets[0], 1, GDK_ACTION_COPY | GDK_ACTION_MOVE);
g_signal_connect (child, "drag-data-get",
G_CALLBACK (gtk_tool_palette_item_drag_data_get),
palette);
}
else if (GTK_IS_BUTTON (child) &&
(palette->priv->drag_source & GTK_TOOL_PALETTE_DRAG_GROUPS))
{
gtk_drag_source_set (child, GDK_BUTTON1_MASK | GDK_BUTTON3_MASK,
&dnd_targets[1], 1, GDK_ACTION_COPY | GDK_ACTION_MOVE);
g_signal_connect (child, "drag-data-get",
G_CALLBACK (gtk_tool_palette_child_drag_data_get),
palette);
}
}
/**
* gtk_tool_palette_get_drag_target_item:
*
* Gets the target entry for a dragged #GtkToolItem.
*
* Returns: (transfer none): the #GtkTargetEntry for a dragged item.
*
* Since: 2.20
*/
G_CONST_RETURN GtkTargetEntry*
gtk_tool_palette_get_drag_target_item (void)
{
return &dnd_targets[0];
}
/**
* gtk_tool_palette_get_drag_target_group:
*
* Get the target entry for a dragged #GtkToolItemGroup.
*
* Returns: (transfer none): the #GtkTargetEntry for a dragged group
*
* Since: 2.20
*/
G_CONST_RETURN GtkTargetEntry*
gtk_tool_palette_get_drag_target_group (void)
{
return &dnd_targets[1];
}
void
_gtk_tool_palette_set_expanding_child (GtkToolPalette *palette,
GtkWidget *widget)
{
g_return_if_fail (GTK_IS_TOOL_PALETTE (palette));
palette->priv->expanding_child = widget;
}
/**
* gtk_tool_palette_get_hadjustment:
* @palette: a #GtkToolPalette
*
* Gets the horizontal adjustment of the tool palette.
*
* Returns: (transfer none): the horizontal adjustment of @palette
*
* Since: 2.20
*
* Deprecated: 3.0: Use gtk_scrollable_get_hadjustment()
*/
GtkAdjustment*
gtk_tool_palette_get_hadjustment (GtkToolPalette *palette)
{
g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), NULL);
return palette->priv->hadjustment;
}
static void
gtk_tool_palette_set_hadjustment (GtkToolPalette *palette,
GtkAdjustment *adjustment)
{
GtkToolPalettePrivate *priv = palette->priv;
if (adjustment && priv->hadjustment == adjustment)
return;
if (priv->hadjustment != NULL)
{
g_signal_handlers_disconnect_by_func (priv->hadjustment,
gtk_tool_palette_adjustment_value_changed,
palette);
g_object_unref (priv->hadjustment);
}
if (adjustment == NULL)
adjustment = gtk_adjustment_new (0.0, 0.0, 0.0,
0.0, 0.0, 0.0);
g_signal_connect (adjustment, "value-changed",
G_CALLBACK (gtk_tool_palette_adjustment_value_changed),
palette);
priv->hadjustment = g_object_ref_sink (adjustment);
/* FIXME: Adjustment should probably have its values updated now */
g_object_notify (G_OBJECT (palette), "hadjustment");
}
/**
* gtk_tool_palette_get_vadjustment:
* @palette: a #GtkToolPalette
*
* Gets the vertical adjustment of the tool palette.
*
* Returns: (transfer none): the vertical adjustment of @palette
*
* Since: 2.20
*
* Deprecated: 3.0: Use gtk_scrollable_get_vadjustment()
*/
GtkAdjustment*
gtk_tool_palette_get_vadjustment (GtkToolPalette *palette)
{
g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), NULL);
return palette->priv->vadjustment;
}
static void
gtk_tool_palette_set_vadjustment (GtkToolPalette *palette,
GtkAdjustment *adjustment)
{
GtkToolPalettePrivate *priv = palette->priv;
if (adjustment && priv->vadjustment == adjustment)
return;
if (priv->vadjustment != NULL)
{
g_signal_handlers_disconnect_by_func (priv->vadjustment,
gtk_tool_palette_adjustment_value_changed,
palette);
g_object_unref (priv->vadjustment);
}
if (adjustment == NULL)
adjustment = gtk_adjustment_new (0.0, 0.0, 0.0,
0.0, 0.0, 0.0);
g_signal_connect (adjustment, "value-changed",
G_CALLBACK (gtk_tool_palette_adjustment_value_changed),
palette);
priv->vadjustment = g_object_ref_sink (adjustment);
/* FIXME: Adjustment should probably have its values updated now */
g_object_notify (G_OBJECT (palette), "vadjustment");
}
GtkSizeGroup *
_gtk_tool_palette_get_size_group (GtkToolPalette *palette)
{
g_return_val_if_fail (GTK_IS_TOOL_PALETTE (palette), NULL);
return palette->priv->text_size_group;
}