1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 2005 Ronald S. Bultje
3 * Copyright (C) 2006, 2007 Christian Persch
4 * Copyright (C) 2006 Jan Arne Petersen
5 * Copyright (C) 2005-2007 Red Hat, Inc.
8 * - Ronald S. Bultje <rbultje@ronald.bitfreak.net>
9 * - Bastien Nocera <bnocera@redhat.com>
10 * - Jan Arne Petersen <jpetersen@jpetersen.org>
11 * - Christian Persch <chpe@svn.gnome.org>
13 * This library is free software; you can redistribute it and/or
14 * modify it under the terms of the GNU Lesser General Public
15 * License as published by the Free Software Foundation; either
16 * version 2 of the License, or (at your option) any later version.
18 * This library is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
21 * Lesser General Public License for more details.
23 * You should have received a copy of the GNU Lesser General Public
24 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
28 * Modified by the GTK+ Team and others 2007. See the AUTHORS
29 * file for a list of people on the GTK+ Team. See the ChangeLog
30 * files for a list of changes. These files are distributed with
31 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
43 #include "gtkbindings.h"
46 #include "gtkmarshalers.h"
47 #include "gtkorientable.h"
48 #include "gtkprivate.h"
50 #include "gtkscalebutton.h"
53 #include "gtkwindow.h"
54 #include "gtktypebuiltins.h"
56 #include "a11y/gtkscalebuttonaccessible.h"
59 * SECTION:gtkscalebutton
60 * @Short_description: A button which pops up a scale
61 * @Title: GtkScaleButton
63 * #GtkScaleButton provides a button which pops up a scale widget.
64 * This kind of widget is commonly used for volume controls in multimedia
65 * applications, and GTK+ provides a #GtkVolumeButton subclass that
66 * is tailored for this use case.
70 #define SCALE_SIZE 100
71 #define CLICK_TIMEOUT 250
93 struct _GtkScaleButtonPrivate
95 GtkWidget *plus_button;
96 GtkWidget *minus_button;
103 GtkOrientation orientation;
113 GdkDevice *grab_pointer;
114 GdkDevice *grab_keyboard;
116 GtkAdjustment *adjustment; /* needed because it must be settable in init() */
119 static GObject* gtk_scale_button_constructor (GType type,
120 guint n_construct_properties,
121 GObjectConstructParam *construct_params);
122 static void gtk_scale_button_dispose (GObject *object);
123 static void gtk_scale_button_finalize (GObject *object);
124 static void gtk_scale_button_set_property (GObject *object,
128 static void gtk_scale_button_get_property (GObject *object,
132 static void gtk_scale_button_set_orientation_private (GtkScaleButton *button,
133 GtkOrientation orientation);
134 static gboolean gtk_scale_button_scroll (GtkWidget *widget,
135 GdkEventScroll *event);
136 static void gtk_scale_button_screen_changed (GtkWidget *widget,
137 GdkScreen *previous_screen);
138 static gboolean gtk_scale_button_press (GtkWidget *widget,
139 GdkEventButton *event);
140 static gboolean gtk_scale_button_key_release (GtkWidget *widget,
142 static void gtk_scale_button_popup (GtkWidget *widget);
143 static void gtk_scale_button_popdown (GtkWidget *widget);
144 static gboolean cb_dock_button_press (GtkWidget *widget,
145 GdkEventButton *event,
147 static gboolean cb_dock_key_release (GtkWidget *widget,
150 static gboolean cb_button_press (GtkWidget *widget,
151 GdkEventButton *event,
153 static gboolean cb_button_release (GtkWidget *widget,
154 GdkEventButton *event,
156 static void cb_dock_grab_notify (GtkWidget *widget,
157 gboolean was_grabbed,
159 static gboolean cb_dock_grab_broken_event (GtkWidget *widget,
160 gboolean was_grabbed,
162 static void cb_scale_grab_notify (GtkWidget *widget,
163 gboolean was_grabbed,
165 static void gtk_scale_button_update_icon (GtkScaleButton *button);
166 static void gtk_scale_button_scale_value_changed(GtkRange *range);
168 /* see below for scale definitions */
169 static GtkWidget *gtk_scale_button_scale_new (GtkScaleButton *button);
171 G_DEFINE_TYPE_WITH_CODE (GtkScaleButton, gtk_scale_button, GTK_TYPE_BUTTON,
172 G_IMPLEMENT_INTERFACE (GTK_TYPE_ORIENTABLE,
175 static guint signals[LAST_SIGNAL] = { 0, };
178 gtk_scale_button_class_init (GtkScaleButtonClass *klass)
180 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
181 GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
182 GtkBindingSet *binding_set;
184 g_type_class_add_private (klass, sizeof (GtkScaleButtonPrivate));
186 gobject_class->constructor = gtk_scale_button_constructor;
187 gobject_class->finalize = gtk_scale_button_finalize;
188 gobject_class->dispose = gtk_scale_button_dispose;
189 gobject_class->set_property = gtk_scale_button_set_property;
190 gobject_class->get_property = gtk_scale_button_get_property;
192 widget_class->button_press_event = gtk_scale_button_press;
193 widget_class->key_release_event = gtk_scale_button_key_release;
194 widget_class->scroll_event = gtk_scale_button_scroll;
195 widget_class->screen_changed = gtk_scale_button_screen_changed;
198 * GtkScaleButton:orientation:
200 * The orientation of the #GtkScaleButton's popup window.
202 * Note that since GTK+ 2.16, #GtkScaleButton implements the
203 * #GtkOrientable interface which has its own @orientation
204 * property. However we redefine the property here in order to
205 * override its default horizontal orientation.
209 g_object_class_override_property (gobject_class,
213 g_object_class_install_property (gobject_class,
215 g_param_spec_double ("value",
217 P_("The value of the scale"),
221 GTK_PARAM_READWRITE));
223 g_object_class_install_property (gobject_class,
225 g_param_spec_enum ("size",
229 GTK_ICON_SIZE_SMALL_TOOLBAR,
230 GTK_PARAM_READWRITE));
232 g_object_class_install_property (gobject_class,
234 g_param_spec_object ("adjustment",
236 P_("The GtkAdjustment that contains the current value of this scale button object"),
238 GTK_PARAM_READWRITE));
241 * GtkScaleButton:icons:
243 * The names of the icons to be used by the scale button.
244 * The first item in the array will be used in the button
245 * when the current value is the lowest value, the second
246 * item for the highest value. All the subsequent icons will
247 * be used for all the other values, spread evenly over the
250 * If there's only one icon name in the @icons array, it will
251 * be used for all the values. If only two icon names are in
252 * the @icons array, the first one will be used for the bottom
253 * 50% of the scale, and the second one for the top 50%.
255 * It is recommended to use at least 3 icons so that the
256 * #GtkScaleButton reflects the current value of the scale
257 * better for the users.
261 g_object_class_install_property (gobject_class,
263 g_param_spec_boxed ("icons",
265 P_("List of icon names"),
267 GTK_PARAM_READWRITE));
270 * GtkScaleButton::value-changed:
271 * @button: the object which received the signal
272 * @value: the new value
274 * The ::value-changed signal is emitted when the value field has
279 signals[VALUE_CHANGED] =
280 g_signal_new (I_("value-changed"),
281 G_TYPE_FROM_CLASS (klass),
283 G_STRUCT_OFFSET (GtkScaleButtonClass, value_changed),
285 _gtk_marshal_VOID__DOUBLE,
286 G_TYPE_NONE, 1, G_TYPE_DOUBLE);
289 * GtkScaleButton::popup:
290 * @button: the object which received the signal
292 * The ::popup signal is a
293 * <link linkend="keybinding-signals">keybinding signal</link>
294 * which gets emitted to popup the scale widget.
296 * The default bindings for this signal are Space, Enter and Return.
301 g_signal_new_class_handler (I_("popup"),
302 G_OBJECT_CLASS_TYPE (klass),
303 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
304 G_CALLBACK (gtk_scale_button_popup),
306 g_cclosure_marshal_VOID__VOID,
310 * GtkScaleButton::popdown:
311 * @button: the object which received the signal
313 * The ::popdown signal is a
314 * <link linkend="keybinding-signals">keybinding signal</link>
315 * which gets emitted to popdown the scale widget.
317 * The default binding for this signal is Escape.
322 g_signal_new_class_handler (I_("popdown"),
323 G_OBJECT_CLASS_TYPE (klass),
324 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
325 G_CALLBACK (gtk_scale_button_popdown),
327 g_cclosure_marshal_VOID__VOID,
331 binding_set = gtk_binding_set_by_class (widget_class);
333 gtk_binding_entry_add_signal (binding_set, GDK_KEY_space, 0,
335 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Space, 0,
337 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Return, 0,
339 gtk_binding_entry_add_signal (binding_set, GDK_KEY_ISO_Enter, 0,
341 gtk_binding_entry_add_signal (binding_set, GDK_KEY_KP_Enter, 0,
343 gtk_binding_entry_add_signal (binding_set, GDK_KEY_Escape, 0,
346 gtk_widget_class_set_accessible_type (widget_class, GTK_TYPE_SCALE_BUTTON_ACCESSIBLE);
350 gtk_scale_button_init (GtkScaleButton *button)
352 GtkScaleButtonPrivate *priv;
355 button->priv = priv = G_TYPE_INSTANCE_GET_PRIVATE (button,
356 GTK_TYPE_SCALE_BUTTON,
357 GtkScaleButtonPrivate);
359 priv->timeout = FALSE;
361 priv->click_timeout = CLICK_TIMEOUT;
362 priv->orientation = GTK_ORIENTATION_VERTICAL;
364 gtk_button_set_relief (GTK_BUTTON (button), GTK_RELIEF_NONE);
365 gtk_button_set_focus_on_click (GTK_BUTTON (button), FALSE);
368 priv->image = gtk_image_new ();
369 gtk_container_add (GTK_CONTAINER (button), priv->image);
370 gtk_widget_show_all (priv->image);
373 priv->dock = gtk_window_new (GTK_WINDOW_POPUP);
374 gtk_widget_set_name (priv->dock, "gtk-scalebutton-popup-window");
375 g_signal_connect (priv->dock, "button-press-event",
376 G_CALLBACK (cb_dock_button_press), button);
377 g_signal_connect (priv->dock, "key-release-event",
378 G_CALLBACK (cb_dock_key_release), button);
379 g_signal_connect (priv->dock, "grab-notify",
380 G_CALLBACK (cb_dock_grab_notify), button);
381 g_signal_connect (priv->dock, "grab-broken-event",
382 G_CALLBACK (cb_dock_grab_broken_event), button);
383 gtk_window_set_decorated (GTK_WINDOW (priv->dock), FALSE);
386 frame = gtk_frame_new (NULL);
387 gtk_frame_set_shadow_type (GTK_FRAME (frame), GTK_SHADOW_OUT);
388 gtk_container_add (GTK_CONTAINER (priv->dock), frame);
390 /* box for scale and +/- buttons */
391 priv->box = gtk_box_new (GTK_ORIENTATION_VERTICAL, 0);
392 gtk_container_add (GTK_CONTAINER (frame), priv->box);
395 priv->plus_button = gtk_button_new_with_label ("+");
396 gtk_button_set_relief (GTK_BUTTON (priv->plus_button), GTK_RELIEF_NONE);
397 g_signal_connect (priv->plus_button, "button-press-event",
398 G_CALLBACK (cb_button_press), button);
399 g_signal_connect (priv->plus_button, "button-release-event",
400 G_CALLBACK (cb_button_release), button);
401 gtk_box_pack_start (GTK_BOX (priv->box), priv->plus_button, FALSE, FALSE, 0);
404 priv->minus_button = gtk_button_new_with_label ("-");
405 gtk_button_set_relief (GTK_BUTTON (priv->minus_button), GTK_RELIEF_NONE);
406 g_signal_connect (priv->minus_button, "button-press-event",
407 G_CALLBACK (cb_button_press), button);
408 g_signal_connect (priv->minus_button, "button-release-event",
409 G_CALLBACK (cb_button_release), button);
410 gtk_box_pack_end (GTK_BOX (priv->box), priv->minus_button, FALSE, FALSE, 0);
412 priv->adjustment = gtk_adjustment_new (0.0, 0.0, 100.0, 2, 20, 0);
413 g_object_ref_sink (priv->adjustment);
416 priv->scale = gtk_scale_button_scale_new (button);
417 gtk_container_add (GTK_CONTAINER (priv->box), priv->scale);
421 gtk_scale_button_constructor (GType type,
422 guint n_construct_properties,
423 GObjectConstructParam *construct_params)
426 GtkScaleButton *button;
427 GtkScaleButtonPrivate *priv;
429 object = G_OBJECT_CLASS (gtk_scale_button_parent_class)->constructor (type, n_construct_properties, construct_params);
431 button = GTK_SCALE_BUTTON (object);
435 /* set button text and size */
436 priv->size = GTK_ICON_SIZE_SMALL_TOOLBAR;
437 gtk_scale_button_update_icon (button);
443 gtk_scale_button_set_property (GObject *object,
448 GtkScaleButton *button = GTK_SCALE_BUTTON (object);
452 case PROP_ORIENTATION:
453 gtk_scale_button_set_orientation_private (button, g_value_get_enum (value));
456 gtk_scale_button_set_value (button, g_value_get_double (value));
461 size = g_value_get_enum (value);
462 if (button->priv->size != size)
464 button->priv->size = size;
465 gtk_scale_button_update_icon (button);
469 case PROP_ADJUSTMENT:
470 gtk_scale_button_set_adjustment (button, g_value_get_object (value));
473 gtk_scale_button_set_icons (button,
474 (const gchar **)g_value_get_boxed (value));
477 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
483 gtk_scale_button_get_property (GObject *object,
488 GtkScaleButton *button = GTK_SCALE_BUTTON (object);
489 GtkScaleButtonPrivate *priv = button->priv;
493 case PROP_ORIENTATION:
494 g_value_set_enum (value, priv->orientation);
497 g_value_set_double (value, gtk_scale_button_get_value (button));
500 g_value_set_enum (value, priv->size);
502 case PROP_ADJUSTMENT:
503 g_value_set_object (value, gtk_scale_button_get_adjustment (button));
506 g_value_set_boxed (value, priv->icon_list);
509 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
515 gtk_scale_button_finalize (GObject *object)
517 GtkScaleButton *button = GTK_SCALE_BUTTON (object);
518 GtkScaleButtonPrivate *priv = button->priv;
522 g_strfreev (priv->icon_list);
523 priv->icon_list = NULL;
526 if (priv->adjustment)
528 g_object_unref (priv->adjustment);
529 priv->adjustment = NULL;
532 G_OBJECT_CLASS (gtk_scale_button_parent_class)->finalize (object);
536 gtk_scale_button_dispose (GObject *object)
538 GtkScaleButton *button = GTK_SCALE_BUTTON (object);
539 GtkScaleButtonPrivate *priv = button->priv;
543 gtk_widget_destroy (priv->dock);
547 if (priv->click_id != 0)
549 g_source_remove (priv->click_id);
553 G_OBJECT_CLASS (gtk_scale_button_parent_class)->dispose (object);
557 * gtk_scale_button_new:
558 * @size: (type int): a stock icon size
559 * @min: the minimum value of the scale (usually 0)
560 * @max: the maximum value of the scale (usually 100)
561 * @step: the stepping of value when a scroll-wheel event,
562 * or up/down arrow event occurs (usually 2)
563 * @icons: (allow-none) (array zero-terminated=1): a %NULL-terminated
564 * array of icon names, or %NULL if you want to set the list
565 * later with gtk_scale_button_set_icons()
567 * Creates a #GtkScaleButton, with a range between @min and @max, with
568 * a stepping of @step.
570 * Return value: a new #GtkScaleButton
575 gtk_scale_button_new (GtkIconSize size,
581 GtkScaleButton *button;
582 GtkAdjustment *adjustment;
584 adjustment = gtk_adjustment_new (min, min, max, step, 10 * step, 0);
586 button = g_object_new (GTK_TYPE_SCALE_BUTTON,
587 "adjustment", adjustment,
592 return GTK_WIDGET (button);
596 * gtk_scale_button_get_value:
597 * @button: a #GtkScaleButton
599 * Gets the current value of the scale button.
601 * Return value: current value of the scale button
606 gtk_scale_button_get_value (GtkScaleButton * button)
608 GtkScaleButtonPrivate *priv;
610 g_return_val_if_fail (GTK_IS_SCALE_BUTTON (button), 0);
614 return gtk_adjustment_get_value (priv->adjustment);
618 * gtk_scale_button_set_value:
619 * @button: a #GtkScaleButton
620 * @value: new value of the scale button
622 * Sets the current value of the scale; if the value is outside
623 * the minimum or maximum range values, it will be clamped to fit
624 * inside them. The scale button emits the #GtkScaleButton::value-changed
625 * signal if the value changes.
630 gtk_scale_button_set_value (GtkScaleButton *button,
633 GtkScaleButtonPrivate *priv;
635 g_return_if_fail (GTK_IS_SCALE_BUTTON (button));
639 gtk_range_set_value (GTK_RANGE (priv->scale), value);
643 * gtk_scale_button_set_icons:
644 * @button: a #GtkScaleButton
645 * @icons: (array zero-terminated=1): a %NULL-terminated array of icon names
647 * Sets the icons to be used by the scale button.
648 * For details, see the #GtkScaleButton:icons property.
653 gtk_scale_button_set_icons (GtkScaleButton *button,
656 GtkScaleButtonPrivate *priv;
659 g_return_if_fail (GTK_IS_SCALE_BUTTON (button));
663 tmp = priv->icon_list;
664 priv->icon_list = g_strdupv ((gchar **) icons);
666 gtk_scale_button_update_icon (button);
668 g_object_notify (G_OBJECT (button), "icons");
672 * gtk_scale_button_get_adjustment:
673 * @button: a #GtkScaleButton
675 * Gets the #GtkAdjustment associated with the #GtkScaleButton's scale.
676 * See gtk_range_get_adjustment() for details.
678 * Returns: (transfer none): the adjustment associated with the scale
683 gtk_scale_button_get_adjustment (GtkScaleButton *button)
685 g_return_val_if_fail (GTK_IS_SCALE_BUTTON (button), NULL);
687 return button->priv->adjustment;
691 * gtk_scale_button_set_adjustment:
692 * @button: a #GtkScaleButton
693 * @adjustment: a #GtkAdjustment
695 * Sets the #GtkAdjustment to be used as a model
696 * for the #GtkScaleButton's scale.
697 * See gtk_range_set_adjustment() for details.
702 gtk_scale_button_set_adjustment (GtkScaleButton *button,
703 GtkAdjustment *adjustment)
705 g_return_if_fail (GTK_IS_SCALE_BUTTON (button));
708 adjustment = gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0);
710 g_return_if_fail (GTK_IS_ADJUSTMENT (adjustment));
712 if (button->priv->adjustment != adjustment)
714 if (button->priv->adjustment)
715 g_object_unref (button->priv->adjustment);
716 button->priv->adjustment = g_object_ref_sink (adjustment);
718 if (button->priv->scale)
719 gtk_range_set_adjustment (GTK_RANGE (button->priv->scale), adjustment);
721 g_object_notify (G_OBJECT (button), "adjustment");
726 * gtk_scale_button_get_plus_button:
727 * @button: a #GtkScaleButton
729 * Retrieves the plus button of the #GtkScaleButton.
731 * Returns: (transfer none): the plus button of the #GtkScaleButton
736 gtk_scale_button_get_plus_button (GtkScaleButton *button)
738 g_return_val_if_fail (GTK_IS_SCALE_BUTTON (button), NULL);
740 return button->priv->plus_button;
744 * gtk_scale_button_get_minus_button:
745 * @button: a #GtkScaleButton
747 * Retrieves the minus button of the #GtkScaleButton.
749 * Returns: (transfer none): the minus button of the #GtkScaleButton
754 gtk_scale_button_get_minus_button (GtkScaleButton *button)
756 g_return_val_if_fail (GTK_IS_SCALE_BUTTON (button), NULL);
758 return button->priv->minus_button;
762 * gtk_scale_button_get_popup:
763 * @button: a #GtkScaleButton
765 * Retrieves the popup of the #GtkScaleButton.
767 * Returns: (transfer none): the popup of the #GtkScaleButton
772 gtk_scale_button_get_popup (GtkScaleButton *button)
774 g_return_val_if_fail (GTK_IS_SCALE_BUTTON (button), NULL);
776 return button->priv->dock;
780 gtk_scale_button_set_orientation_private (GtkScaleButton *button,
781 GtkOrientation orientation)
783 GtkScaleButtonPrivate *priv = button->priv;
785 if (orientation != priv->orientation)
787 priv->orientation = orientation;
789 gtk_orientable_set_orientation (GTK_ORIENTABLE (priv->box),
791 gtk_container_child_set (GTK_CONTAINER (priv->box),
794 orientation == GTK_ORIENTATION_VERTICAL ?
795 GTK_PACK_START : GTK_PACK_END,
797 gtk_container_child_set (GTK_CONTAINER (priv->box),
800 orientation == GTK_ORIENTATION_VERTICAL ?
801 GTK_PACK_END : GTK_PACK_START,
804 gtk_orientable_set_orientation (GTK_ORIENTABLE (priv->scale),
807 if (orientation == GTK_ORIENTATION_VERTICAL)
809 gtk_widget_set_size_request (GTK_WIDGET (priv->scale),
811 gtk_range_set_inverted (GTK_RANGE (priv->scale), TRUE);
815 gtk_widget_set_size_request (GTK_WIDGET (priv->scale),
817 gtk_range_set_inverted (GTK_RANGE (priv->scale), FALSE);
820 /* FIXME: without this, the popup window appears as a square
821 * after changing the orientation
823 gtk_window_resize (GTK_WINDOW (priv->dock), 1, 1);
825 g_object_notify (G_OBJECT (button), "orientation");
834 gtk_scale_button_scroll (GtkWidget *widget,
835 GdkEventScroll *event)
837 GtkScaleButton *button;
838 GtkScaleButtonPrivate *priv;
839 GtkAdjustment *adjustment;
842 button = GTK_SCALE_BUTTON (widget);
844 adjustment = priv->adjustment;
846 if (event->type != GDK_SCROLL)
849 d = gtk_scale_button_get_value (button);
850 if (event->direction == GDK_SCROLL_UP)
852 d += gtk_adjustment_get_step_increment (adjustment);
853 if (d > gtk_adjustment_get_upper (adjustment))
854 d = gtk_adjustment_get_upper (adjustment);
858 d -= gtk_adjustment_get_step_increment (adjustment);
859 if (d < gtk_adjustment_get_lower (adjustment))
860 d = gtk_adjustment_get_lower (adjustment);
862 gtk_scale_button_set_value (button, d);
868 gtk_scale_button_screen_changed (GtkWidget *widget,
869 GdkScreen *previous_screen)
871 GtkScaleButton *button = (GtkScaleButton *) widget;
872 GtkScaleButtonPrivate *priv;
874 GValue value = G_VALUE_INIT;
876 if (gtk_widget_has_screen (widget) == FALSE)
881 screen = gtk_widget_get_screen (widget);
882 g_value_init (&value, G_TYPE_INT);
883 if (gdk_screen_get_setting (screen,
884 "gtk-double-click-time",
887 priv->click_timeout = CLICK_TIMEOUT;
891 priv->click_timeout = g_value_get_int (&value);
895 gtk_scale_popup (GtkWidget *widget,
899 GtkAllocation allocation, dock_allocation, scale_allocation;
900 GtkScaleButton *button;
901 GtkScaleButtonPrivate *priv;
902 GtkAdjustment *adjustment;
903 gint x, y, m, dx, dy, sx, sy, startoff;
904 gint min_slider_size;
908 GdkDevice *device, *keyboard, *pointer;
911 button = GTK_SCALE_BUTTON (widget);
913 adjustment = priv->adjustment;
915 screen = gtk_widget_get_screen (widget);
916 gtk_widget_get_allocation (widget, &allocation);
918 /* position roughly */
919 gtk_window_set_screen (GTK_WINDOW (priv->dock), screen);
921 gdk_window_get_origin (gtk_widget_get_window (widget),
926 if (priv->orientation == GTK_ORIENTATION_VERTICAL)
927 gtk_window_move (GTK_WINDOW (priv->dock), x, y - (SCALE_SIZE / 2));
929 gtk_window_move (GTK_WINDOW (priv->dock), x - (SCALE_SIZE / 2), y);
931 gtk_widget_show_all (priv->dock);
933 gdk_window_get_origin (gtk_widget_get_window (priv->dock),
935 gtk_widget_get_allocation (priv->dock, &dock_allocation);
936 dx += dock_allocation.x;
937 dy += dock_allocation.y;
940 gdk_window_get_origin (gtk_widget_get_window (priv->scale),
942 gtk_widget_get_allocation (priv->scale, &scale_allocation);
943 sx += scale_allocation.x;
944 sy += scale_allocation.y;
946 priv->timeout = TRUE;
948 /* position (needs widget to be shown already) */
949 v = gtk_scale_button_get_value (button) / (gtk_adjustment_get_upper (adjustment) - gtk_adjustment_get_lower (adjustment));
950 min_slider_size = gtk_range_get_min_slider_size (GTK_RANGE (priv->scale));
952 if (priv->orientation == GTK_ORIENTATION_VERTICAL)
956 x += (allocation.width - dock_allocation.width) / 2;
958 y -= min_slider_size / 2;
959 m = scale_allocation.height - min_slider_size;
967 y += (allocation.height - dock_allocation.height) / 2;
968 x -= min_slider_size / 2;
969 m = scale_allocation.width - min_slider_size;
973 /* Make sure the dock stays inside the monitor */
974 if (event->type == GDK_BUTTON_PRESS)
976 GtkAllocation d_allocation;
978 GdkEventButton *button_event = (GdkEventButton *) event;
982 d = GTK_WIDGET (priv->dock);
983 monitor = gdk_screen_get_monitor_at_point (screen,
984 button_event->x_root,
985 button_event->y_root);
986 gdk_screen_get_monitor_workarea (screen, monitor, &rect);
988 if (priv->orientation == GTK_ORIENTATION_VERTICAL)
989 y += button_event->y;
991 x += button_event->x;
993 /* Move the dock, but set is_moved so we
994 * don't forward the first click later on,
995 * as it could make the scale go to the bottom */
996 gtk_widget_get_allocation (d, &d_allocation);
1002 else if (y + d_allocation.height > rect.height + rect.y)
1004 y = rect.y + rect.height - d_allocation.height;
1013 else if (x + d_allocation.width > rect.width + rect.x)
1015 x = rect.x + rect.width - d_allocation.width;
1020 gtk_window_move (GTK_WINDOW (priv->dock), x, y);
1022 if (event->type == GDK_BUTTON_PRESS)
1023 GTK_WIDGET_CLASS (gtk_scale_button_parent_class)->button_press_event (widget, (GdkEventButton *) event);
1025 device = gdk_event_get_device (event);
1027 if (gdk_device_get_source (device) == GDK_SOURCE_KEYBOARD)
1030 pointer = gdk_device_get_associated_device (device);
1035 keyboard = gdk_device_get_associated_device (device);
1039 gtk_device_grab_add (priv->dock, pointer, TRUE);
1041 if (gdk_device_grab (pointer, gtk_widget_get_window (priv->dock),
1042 GDK_OWNERSHIP_WINDOW, TRUE,
1043 GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK |
1044 GDK_POINTER_MOTION_MASK, NULL, time) != GDK_GRAB_SUCCESS)
1046 gtk_device_grab_remove (priv->dock, pointer);
1047 gtk_widget_hide (priv->dock);
1051 if (gdk_device_grab (keyboard, gtk_widget_get_window (priv->dock),
1052 GDK_OWNERSHIP_WINDOW, TRUE,
1053 GDK_KEY_PRESS_MASK | GDK_KEY_RELEASE_MASK,
1054 NULL, time) != GDK_GRAB_SUCCESS)
1056 gdk_device_ungrab (pointer, time);
1057 gtk_device_grab_remove (priv->dock, pointer);
1058 gtk_widget_hide (priv->dock);
1062 gtk_widget_grab_focus (priv->dock);
1063 priv->grab_keyboard = keyboard;
1064 priv->grab_pointer = pointer;
1066 if (event->type == GDK_BUTTON_PRESS && !is_moved)
1069 GdkEventButton *button_event = (GdkEventButton *) event;
1071 /* forward event to the slider */
1072 e = (GdkEventButton *) gdk_event_copy ((GdkEvent *) event);
1073 e->window = gtk_widget_get_window (priv->scale);
1075 /* position: the X position isn't relevant, halfway will work just fine.
1076 * The vertical position should be *exactly* in the middle of the slider
1077 * of the scale; if we don't do that correctly, it'll move from its current
1078 * position, which means a position change on-click, which is bad.
1080 gtk_widget_get_allocation (priv->scale, &scale_allocation);
1081 if (priv->orientation == GTK_ORIENTATION_VERTICAL)
1083 e->x = scale_allocation.width / 2;
1084 m = scale_allocation.height - min_slider_size;
1085 e->y = ((1.0 - v) * m) + min_slider_size / 2;
1089 e->y = scale_allocation.height / 2;
1090 m = scale_allocation.width - min_slider_size;
1091 e->x = (v * m) + min_slider_size / 2;
1094 gtk_widget_event (priv->scale, (GdkEvent *) e);
1095 e->window = button_event->window;
1096 gdk_event_free ((GdkEvent *) e);
1099 gtk_widget_grab_focus (priv->scale);
1101 priv->pop_time = time;
1107 gtk_scale_button_press (GtkWidget *widget,
1108 GdkEventButton *event)
1110 return gtk_scale_popup (widget, (GdkEvent *) event, event->time);
1114 gtk_scale_button_popup (GtkWidget *widget)
1118 /* This is a callback for a keybinding signal,
1119 * current event should be the key event that
1122 ev = gtk_get_current_event ();
1124 if (ev->type != GDK_KEY_PRESS &&
1125 ev->type != GDK_KEY_RELEASE)
1127 gdk_event_free (ev);
1128 ev = gdk_event_new (GDK_KEY_RELEASE);
1129 ev->key.time = GDK_CURRENT_TIME;
1132 gtk_scale_popup (widget, ev, ev->key.time);
1133 gdk_event_free (ev);
1137 gtk_scale_button_key_release (GtkWidget *widget,
1140 return gtk_bindings_activate_event (G_OBJECT (widget), event);
1143 /* This is called when the grab is broken for
1144 * either the dock, or the scale itself */
1146 gtk_scale_button_grab_notify (GtkScaleButton *button,
1147 gboolean was_grabbed)
1149 GtkScaleButtonPrivate *priv;
1150 GtkWidget *toplevel, *grab_widget;
1151 GtkWindowGroup *group;
1153 priv = button->priv;
1155 if (!priv->grab_pointer ||
1156 !gtk_widget_device_is_shadowed (GTK_WIDGET (button), priv->grab_pointer))
1159 toplevel = gtk_widget_get_toplevel (GTK_WIDGET (button));
1161 if (GTK_IS_WINDOW (toplevel))
1162 group = gtk_window_get_group (GTK_WINDOW (toplevel));
1164 group = gtk_window_get_group (NULL);
1166 grab_widget = gtk_window_group_get_current_device_grab (group, priv->grab_pointer);
1169 gtk_widget_is_ancestor (grab_widget, priv->dock))
1172 gdk_device_ungrab (priv->grab_keyboard, GDK_CURRENT_TIME);
1173 gdk_device_ungrab (priv->grab_pointer, GDK_CURRENT_TIME);
1174 gtk_device_grab_remove (priv->dock, priv->grab_pointer);
1176 priv->grab_keyboard = NULL;
1177 priv->grab_pointer = NULL;
1180 gtk_widget_hide (priv->dock);
1181 priv->timeout = FALSE;
1185 * +/- button callbacks.
1189 cb_button_timeout (gpointer user_data)
1191 GtkScaleButton *button;
1192 GtkScaleButtonPrivate *priv;
1193 GtkAdjustment *adjustment;
1195 gboolean res = TRUE;
1197 button = GTK_SCALE_BUTTON (user_data);
1198 priv = button->priv;
1200 if (priv->click_id == 0)
1203 adjustment = priv->adjustment;
1205 val = gtk_scale_button_get_value (button);
1206 val += priv->direction;
1207 if (val <= gtk_adjustment_get_lower (adjustment))
1210 val = gtk_adjustment_get_lower (adjustment);
1212 else if (val > gtk_adjustment_get_upper (adjustment))
1215 val = gtk_adjustment_get_upper (adjustment);
1217 gtk_scale_button_set_value (button, val);
1221 g_source_remove (priv->click_id);
1229 cb_button_press (GtkWidget *widget,
1230 GdkEventButton *event,
1233 GtkScaleButton *button;
1234 GtkScaleButtonPrivate *priv;
1235 GtkAdjustment *adjustment;
1237 button = GTK_SCALE_BUTTON (user_data);
1238 priv = button->priv;
1239 adjustment = priv->adjustment;
1241 if (priv->click_id != 0)
1242 g_source_remove (priv->click_id);
1244 if (widget == priv->plus_button)
1245 priv->direction = fabs (gtk_adjustment_get_page_increment (adjustment));
1247 priv->direction = - fabs (gtk_adjustment_get_page_increment (adjustment));
1249 priv->click_id = gdk_threads_add_timeout (priv->click_timeout,
1252 cb_button_timeout (button);
1258 cb_button_release (GtkWidget *widget,
1259 GdkEventButton *event,
1262 GtkScaleButton *button;
1263 GtkScaleButtonPrivate *priv;
1265 button = GTK_SCALE_BUTTON (user_data);
1266 priv = button->priv;
1268 if (priv->click_id != 0)
1270 g_source_remove (priv->click_id);
1278 cb_dock_grab_notify (GtkWidget *widget,
1279 gboolean was_grabbed,
1282 GtkScaleButton *button = (GtkScaleButton *) user_data;
1284 gtk_scale_button_grab_notify (button, was_grabbed);
1288 cb_dock_grab_broken_event (GtkWidget *widget,
1289 gboolean was_grabbed,
1292 GtkScaleButton *button = (GtkScaleButton *) user_data;
1294 gtk_scale_button_grab_notify (button, FALSE);
1299 /* Scale callbacks */
1302 gtk_scale_button_release_grab (GtkScaleButton *button,
1303 GdkEventButton *event)
1306 GtkScaleButtonPrivate *priv;
1308 priv = button->priv;
1311 gdk_device_ungrab (priv->grab_keyboard, event->time);
1312 gdk_device_ungrab (priv->grab_pointer, event->time);
1313 gtk_device_grab_remove (priv->dock, priv->grab_pointer);
1315 priv->grab_keyboard = NULL;
1316 priv->grab_pointer = NULL;
1319 gtk_widget_hide (priv->dock);
1320 priv->timeout = FALSE;
1322 e = (GdkEventButton *) gdk_event_copy ((GdkEvent *) event);
1323 e->window = gtk_widget_get_window (GTK_WIDGET (button));
1324 e->type = GDK_BUTTON_RELEASE;
1325 gtk_widget_event (GTK_WIDGET (button), (GdkEvent *) e);
1326 e->window = event->window;
1327 gdk_event_free ((GdkEvent *) e);
1331 cb_dock_button_press (GtkWidget *widget,
1332 GdkEventButton *event,
1335 GtkScaleButton *button = GTK_SCALE_BUTTON (user_data);
1337 if (event->type == GDK_BUTTON_PRESS)
1339 gtk_scale_button_release_grab (button, event);
1347 gtk_scale_button_popdown (GtkWidget *widget)
1349 GtkScaleButton *button;
1350 GtkScaleButtonPrivate *priv;
1352 button = GTK_SCALE_BUTTON (widget);
1353 priv = button->priv;
1356 gdk_device_ungrab (priv->grab_keyboard, GDK_CURRENT_TIME);
1357 gdk_device_ungrab (priv->grab_pointer, GDK_CURRENT_TIME);
1358 gtk_device_grab_remove (priv->dock, priv->grab_pointer);
1360 priv->grab_keyboard = NULL;
1361 priv->grab_pointer = NULL;
1364 gtk_widget_hide (priv->dock);
1365 priv->timeout = FALSE;
1369 cb_dock_key_release (GtkWidget *widget,
1373 if (event->keyval == GDK_KEY_Escape)
1375 gtk_scale_button_popdown (GTK_WIDGET (user_data));
1379 if (!gtk_bindings_activate_event (G_OBJECT (widget), event))
1381 /* The popup hasn't managed the event, pass onto the button */
1382 gtk_bindings_activate_event (G_OBJECT (user_data), event);
1389 cb_scale_grab_notify (GtkWidget *widget,
1390 gboolean was_grabbed,
1393 GtkScaleButton *button = (GtkScaleButton *) user_data;
1395 gtk_scale_button_grab_notify (button, was_grabbed);
1402 #define GTK_TYPE_SCALE_BUTTON_SCALE (_gtk_scale_button_scale_get_type ())
1403 #define GTK_SCALE_BUTTON_SCALE(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_SCALE_BUTTON_SCALE, GtkScaleButtonScale))
1404 #define GTK_IS_SCALE_BUTTON_SCALE(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_SCALE_BUTTON_SCALE))
1406 typedef struct _GtkScaleButtonScale
1408 GtkScale parent_instance;
1409 GtkScaleButton *button;
1410 } GtkScaleButtonScale;
1412 typedef struct _GtkScaleButtonScaleClass
1414 GtkScaleClass parent_class;
1415 } GtkScaleButtonScaleClass;
1417 static gboolean gtk_scale_button_scale_press (GtkWidget *widget,
1418 GdkEventButton *event);
1419 static gboolean gtk_scale_button_scale_release (GtkWidget *widget,
1420 GdkEventButton *event);
1422 G_DEFINE_TYPE (GtkScaleButtonScale, _gtk_scale_button_scale, GTK_TYPE_SCALE)
1425 _gtk_scale_button_scale_class_init (GtkScaleButtonScaleClass *klass)
1427 GtkWidgetClass *gtkwidget_class = GTK_WIDGET_CLASS (klass);
1428 GtkRangeClass *gtkrange_class = GTK_RANGE_CLASS (klass);
1430 gtkwidget_class->button_press_event = gtk_scale_button_scale_press;
1431 gtkwidget_class->button_release_event = gtk_scale_button_scale_release;
1432 gtkrange_class->value_changed = gtk_scale_button_scale_value_changed;
1436 _gtk_scale_button_scale_init (GtkScaleButtonScale *scale)
1441 gtk_scale_button_scale_new (GtkScaleButton *button)
1443 GtkScaleButtonPrivate *priv = button->priv;
1444 GtkScaleButtonScale *scale;
1446 scale = g_object_new (GTK_TYPE_SCALE_BUTTON_SCALE,
1447 "orientation", priv->orientation,
1448 "adjustment", priv->adjustment,
1449 "draw-value", FALSE,
1452 scale->button = button;
1454 g_signal_connect (scale, "grab-notify",
1455 G_CALLBACK (cb_scale_grab_notify), button);
1457 if (priv->orientation == GTK_ORIENTATION_VERTICAL)
1459 gtk_widget_set_size_request (GTK_WIDGET (scale), -1, SCALE_SIZE);
1460 gtk_range_set_inverted (GTK_RANGE (scale), TRUE);
1464 gtk_widget_set_size_request (GTK_WIDGET (scale), SCALE_SIZE, -1);
1465 gtk_range_set_inverted (GTK_RANGE (scale), FALSE);
1468 return GTK_WIDGET (scale);
1472 gtk_scale_button_scale_press (GtkWidget *widget,
1473 GdkEventButton *event)
1475 GtkScaleButtonPrivate *priv = GTK_SCALE_BUTTON_SCALE (widget)->button->priv;
1477 /* the scale will grab input; if we have input grabbed, all goes
1478 * horribly wrong, so let's not do that.
1480 gtk_device_grab_remove (priv->dock, event->device);
1482 return GTK_WIDGET_CLASS (_gtk_scale_button_scale_parent_class)->button_press_event (widget, event);
1486 gtk_scale_button_scale_release (GtkWidget *widget,
1487 GdkEventButton *event)
1489 GtkScaleButton *button = GTK_SCALE_BUTTON_SCALE (widget)->button;
1492 if (button->priv->timeout)
1494 /* if we did a quick click, leave the window open; else, hide it */
1495 if (event->time > button->priv->pop_time + button->priv->click_timeout)
1498 gtk_scale_button_release_grab (button, event);
1499 GTK_WIDGET_CLASS (_gtk_scale_button_scale_parent_class)->button_release_event (widget, event);
1504 button->priv->timeout = FALSE;
1507 res = GTK_WIDGET_CLASS (_gtk_scale_button_scale_parent_class)->button_release_event (widget, event);
1509 /* the scale will release input; right after that, we *have to* grab
1510 * it back so we can catch out-of-scale clicks and hide the popup,
1511 * so I basically want a g_signal_connect_after_always(), but I can't
1512 * find that, so we do this complex 'first-call-parent-then-do-actual-
1515 gtk_device_grab_add (button->priv->dock, event->device, TRUE);
1521 gtk_scale_button_update_icon (GtkScaleButton *button)
1523 GtkScaleButtonPrivate *priv;
1524 GtkAdjustment *adjustment;
1529 priv = button->priv;
1531 if (!priv->icon_list || priv->icon_list[0] == '\0')
1533 gtk_image_set_from_stock (GTK_IMAGE (priv->image),
1534 GTK_STOCK_MISSING_IMAGE,
1539 num_icons = g_strv_length (priv->icon_list);
1541 /* The 1-icon special case */
1544 gtk_image_set_from_icon_name (GTK_IMAGE (priv->image),
1550 adjustment = priv->adjustment;
1551 value = gtk_scale_button_get_value (button);
1553 /* The 2-icons special case */
1558 limit = (gtk_adjustment_get_upper (adjustment) - gtk_adjustment_get_lower (adjustment)) / 2 + gtk_adjustment_get_lower (adjustment);
1560 name = priv->icon_list[0];
1562 name = priv->icon_list[1];
1564 gtk_image_set_from_icon_name (GTK_IMAGE (priv->image),
1570 /* With 3 or more icons */
1571 if (value == gtk_adjustment_get_lower (adjustment))
1573 name = priv->icon_list[0];
1575 else if (value == gtk_adjustment_get_upper (adjustment))
1577 name = priv->icon_list[1];
1584 step = (gtk_adjustment_get_upper (adjustment) - gtk_adjustment_get_lower (adjustment)) / (num_icons - 2);
1585 i = (guint) ((value - gtk_adjustment_get_lower (adjustment)) / step) + 2;
1586 g_assert (i < num_icons);
1587 name = priv->icon_list[i];
1590 gtk_image_set_from_icon_name (GTK_IMAGE (priv->image),
1596 gtk_scale_button_scale_value_changed (GtkRange *range)
1598 GtkScaleButton *button = GTK_SCALE_BUTTON_SCALE (range)->button;
1601 value = gtk_range_get_value (range);
1603 gtk_scale_button_update_icon (button);
1605 g_signal_emit (button, signals[VALUE_CHANGED], 0, value);
1606 g_object_notify (G_OBJECT (button), "value");