1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
3 * Copyright (C) 2001 Red Hat, Inc.
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 * Boston, MA 02111-1307, USA.
22 * Modified by the GTK+ Team and others 1997-2004. See the AUTHORS
23 * file for a list of people on the GTK+ Team. See the ChangeLog
24 * files for a list of changes. These files are distributed with
25 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
34 #include "gtkmarshalers.h"
37 #include "gtkscrollbar.h"
39 #define SCROLL_INITIAL_DELAY 250 /* must hold button this long before ... */
40 #define SCROLL_LATER_DELAY 100 /* ... it starts repeating at this rate */
41 #define UPDATE_DELAY 300 /* Delay for queued update */
66 MOUSE_WIDGET /* inside widget but not in any of the above GUI elements */
69 struct _GtkRangeLayout
71 /* These are in widget->window coordinates */
72 GdkRectangle stepper_a;
73 GdkRectangle stepper_b;
74 GdkRectangle stepper_c;
75 GdkRectangle stepper_d;
76 /* The trough rectangle is the area the thumb can slide in, not the
82 /* Layout-related state */
84 MouseLocation mouse_location;
85 /* last mouse coords we got, or -1 if mouse is outside the range */
88 /* "grabbed" mouse location, OUTSIDE for no grab */
89 MouseLocation grab_location;
90 gint grab_button; /* 0 if none */
94 static void gtk_range_class_init (GtkRangeClass *klass);
95 static void gtk_range_init (GtkRange *range);
96 static void gtk_range_set_property (GObject *object,
100 static void gtk_range_get_property (GObject *object,
104 static void gtk_range_destroy (GtkObject *object);
105 static void gtk_range_finalize (GObject *object);
106 static void gtk_range_size_request (GtkWidget *widget,
107 GtkRequisition *requisition);
108 static void gtk_range_size_allocate (GtkWidget *widget,
109 GtkAllocation *allocation);
110 static void gtk_range_realize (GtkWidget *widget);
111 static void gtk_range_unrealize (GtkWidget *widget);
112 static void gtk_range_map (GtkWidget *widget);
113 static void gtk_range_unmap (GtkWidget *widget);
114 static gint gtk_range_expose (GtkWidget *widget,
115 GdkEventExpose *event);
116 static gint gtk_range_button_press (GtkWidget *widget,
117 GdkEventButton *event);
118 static gint gtk_range_button_release (GtkWidget *widget,
119 GdkEventButton *event);
120 static gint gtk_range_motion_notify (GtkWidget *widget,
121 GdkEventMotion *event);
122 static gint gtk_range_enter_notify (GtkWidget *widget,
123 GdkEventCrossing *event);
124 static gint gtk_range_leave_notify (GtkWidget *widget,
125 GdkEventCrossing *event);
126 static void gtk_range_grab_notify (GtkWidget *widget,
127 gboolean was_grabbed);
128 static void gtk_range_state_changed (GtkWidget *widget,
129 GtkStateType previous_state);
130 static gint gtk_range_scroll_event (GtkWidget *widget,
131 GdkEventScroll *event);
132 static void gtk_range_style_set (GtkWidget *widget,
133 GtkStyle *previous_style);
134 static void update_slider_position (GtkRange *range,
141 static void gtk_range_move_slider (GtkRange *range,
142 GtkScrollType scroll);
145 static void gtk_range_scroll (GtkRange *range,
146 GtkScrollType scroll);
147 static gboolean gtk_range_update_mouse_location (GtkRange *range);
148 static void gtk_range_calc_layout (GtkRange *range,
149 gdouble adjustment_value);
150 static void gtk_range_get_props (GtkRange *range,
154 gint *stepper_spacing,
155 gint *arrow_displacement_x,
156 gint *arrow_displacement_y);
157 static void gtk_range_calc_request (GtkRange *range,
161 gint stepper_spacing,
162 GdkRectangle *range_rect,
165 gint *slider_length_p);
166 static void gtk_range_adjustment_value_changed (GtkAdjustment *adjustment,
168 static void gtk_range_adjustment_changed (GtkAdjustment *adjustment,
170 static void gtk_range_add_step_timer (GtkRange *range,
172 static void gtk_range_remove_step_timer (GtkRange *range);
173 static void gtk_range_reset_update_timer (GtkRange *range);
174 static void gtk_range_remove_update_timer (GtkRange *range);
175 static GdkRectangle* get_area (GtkRange *range,
176 MouseLocation location);
177 static gboolean gtk_range_real_change_value (GtkRange *range,
178 GtkScrollType scroll,
180 static void gtk_range_update_value (GtkRange *range);
183 static GtkWidgetClass *parent_class = NULL;
184 static guint signals[LAST_SIGNAL];
188 gtk_range_get_type (void)
190 static GType range_type = 0;
194 static const GTypeInfo range_info =
196 sizeof (GtkRangeClass),
197 NULL, /* base_init */
198 NULL, /* base_finalize */
199 (GClassInitFunc) gtk_range_class_init,
200 NULL, /* class_finalize */
201 NULL, /* class_data */
204 (GInstanceInitFunc) gtk_range_init,
205 NULL, /* value_table */
208 range_type = g_type_register_static (GTK_TYPE_WIDGET, "GtkRange",
209 &range_info, G_TYPE_FLAG_ABSTRACT);
216 gtk_range_class_init (GtkRangeClass *class)
218 GObjectClass *gobject_class;
219 GtkObjectClass *object_class;
220 GtkWidgetClass *widget_class;
222 gobject_class = G_OBJECT_CLASS (class);
223 object_class = (GtkObjectClass*) class;
224 widget_class = (GtkWidgetClass*) class;
226 parent_class = g_type_class_peek_parent (class);
228 gobject_class->set_property = gtk_range_set_property;
229 gobject_class->get_property = gtk_range_get_property;
230 gobject_class->finalize = gtk_range_finalize;
231 object_class->destroy = gtk_range_destroy;
233 widget_class->size_request = gtk_range_size_request;
234 widget_class->size_allocate = gtk_range_size_allocate;
235 widget_class->realize = gtk_range_realize;
236 widget_class->unrealize = gtk_range_unrealize;
237 widget_class->map = gtk_range_map;
238 widget_class->unmap = gtk_range_unmap;
239 widget_class->expose_event = gtk_range_expose;
240 widget_class->button_press_event = gtk_range_button_press;
241 widget_class->button_release_event = gtk_range_button_release;
242 widget_class->motion_notify_event = gtk_range_motion_notify;
243 widget_class->scroll_event = gtk_range_scroll_event;
244 widget_class->enter_notify_event = gtk_range_enter_notify;
245 widget_class->leave_notify_event = gtk_range_leave_notify;
246 widget_class->grab_notify = gtk_range_grab_notify;
247 widget_class->state_changed = gtk_range_state_changed;
248 widget_class->style_set = gtk_range_style_set;
250 class->move_slider = gtk_range_move_slider;
251 class->change_value = gtk_range_real_change_value;
253 class->slider_detail = "slider";
254 class->stepper_detail = "stepper";
256 signals[VALUE_CHANGED] =
257 g_signal_new ("value_changed",
258 G_TYPE_FROM_CLASS (gobject_class),
260 G_STRUCT_OFFSET (GtkRangeClass, value_changed),
262 _gtk_marshal_NONE__NONE,
265 signals[ADJUST_BOUNDS] =
266 g_signal_new ("adjust_bounds",
267 G_TYPE_FROM_CLASS (gobject_class),
269 G_STRUCT_OFFSET (GtkRangeClass, adjust_bounds),
271 _gtk_marshal_VOID__DOUBLE,
275 signals[MOVE_SLIDER] =
276 g_signal_new ("move_slider",
277 G_TYPE_FROM_CLASS (gobject_class),
278 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
279 G_STRUCT_OFFSET (GtkRangeClass, move_slider),
281 _gtk_marshal_VOID__ENUM,
283 GTK_TYPE_SCROLL_TYPE);
286 * GtkRange::change-value:
287 * @range: the range that received the signal.
288 * @scroll: the type of scroll action that was performed.
289 * @value: the new value resulting from the scroll action.
290 * @returns: %TRUE to prevent other handlers from being invoked for the
291 * signal. %FALSE to propagate the signal further.
293 * The ::change-value signal is emitted when a scroll action is
294 * performed on a range. It allows an application to determine the
295 * type of scroll event that occurred and the resultant new value.
296 * The application can handle the event itself and return %TRUE to
297 * prevent further processing. Or, by returning %FALSE, it can pass
298 * the event to other handlers until the default GTK+ handler is
301 * The value parameter is unrounded. An application that overrides
302 * the ::change-value signal is responsible for clamping the value to
303 * the desired number of digits; the default GTK+ handler clamps the
304 * value based on @range->round_digits.
306 * It is not possible to use delayed update policies in an overridden
307 * ::change-value handler.
311 signals[CHANGE_VALUE] =
312 g_signal_new ("change_value",
313 G_TYPE_FROM_CLASS (gobject_class),
315 G_STRUCT_OFFSET (GtkRangeClass, change_value),
316 _gtk_boolean_handled_accumulator, NULL,
317 _gtk_marshal_BOOLEAN__ENUM_DOUBLE,
319 GTK_TYPE_SCROLL_TYPE,
322 g_object_class_install_property (gobject_class,
324 g_param_spec_enum ("update_policy",
326 P_("How the range should be updated on the screen"),
327 GTK_TYPE_UPDATE_TYPE,
328 GTK_UPDATE_CONTINUOUS,
331 g_object_class_install_property (gobject_class,
333 g_param_spec_object ("adjustment",
335 P_("The GtkAdjustment that contains the current value of this range object"),
337 G_PARAM_READWRITE | G_PARAM_CONSTRUCT));
339 g_object_class_install_property (gobject_class,
341 g_param_spec_boolean ("inverted",
343 P_("Invert direction slider moves to increase range value"),
347 gtk_widget_class_install_style_property (widget_class,
348 g_param_spec_int ("slider_width",
350 P_("Width of scrollbar or scale thumb"),
355 gtk_widget_class_install_style_property (widget_class,
356 g_param_spec_int ("trough_border",
358 P_("Spacing between thumb/steppers and outer trough bevel"),
363 gtk_widget_class_install_style_property (widget_class,
364 g_param_spec_int ("stepper_size",
366 P_("Length of step buttons at ends"),
371 gtk_widget_class_install_style_property (widget_class,
372 g_param_spec_int ("stepper_spacing",
373 P_("Stepper Spacing"),
374 P_("Spacing between step buttons and thumb"),
379 gtk_widget_class_install_style_property (widget_class,
380 g_param_spec_int ("arrow_displacement_x",
381 P_("Arrow X Displacement"),
382 P_("How far in the x direction to move the arrow when the button is depressed"),
387 gtk_widget_class_install_style_property (widget_class,
388 g_param_spec_int ("arrow_displacement_y",
389 P_("Arrow Y Displacement"),
390 P_("How far in the y direction to move the arrow when the button is depressed"),
398 gtk_range_set_property (GObject *object,
405 range = GTK_RANGE (object);
409 case PROP_UPDATE_POLICY:
410 gtk_range_set_update_policy (range, g_value_get_enum (value));
412 case PROP_ADJUSTMENT:
413 gtk_range_set_adjustment (range, g_value_get_object (value));
416 gtk_range_set_inverted (range, g_value_get_boolean (value));
419 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
425 gtk_range_get_property (GObject *object,
432 range = GTK_RANGE (object);
436 case PROP_UPDATE_POLICY:
437 g_value_set_enum (value, range->update_policy);
439 case PROP_ADJUSTMENT:
440 g_value_set_object (value, range->adjustment);
443 g_value_set_boolean (value, range->inverted);
446 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
452 gtk_range_init (GtkRange *range)
454 GTK_WIDGET_SET_FLAGS (range, GTK_NO_WINDOW);
456 range->adjustment = NULL;
457 range->update_policy = GTK_UPDATE_CONTINUOUS;
458 range->inverted = FALSE;
459 range->flippable = FALSE;
460 range->min_slider_size = 1;
461 range->has_stepper_a = FALSE;
462 range->has_stepper_b = FALSE;
463 range->has_stepper_c = FALSE;
464 range->has_stepper_d = FALSE;
465 range->need_recalc = TRUE;
466 range->round_digits = -1;
467 range->layout = g_new0 (GtkRangeLayout, 1);
468 range->layout->mouse_location = MOUSE_OUTSIDE;
469 range->layout->mouse_x = -1;
470 range->layout->mouse_y = -1;
471 range->layout->grab_location = MOUSE_OUTSIDE;
472 range->layout->grab_button = 0;
477 * gtk_range_get_adjustment:
478 * @range: a #GtkRange
480 * Get the #GtkAdjustment which is the "model" object for #GtkRange.
481 * See gtk_range_set_adjustment() for details.
482 * The return value does not have a reference added, so should not
485 * Return value: a #GtkAdjustment
488 gtk_range_get_adjustment (GtkRange *range)
490 g_return_val_if_fail (GTK_IS_RANGE (range), NULL);
492 if (!range->adjustment)
493 gtk_range_set_adjustment (range, NULL);
495 return range->adjustment;
499 * gtk_range_set_update_policy:
500 * @range: a #GtkRange
501 * @policy: update policy
503 * Sets the update policy for the range. #GTK_UPDATE_CONTINUOUS means that
504 * anytime the range slider is moved, the range value will change and the
505 * value_changed signal will be emitted. #GTK_UPDATE_DELAYED means that
506 * the value will be updated after a brief timeout where no slider motion
507 * occurs, so updates are spaced by a short time rather than
508 * continuous. #GTK_UPDATE_DISCONTINUOUS means that the value will only
509 * be updated when the user releases the button and ends the slider
514 gtk_range_set_update_policy (GtkRange *range,
515 GtkUpdateType policy)
517 g_return_if_fail (GTK_IS_RANGE (range));
519 if (range->update_policy != policy)
521 range->update_policy = policy;
522 g_object_notify (G_OBJECT (range), "update_policy");
527 * gtk_range_get_update_policy:
528 * @range: a #GtkRange
530 * Gets the update policy of @range. See gtk_range_set_update_policy().
532 * Return value: the current update policy
535 gtk_range_get_update_policy (GtkRange *range)
537 g_return_val_if_fail (GTK_IS_RANGE (range), GTK_UPDATE_CONTINUOUS);
539 return range->update_policy;
543 * gtk_range_set_adjustment:
544 * @range: a #GtkRange
545 * @adjustment: a #GtkAdjustment
547 * Sets the adjustment to be used as the "model" object for this range
548 * widget. The adjustment indicates the current range value, the
549 * minimum and maximum range values, the step/page increments used
550 * for keybindings and scrolling, and the page size. The page size
551 * is normally 0 for #GtkScale and nonzero for #GtkScrollbar, and
552 * indicates the size of the visible area of the widget being scrolled.
553 * The page size affects the size of the scrollbar slider.
557 gtk_range_set_adjustment (GtkRange *range,
558 GtkAdjustment *adjustment)
560 g_return_if_fail (GTK_IS_RANGE (range));
563 adjustment = (GtkAdjustment*) gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0);
565 g_return_if_fail (GTK_IS_ADJUSTMENT (adjustment));
567 if (range->adjustment != adjustment)
569 if (range->adjustment)
571 g_signal_handlers_disconnect_by_func (range->adjustment,
572 gtk_range_adjustment_changed,
574 g_signal_handlers_disconnect_by_func (range->adjustment,
575 gtk_range_adjustment_value_changed,
577 g_object_unref (range->adjustment);
580 range->adjustment = adjustment;
581 g_object_ref (adjustment);
582 gtk_object_sink (GTK_OBJECT (adjustment));
584 g_signal_connect (adjustment, "changed",
585 G_CALLBACK (gtk_range_adjustment_changed),
587 g_signal_connect (adjustment, "value_changed",
588 G_CALLBACK (gtk_range_adjustment_value_changed),
591 gtk_range_adjustment_changed (adjustment, range);
592 g_object_notify (G_OBJECT (range), "adjustment");
597 * gtk_range_set_inverted:
598 * @range: a #GtkRange
599 * @setting: %TRUE to invert the range
601 * Ranges normally move from lower to higher values as the
602 * slider moves from top to bottom or left to right. Inverted
603 * ranges have higher values at the top or on the right rather than
604 * on the bottom or left.
608 gtk_range_set_inverted (GtkRange *range,
611 g_return_if_fail (GTK_IS_RANGE (range));
613 setting = setting != FALSE;
615 if (setting != range->inverted)
617 range->inverted = setting;
618 g_object_notify (G_OBJECT (range), "inverted");
619 gtk_widget_queue_resize (GTK_WIDGET (range));
624 * gtk_range_get_inverted:
625 * @range: a #GtkRange
627 * Gets the value set by gtk_range_set_inverted().
629 * Return value: %TRUE if the range is inverted
632 gtk_range_get_inverted (GtkRange *range)
634 g_return_val_if_fail (GTK_IS_RANGE (range), FALSE);
636 return range->inverted;
640 * gtk_range_set_increments:
641 * @range: a #GtkRange
645 * Sets the step and page sizes for the range.
646 * The step size is used when the user clicks the #GtkScrollbar
647 * arrows or moves #GtkScale via arrow keys. The page size
648 * is used for example when moving via Page Up or Page Down keys.
652 gtk_range_set_increments (GtkRange *range,
656 g_return_if_fail (GTK_IS_RANGE (range));
658 range->adjustment->step_increment = step;
659 range->adjustment->page_increment = page;
661 gtk_adjustment_changed (range->adjustment);
665 * gtk_range_set_range:
666 * @range: a #GtkRange
667 * @min: minimum range value
668 * @max: maximum range value
670 * Sets the allowable values in the #GtkRange, and clamps the range
671 * value to be between @min and @max. (If the range has a non-zero
672 * page size, it is clamped between @min and @max - page-size.)
675 gtk_range_set_range (GtkRange *range,
681 g_return_if_fail (GTK_IS_RANGE (range));
682 g_return_if_fail (min < max);
684 range->adjustment->lower = min;
685 range->adjustment->upper = max;
687 value = CLAMP (range->adjustment->value,
688 range->adjustment->lower,
689 (range->adjustment->upper - range->adjustment->page_size));
691 gtk_adjustment_set_value (range->adjustment, value);
692 gtk_adjustment_changed (range->adjustment);
696 * gtk_range_set_value:
697 * @range: a #GtkRange
698 * @value: new value of the range
700 * Sets the current value of the range; if the value is outside the
701 * minimum or maximum range values, it will be clamped to fit inside
702 * them. The range emits the "value_changed" signal if the value
707 gtk_range_set_value (GtkRange *range,
710 g_return_if_fail (GTK_IS_RANGE (range));
712 value = CLAMP (value, range->adjustment->lower,
713 (range->adjustment->upper - range->adjustment->page_size));
715 gtk_adjustment_set_value (range->adjustment, value);
719 * gtk_range_get_value:
720 * @range: a #GtkRange
722 * Gets the current value of the range.
724 * Return value: current value of the range.
727 gtk_range_get_value (GtkRange *range)
729 g_return_val_if_fail (GTK_IS_RANGE (range), 0.0);
731 return range->adjustment->value;
735 should_invert (GtkRange *range)
737 if (range->orientation == GTK_ORIENTATION_HORIZONTAL)
739 (range->inverted && !range->flippable) ||
740 (range->inverted && range->flippable && gtk_widget_get_direction (GTK_WIDGET (range)) == GTK_TEXT_DIR_LTR) ||
741 (!range->inverted && range->flippable && gtk_widget_get_direction (GTK_WIDGET (range)) == GTK_TEXT_DIR_RTL);
743 return range->inverted;
747 gtk_range_finalize (GObject *object)
749 GtkRange *range = GTK_RANGE (object);
751 g_free (range->layout);
753 (* G_OBJECT_CLASS (parent_class)->finalize) (object);
757 gtk_range_destroy (GtkObject *object)
759 GtkRange *range = GTK_RANGE (object);
761 gtk_range_remove_step_timer (range);
762 gtk_range_remove_update_timer (range);
764 if (range->adjustment)
766 g_signal_handlers_disconnect_by_func (range->adjustment,
767 gtk_range_adjustment_changed,
769 g_signal_handlers_disconnect_by_func (range->adjustment,
770 gtk_range_adjustment_value_changed,
772 g_object_unref (range->adjustment);
773 range->adjustment = NULL;
776 (* GTK_OBJECT_CLASS (parent_class)->destroy) (object);
780 gtk_range_size_request (GtkWidget *widget,
781 GtkRequisition *requisition)
784 gint slider_width, stepper_size, trough_border, stepper_spacing;
785 GdkRectangle range_rect;
788 range = GTK_RANGE (widget);
790 gtk_range_get_props (range,
791 &slider_width, &stepper_size, &trough_border, &stepper_spacing,
794 gtk_range_calc_request (range,
795 slider_width, stepper_size, trough_border, stepper_spacing,
796 &range_rect, &border, NULL, NULL);
798 requisition->width = range_rect.width + border.left + border.right;
799 requisition->height = range_rect.height + border.top + border.bottom;
803 gtk_range_size_allocate (GtkWidget *widget,
804 GtkAllocation *allocation)
808 range = GTK_RANGE (widget);
810 widget->allocation = *allocation;
812 range->need_recalc = TRUE;
813 gtk_range_calc_layout (range, range->adjustment->value);
815 if (GTK_WIDGET_REALIZED (range))
816 gdk_window_move_resize (range->event_window,
817 widget->allocation.x,
818 widget->allocation.y,
819 widget->allocation.width,
820 widget->allocation.height);
824 gtk_range_realize (GtkWidget *widget)
827 GdkWindowAttr attributes;
828 gint attributes_mask;
830 range = GTK_RANGE (widget);
832 gtk_range_calc_layout (range, range->adjustment->value);
834 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
836 widget->window = gtk_widget_get_parent_window (widget);
837 g_object_ref (widget->window);
839 attributes.window_type = GDK_WINDOW_CHILD;
840 attributes.x = widget->allocation.x;
841 attributes.y = widget->allocation.y;
842 attributes.width = widget->allocation.width;
843 attributes.height = widget->allocation.height;
844 attributes.wclass = GDK_INPUT_ONLY;
845 attributes.event_mask = gtk_widget_get_events (widget);
846 attributes.event_mask |= (GDK_BUTTON_PRESS_MASK |
847 GDK_BUTTON_RELEASE_MASK |
848 GDK_ENTER_NOTIFY_MASK |
849 GDK_LEAVE_NOTIFY_MASK |
850 GDK_POINTER_MOTION_MASK |
851 GDK_POINTER_MOTION_HINT_MASK);
853 attributes_mask = GDK_WA_X | GDK_WA_Y;
855 range->event_window = gdk_window_new (gtk_widget_get_parent_window (widget),
856 &attributes, attributes_mask);
857 gdk_window_set_user_data (range->event_window, range);
859 widget->style = gtk_style_attach (widget->style, widget->window);
863 gtk_range_unrealize (GtkWidget *widget)
865 GtkRange *range = GTK_RANGE (widget);
867 gtk_range_remove_step_timer (range);
868 gtk_range_remove_update_timer (range);
870 gdk_window_set_user_data (range->event_window, NULL);
871 gdk_window_destroy (range->event_window);
872 range->event_window = NULL;
874 if (GTK_WIDGET_CLASS (parent_class)->unrealize)
875 (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
879 gtk_range_map (GtkWidget *widget)
881 GtkRange *range = GTK_RANGE (widget);
883 gdk_window_show (range->event_window);
885 GTK_WIDGET_CLASS (parent_class)->map (widget);
889 gtk_range_unmap (GtkWidget *widget)
891 GtkRange *range = GTK_RANGE (widget);
893 gdk_window_hide (range->event_window);
895 GTK_WIDGET_CLASS (parent_class)->unmap (widget);
899 draw_stepper (GtkRange *range,
901 GtkArrowType arrow_type,
906 GtkStateType state_type;
907 GtkShadowType shadow_type;
908 GdkRectangle intersection;
909 GtkWidget *widget = GTK_WIDGET (range);
916 /* More to get the right clip region than for efficiency */
917 if (!gdk_rectangle_intersect (area, rect, &intersection))
920 intersection.x += widget->allocation.x;
921 intersection.y += widget->allocation.y;
923 if (!GTK_WIDGET_IS_SENSITIVE (range))
924 state_type = GTK_STATE_INSENSITIVE;
926 state_type = GTK_STATE_ACTIVE;
928 state_type = GTK_STATE_PRELIGHT;
930 state_type = GTK_STATE_NORMAL;
933 shadow_type = GTK_SHADOW_IN;
935 shadow_type = GTK_SHADOW_OUT;
937 gtk_paint_box (widget->style,
939 state_type, shadow_type,
940 &intersection, widget,
941 GTK_RANGE_GET_CLASS (range)->stepper_detail,
942 widget->allocation.x + rect->x,
943 widget->allocation.y + rect->y,
947 arrow_width = rect->width / 2;
948 arrow_height = rect->height / 2;
949 arrow_x = widget->allocation.x + rect->x + (rect->width - arrow_width) / 2;
950 arrow_y = widget->allocation.y + rect->y + (rect->height - arrow_height) / 2;
954 gint arrow_displacement_x;
955 gint arrow_displacement_y;
957 gtk_range_get_props (GTK_RANGE (widget), NULL, NULL, NULL, NULL,
958 &arrow_displacement_x, &arrow_displacement_y);
960 arrow_x += arrow_displacement_x;
961 arrow_y += arrow_displacement_y;
964 gtk_paint_arrow (widget->style,
966 state_type, shadow_type,
967 &intersection, widget,
968 GTK_RANGE_GET_CLASS (range)->stepper_detail,
971 arrow_x, arrow_y, arrow_width, arrow_height);
975 gtk_range_expose (GtkWidget *widget,
976 GdkEventExpose *event)
981 GdkRectangle expose_area; /* Relative to widget->allocation */
983 gint focus_line_width = 0;
984 gint focus_padding = 0;
986 range = GTK_RANGE (widget);
988 if (GTK_WIDGET_CAN_FOCUS (range))
990 gtk_widget_style_get (GTK_WIDGET (range),
991 "focus-line-width", &focus_line_width,
992 "focus-padding", &focus_padding,
996 expose_area = event->area;
997 expose_area.x -= widget->allocation.x;
998 expose_area.y -= widget->allocation.y;
1000 gtk_range_calc_layout (range, range->adjustment->value);
1002 sensitive = GTK_WIDGET_IS_SENSITIVE (widget);
1004 /* Just to be confusing, we draw the trough for the whole
1005 * range rectangle, not the trough rectangle (the trough
1006 * rectangle is just for hit detection)
1008 /* The gdk_rectangle_intersect is more to get the right
1009 * clip region (limited to range_rect) than for efficiency
1011 if (gdk_rectangle_intersect (&expose_area, &range->range_rect,
1014 area.x += widget->allocation.x;
1015 area.y += widget->allocation.y;
1017 gtk_paint_box (widget->style,
1019 sensitive ? GTK_STATE_ACTIVE : GTK_STATE_INSENSITIVE,
1021 &area, GTK_WIDGET(range), "trough",
1022 widget->allocation.x + range->range_rect.x + focus_line_width + focus_padding,
1023 widget->allocation.y + range->range_rect.y + focus_line_width + focus_padding,
1024 range->range_rect.width - 2 * (focus_line_width + focus_padding),
1025 range->range_rect.height - 2 * (focus_line_width + focus_padding));
1029 GTK_WIDGET_HAS_FOCUS (range))
1030 gtk_paint_focus (widget->style, widget->window, GTK_WIDGET_STATE (widget),
1031 &area, widget, "trough",
1032 widget->allocation.x + range->range_rect.x,
1033 widget->allocation.y + range->range_rect.y,
1034 range->range_rect.width,
1035 range->range_rect.height);
1039 state = GTK_STATE_INSENSITIVE;
1040 else if (range->layout->mouse_location == MOUSE_SLIDER)
1041 state = GTK_STATE_PRELIGHT;
1043 state = GTK_STATE_NORMAL;
1045 if (gdk_rectangle_intersect (&expose_area,
1046 &range->layout->slider,
1049 area.x += widget->allocation.x;
1050 area.y += widget->allocation.y;
1052 gtk_paint_slider (widget->style,
1058 GTK_RANGE_GET_CLASS (range)->slider_detail,
1059 widget->allocation.x + range->layout->slider.x,
1060 widget->allocation.y + range->layout->slider.y,
1061 range->layout->slider.width,
1062 range->layout->slider.height,
1063 range->orientation);
1066 if (range->has_stepper_a)
1067 draw_stepper (range, &range->layout->stepper_a,
1068 range->orientation == GTK_ORIENTATION_VERTICAL ? GTK_ARROW_UP : GTK_ARROW_LEFT,
1069 range->layout->grab_location == MOUSE_STEPPER_A,
1070 range->layout->mouse_location == MOUSE_STEPPER_A,
1073 if (range->has_stepper_b)
1074 draw_stepper (range, &range->layout->stepper_b,
1075 range->orientation == GTK_ORIENTATION_VERTICAL ? GTK_ARROW_DOWN : GTK_ARROW_RIGHT,
1076 range->layout->grab_location == MOUSE_STEPPER_B,
1077 range->layout->mouse_location == MOUSE_STEPPER_B,
1080 if (range->has_stepper_c)
1081 draw_stepper (range, &range->layout->stepper_c,
1082 range->orientation == GTK_ORIENTATION_VERTICAL ? GTK_ARROW_UP : GTK_ARROW_LEFT,
1083 range->layout->grab_location == MOUSE_STEPPER_C,
1084 range->layout->mouse_location == MOUSE_STEPPER_C,
1087 if (range->has_stepper_d)
1088 draw_stepper (range, &range->layout->stepper_d,
1089 range->orientation == GTK_ORIENTATION_VERTICAL ? GTK_ARROW_DOWN : GTK_ARROW_RIGHT,
1090 range->layout->grab_location == MOUSE_STEPPER_D,
1091 range->layout->mouse_location == MOUSE_STEPPER_D,
1098 range_grab_add (GtkRange *range,
1099 MouseLocation location,
1102 /* we don't actually gtk_grab, since a button is down */
1104 gtk_grab_add (GTK_WIDGET (range));
1106 range->layout->grab_location = location;
1107 range->layout->grab_button = button;
1109 if (gtk_range_update_mouse_location (range))
1110 gtk_widget_queue_draw (GTK_WIDGET (range));
1114 range_grab_remove (GtkRange *range)
1116 gtk_grab_remove (GTK_WIDGET (range));
1118 range->layout->grab_location = MOUSE_OUTSIDE;
1119 range->layout->grab_button = 0;
1121 if (gtk_range_update_mouse_location (range))
1122 gtk_widget_queue_draw (GTK_WIDGET (range));
1125 static GtkScrollType
1126 range_get_scroll_for_grab (GtkRange *range)
1130 invert = should_invert (range);
1131 switch (range->layout->grab_location)
1133 /* Backward stepper */
1134 case MOUSE_STEPPER_A:
1135 case MOUSE_STEPPER_C:
1136 switch (range->layout->grab_button)
1139 return invert ? GTK_SCROLL_STEP_FORWARD : GTK_SCROLL_STEP_BACKWARD;
1142 return invert ? GTK_SCROLL_PAGE_FORWARD : GTK_SCROLL_PAGE_BACKWARD;
1145 return invert ? GTK_SCROLL_END : GTK_SCROLL_START;
1150 /* Forward stepper */
1151 case MOUSE_STEPPER_B:
1152 case MOUSE_STEPPER_D:
1153 switch (range->layout->grab_button)
1156 return invert ? GTK_SCROLL_STEP_BACKWARD : GTK_SCROLL_STEP_FORWARD;
1159 return invert ? GTK_SCROLL_PAGE_BACKWARD : GTK_SCROLL_PAGE_FORWARD;
1162 return invert ? GTK_SCROLL_START : GTK_SCROLL_END;
1170 if (range->trough_click_forward)
1171 return GTK_SCROLL_PAGE_FORWARD;
1173 return GTK_SCROLL_PAGE_BACKWARD;
1183 return GTK_SCROLL_NONE;
1187 coord_to_value (GtkRange *range,
1193 if (range->orientation == GTK_ORIENTATION_VERTICAL)
1194 if (range->layout->trough.height == range->layout->slider.height)
1197 frac = ((coord - range->layout->trough.y) /
1198 (gdouble) (range->layout->trough.height - range->layout->slider.height));
1200 if (range->layout->trough.width == range->layout->slider.width)
1203 frac = ((coord - range->layout->trough.x) /
1204 (gdouble) (range->layout->trough.width - range->layout->slider.width));
1206 if (should_invert (range))
1209 value = range->adjustment->lower +
1210 frac * (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size);
1216 gtk_range_button_press (GtkWidget *widget,
1217 GdkEventButton *event)
1219 GtkRange *range = GTK_RANGE (widget);
1221 if (!GTK_WIDGET_HAS_FOCUS (widget))
1222 gtk_widget_grab_focus (widget);
1224 /* ignore presses when we're already doing something else. */
1225 if (range->layout->grab_location != MOUSE_OUTSIDE)
1228 range->layout->mouse_x = event->x;
1229 range->layout->mouse_y = event->y;
1230 if (gtk_range_update_mouse_location (range))
1231 gtk_widget_queue_draw (widget);
1233 if (range->layout->mouse_location == MOUSE_TROUGH &&
1236 /* button 1 steps by page increment, as with button 2 on a stepper
1238 GtkScrollType scroll;
1239 gdouble click_value;
1241 click_value = coord_to_value (range,
1242 range->orientation == GTK_ORIENTATION_VERTICAL ?
1243 event->y : event->x);
1245 range->trough_click_forward = click_value > range->adjustment->value;
1246 range_grab_add (range, MOUSE_TROUGH, event->button);
1248 scroll = range_get_scroll_for_grab (range);
1250 gtk_range_add_step_timer (range, scroll);
1254 else if ((range->layout->mouse_location == MOUSE_STEPPER_A ||
1255 range->layout->mouse_location == MOUSE_STEPPER_B ||
1256 range->layout->mouse_location == MOUSE_STEPPER_C ||
1257 range->layout->mouse_location == MOUSE_STEPPER_D) &&
1258 (event->button == 1 || event->button == 2 || event->button == 3))
1260 GdkRectangle *stepper_area;
1261 GtkScrollType scroll;
1263 range_grab_add (range, range->layout->mouse_location, event->button);
1265 stepper_area = get_area (range, range->layout->mouse_location);
1266 gtk_widget_queue_draw_area (widget,
1267 widget->allocation.x + stepper_area->x,
1268 widget->allocation.y + stepper_area->y,
1269 stepper_area->width,
1270 stepper_area->height);
1272 scroll = range_get_scroll_for_grab (range);
1273 if (scroll != GTK_SCROLL_NONE)
1274 gtk_range_add_step_timer (range, scroll);
1278 else if ((range->layout->mouse_location == MOUSE_TROUGH &&
1279 event->button == 2) ||
1280 range->layout->mouse_location == MOUSE_SLIDER)
1282 gboolean need_value_update = FALSE;
1284 /* Any button can be used to drag the slider, but you can start
1285 * dragging the slider with a trough click using button 2;
1286 * On button 2 press, we warp the slider to mouse position,
1287 * then begin the slider drag.
1289 if (event->button == 2)
1291 gdouble slider_low_value, slider_high_value, new_value;
1294 coord_to_value (range,
1295 range->orientation == GTK_ORIENTATION_VERTICAL ?
1296 event->y : event->x);
1298 coord_to_value (range,
1299 range->orientation == GTK_ORIENTATION_VERTICAL ?
1300 event->y - range->layout->slider.height :
1301 event->x - range->layout->slider.width);
1303 /* compute new value for warped slider */
1304 new_value = slider_low_value + (slider_high_value - slider_low_value) / 2;
1306 /* recalc slider, so we can set slide_initial_slider_position
1309 range->need_recalc = TRUE;
1310 gtk_range_calc_layout (range, new_value);
1312 /* defer adjustment updates to update_slider_position() in order
1313 * to keep pixel quantisation
1315 need_value_update = TRUE;
1318 if (range->orientation == GTK_ORIENTATION_VERTICAL)
1320 range->slide_initial_slider_position = range->layout->slider.y;
1321 range->slide_initial_coordinate = event->y;
1325 range->slide_initial_slider_position = range->layout->slider.x;
1326 range->slide_initial_coordinate = event->x;
1329 if (need_value_update)
1330 update_slider_position (range, event->x, event->y);
1332 range_grab_add (range, MOUSE_SLIDER, event->button);
1340 /* During a slide, move the slider as required given new mouse position */
1342 update_slider_position (GtkRange *range,
1351 if (range->orientation == GTK_ORIENTATION_VERTICAL)
1352 delta = mouse_y - range->slide_initial_coordinate;
1354 delta = mouse_x - range->slide_initial_coordinate;
1356 c = range->slide_initial_slider_position + delta;
1358 new_value = coord_to_value (range, c);
1360 g_signal_emit (range, signals[CHANGE_VALUE], 0, GTK_SCROLL_JUMP, new_value,
1364 static void stop_scrolling (GtkRange *range)
1366 range_grab_remove (range);
1367 gtk_range_remove_step_timer (range);
1368 /* Flush any pending discontinuous/delayed updates */
1369 gtk_range_update_value (range);
1371 /* Just be lazy about this, if we scrolled it will all redraw anyway,
1372 * so no point optimizing the button deactivate case
1374 gtk_widget_queue_draw (GTK_WIDGET (range));
1378 gtk_range_button_release (GtkWidget *widget,
1379 GdkEventButton *event)
1381 GtkRange *range = GTK_RANGE (widget);
1383 if (event->window == range->event_window)
1385 range->layout->mouse_x = event->x;
1386 range->layout->mouse_y = event->y;
1390 gdk_window_get_pointer (range->event_window,
1391 &range->layout->mouse_x,
1392 &range->layout->mouse_y,
1396 if (range->layout->grab_button == event->button)
1398 if (range->layout->grab_location == MOUSE_SLIDER)
1399 update_slider_position (range, range->layout->mouse_x, range->layout->mouse_y);
1401 stop_scrolling (range);
1410 * _gtk_range_get_wheel_delta:
1411 * @range: a #GtkRange
1412 * @direction: A #GdkScrollDirection
1414 * Returns a good step value for the mouse wheel.
1416 * Return value: A good step value for the mouse wheel.
1421 _gtk_range_get_wheel_delta (GtkRange *range,
1422 GdkScrollDirection direction)
1424 GtkAdjustment *adj = range->adjustment;
1427 if (GTK_IS_SCROLLBAR (range))
1428 delta = pow (adj->page_size, 2.0 / 3.0);
1430 delta = adj->step_increment * 2;
1432 if (direction == GDK_SCROLL_UP ||
1433 direction == GDK_SCROLL_LEFT)
1436 if (range->inverted)
1443 gtk_range_scroll_event (GtkWidget *widget,
1444 GdkEventScroll *event)
1446 GtkRange *range = GTK_RANGE (widget);
1448 if (GTK_WIDGET_REALIZED (range))
1450 GtkAdjustment *adj = GTK_RANGE (range)->adjustment;
1454 delta = _gtk_range_get_wheel_delta (range, event->direction);
1456 g_signal_emit (range, signals[CHANGE_VALUE], 0,
1457 GTK_SCROLL_JUMP, adj->value + delta,
1460 /* Policy DELAYED makes sense with scroll events,
1461 * but DISCONTINUOUS doesn't, so we update immediately
1464 if (range->update_policy == GTK_UPDATE_DISCONTINUOUS)
1465 gtk_range_update_value (range);
1472 gtk_range_motion_notify (GtkWidget *widget,
1473 GdkEventMotion *event)
1478 range = GTK_RANGE (widget);
1480 gdk_window_get_pointer (range->event_window, &x, &y, NULL);
1482 range->layout->mouse_x = x;
1483 range->layout->mouse_y = y;
1485 if (gtk_range_update_mouse_location (range))
1486 gtk_widget_queue_draw (widget);
1488 if (range->layout->grab_location == MOUSE_SLIDER)
1489 update_slider_position (range, x, y);
1491 /* We handled the event if the mouse was in the range_rect */
1492 return range->layout->mouse_location != MOUSE_OUTSIDE;
1496 gtk_range_enter_notify (GtkWidget *widget,
1497 GdkEventCrossing *event)
1499 GtkRange *range = GTK_RANGE (widget);
1501 range->layout->mouse_x = event->x;
1502 range->layout->mouse_y = event->y;
1504 if (gtk_range_update_mouse_location (range))
1505 gtk_widget_queue_draw (widget);
1511 gtk_range_leave_notify (GtkWidget *widget,
1512 GdkEventCrossing *event)
1514 GtkRange *range = GTK_RANGE (widget);
1516 range->layout->mouse_x = -1;
1517 range->layout->mouse_y = -1;
1519 if (gtk_range_update_mouse_location (range))
1520 gtk_widget_queue_draw (widget);
1526 gtk_range_grab_notify (GtkWidget *widget,
1527 gboolean was_grabbed)
1530 stop_scrolling (GTK_RANGE (widget));
1534 gtk_range_state_changed (GtkWidget *widget,
1535 GtkStateType previous_state)
1537 if (!GTK_WIDGET_IS_SENSITIVE (widget))
1538 stop_scrolling (GTK_RANGE (widget));
1542 gtk_range_adjustment_changed (GtkAdjustment *adjustment,
1545 GtkRange *range = GTK_RANGE (data);
1547 range->need_recalc = TRUE;
1548 gtk_widget_queue_draw (GTK_WIDGET (range));
1550 /* Note that we don't round off to range->round_digits here.
1551 * that's because it's really broken to change a value
1552 * in response to a change signal on that value; round_digits
1553 * is therefore defined to be a filter on what the GtkRange
1554 * can input into the adjustment, not a filter that the GtkRange
1555 * will enforce on the adjustment.
1560 gtk_range_adjustment_value_changed (GtkAdjustment *adjustment,
1563 GtkRange *range = GTK_RANGE (data);
1565 range->need_recalc = TRUE;
1567 gtk_widget_queue_draw (GTK_WIDGET (range));
1568 /* This is so we don't lag the widget being scrolled. */
1569 if (GTK_WIDGET_REALIZED (range))
1570 gdk_window_process_updates (GTK_WIDGET (range)->window, FALSE);
1572 /* Note that we don't round off to range->round_digits here.
1573 * that's because it's really broken to change a value
1574 * in response to a change signal on that value; round_digits
1575 * is therefore defined to be a filter on what the GtkRange
1576 * can input into the adjustment, not a filter that the GtkRange
1577 * will enforce on the adjustment.
1580 g_signal_emit (range, signals[VALUE_CHANGED], 0);
1584 gtk_range_style_set (GtkWidget *widget,
1585 GtkStyle *previous_style)
1587 GtkRange *range = GTK_RANGE (widget);
1589 range->need_recalc = TRUE;
1591 (* GTK_WIDGET_CLASS (parent_class)->style_set) (widget, previous_style);
1595 step_back (GtkRange *range)
1600 newval = range->adjustment->value - range->adjustment->step_increment;
1601 g_signal_emit (range, signals[CHANGE_VALUE], 0,
1602 GTK_SCROLL_STEP_BACKWARD, newval, &handled);
1606 step_forward (GtkRange *range)
1611 newval = range->adjustment->value + range->adjustment->step_increment;
1612 g_signal_emit (range, signals[CHANGE_VALUE], 0,
1613 GTK_SCROLL_STEP_FORWARD, newval, &handled);
1618 page_back (GtkRange *range)
1623 newval = range->adjustment->value - range->adjustment->page_increment;
1624 g_signal_emit (range, signals[CHANGE_VALUE], 0,
1625 GTK_SCROLL_PAGE_BACKWARD, newval, &handled);
1629 page_forward (GtkRange *range)
1634 newval = range->adjustment->value + range->adjustment->page_increment;
1635 g_signal_emit (range, signals[CHANGE_VALUE], 0,
1636 GTK_SCROLL_PAGE_FORWARD, newval, &handled);
1640 scroll_begin (GtkRange *range)
1643 g_signal_emit (range, signals[CHANGE_VALUE], 0,
1644 GTK_SCROLL_START, range->adjustment->lower,
1649 scroll_end (GtkRange *range)
1654 newval = range->adjustment->upper - range->adjustment->page_size;
1655 g_signal_emit (range, signals[CHANGE_VALUE], 0, GTK_SCROLL_END, newval,
1660 gtk_range_scroll (GtkRange *range,
1661 GtkScrollType scroll)
1665 case GTK_SCROLL_STEP_LEFT:
1666 if (should_invert (range))
1667 step_forward (range);
1672 case GTK_SCROLL_STEP_UP:
1673 if (should_invert (range))
1674 step_forward (range);
1679 case GTK_SCROLL_STEP_RIGHT:
1680 if (should_invert (range))
1683 step_forward (range);
1686 case GTK_SCROLL_STEP_DOWN:
1687 if (should_invert (range))
1690 step_forward (range);
1693 case GTK_SCROLL_STEP_BACKWARD:
1697 case GTK_SCROLL_STEP_FORWARD:
1698 step_forward (range);
1701 case GTK_SCROLL_PAGE_LEFT:
1702 if (should_invert (range))
1703 page_forward (range);
1708 case GTK_SCROLL_PAGE_UP:
1709 if (should_invert (range))
1710 page_forward (range);
1715 case GTK_SCROLL_PAGE_RIGHT:
1716 if (should_invert (range))
1719 page_forward (range);
1722 case GTK_SCROLL_PAGE_DOWN:
1723 if (should_invert (range))
1726 page_forward (range);
1729 case GTK_SCROLL_PAGE_BACKWARD:
1733 case GTK_SCROLL_PAGE_FORWARD:
1734 page_forward (range);
1737 case GTK_SCROLL_START:
1738 scroll_begin (range);
1741 case GTK_SCROLL_END:
1745 case GTK_SCROLL_JUMP:
1746 /* Used by CList, range doesn't use it. */
1749 case GTK_SCROLL_NONE:
1755 gtk_range_move_slider (GtkRange *range,
1756 GtkScrollType scroll)
1758 gtk_range_scroll (range, scroll);
1760 /* Policy DELAYED makes sense with key events,
1761 * but DISCONTINUOUS doesn't, so we update immediately
1764 if (range->update_policy == GTK_UPDATE_DISCONTINUOUS)
1765 gtk_range_update_value (range);
1769 gtk_range_get_props (GtkRange *range,
1772 gint *trough_border,
1773 gint *stepper_spacing,
1774 gint *arrow_displacement_x,
1775 gint *arrow_displacement_y)
1777 GtkWidget *widget = GTK_WIDGET (range);
1778 gint tmp_slider_width, tmp_stepper_size, tmp_trough_border, tmp_stepper_spacing;
1779 gint tmp_arrow_displacement_x, tmp_arrow_displacement_y;
1781 gtk_widget_style_get (widget,
1782 "slider_width", &tmp_slider_width,
1783 "trough_border", &tmp_trough_border,
1784 "stepper_size", &tmp_stepper_size,
1785 "stepper_spacing", &tmp_stepper_spacing,
1786 "arrow_displacement_x", &tmp_arrow_displacement_x,
1787 "arrow_displacement_y", &tmp_arrow_displacement_y,
1790 if (GTK_WIDGET_CAN_FOCUS (range))
1792 gint focus_line_width;
1795 gtk_widget_style_get (GTK_WIDGET (range),
1796 "focus-line-width", &focus_line_width,
1797 "focus-padding", &focus_padding,
1800 tmp_trough_border += focus_line_width + focus_padding;
1804 *slider_width = tmp_slider_width;
1807 *trough_border = tmp_trough_border;
1810 *stepper_size = tmp_stepper_size;
1812 if (stepper_spacing)
1813 *stepper_spacing = tmp_stepper_spacing;
1815 if (arrow_displacement_x)
1816 *arrow_displacement_x = tmp_arrow_displacement_x;
1818 if (arrow_displacement_y)
1819 *arrow_displacement_y = tmp_arrow_displacement_y;
1822 #define POINT_IN_RECT(xcoord, ycoord, rect) \
1823 ((xcoord) >= (rect).x && \
1824 (xcoord) < ((rect).x + (rect).width) && \
1825 (ycoord) >= (rect).y && \
1826 (ycoord) < ((rect).y + (rect).height))
1828 /* Update mouse location, return TRUE if it changes */
1830 gtk_range_update_mouse_location (GtkRange *range)
1836 widget = GTK_WIDGET (range);
1838 old = range->layout->mouse_location;
1840 x = range->layout->mouse_x;
1841 y = range->layout->mouse_y;
1843 if (range->layout->grab_location != MOUSE_OUTSIDE)
1844 range->layout->mouse_location = range->layout->grab_location;
1845 else if (POINT_IN_RECT (x, y, range->layout->stepper_a))
1846 range->layout->mouse_location = MOUSE_STEPPER_A;
1847 else if (POINT_IN_RECT (x, y, range->layout->stepper_b))
1848 range->layout->mouse_location = MOUSE_STEPPER_B;
1849 else if (POINT_IN_RECT (x, y, range->layout->stepper_c))
1850 range->layout->mouse_location = MOUSE_STEPPER_C;
1851 else if (POINT_IN_RECT (x, y, range->layout->stepper_d))
1852 range->layout->mouse_location = MOUSE_STEPPER_D;
1853 else if (POINT_IN_RECT (x, y, range->layout->slider))
1854 range->layout->mouse_location = MOUSE_SLIDER;
1855 else if (POINT_IN_RECT (x, y, range->layout->trough))
1856 range->layout->mouse_location = MOUSE_TROUGH;
1857 else if (POINT_IN_RECT (x, y, widget->allocation))
1858 range->layout->mouse_location = MOUSE_WIDGET;
1860 range->layout->mouse_location = MOUSE_OUTSIDE;
1862 return old != range->layout->mouse_location;
1865 /* Clamp rect, border inside widget->allocation, such that we prefer
1866 * to take space from border not rect in all directions, and prefer to
1867 * give space to border over rect in one direction.
1870 clamp_dimensions (GtkWidget *widget,
1873 gboolean border_expands_horizontally)
1875 gint extra, shortage;
1877 g_return_if_fail (rect->x == 0);
1878 g_return_if_fail (rect->y == 0);
1879 g_return_if_fail (rect->width >= 0);
1880 g_return_if_fail (rect->height >= 0);
1884 extra = widget->allocation.width - border->left - border->right - rect->width;
1887 if (border_expands_horizontally)
1889 border->left += extra / 2;
1890 border->right += extra / 2 + extra % 2;
1894 rect->width += extra;
1898 /* See if we can fit rect, if not kill the border */
1899 shortage = rect->width - widget->allocation.width;
1902 rect->width = widget->allocation.width;
1903 /* lose the border */
1909 /* See if we can fit rect with borders */
1910 shortage = rect->width + border->left + border->right -
1911 widget->allocation.width;
1914 /* Shrink borders */
1915 border->left -= shortage / 2;
1916 border->right -= shortage / 2 + shortage % 2;
1922 extra = widget->allocation.height - border->top - border->bottom - rect->height;
1925 if (border_expands_horizontally)
1927 /* don't expand border vertically */
1928 rect->height += extra;
1932 border->top += extra / 2;
1933 border->bottom += extra / 2 + extra % 2;
1937 /* See if we can fit rect, if not kill the border */
1938 shortage = rect->height - widget->allocation.height;
1941 rect->height = widget->allocation.height;
1942 /* lose the border */
1948 /* See if we can fit rect with borders */
1949 shortage = rect->height + border->top + border->bottom -
1950 widget->allocation.height;
1953 /* Shrink borders */
1954 border->top -= shortage / 2;
1955 border->bottom -= shortage / 2 + shortage % 2;
1961 gtk_range_calc_request (GtkRange *range,
1965 gint stepper_spacing,
1966 GdkRectangle *range_rect,
1969 gint *slider_length_p)
1979 if (GTK_RANGE_GET_CLASS (range)->get_range_border)
1980 (* GTK_RANGE_GET_CLASS (range)->get_range_border) (range, border);
1983 if (range->has_stepper_a)
1985 if (range->has_stepper_b)
1987 if (range->has_stepper_c)
1989 if (range->has_stepper_d)
1992 slider_length = range->min_slider_size;
1997 /* We never expand to fill available space in the small dimension
1998 * (i.e. vertical scrollbars are always a fixed width)
2000 if (range->orientation == GTK_ORIENTATION_VERTICAL)
2002 range_rect->width = trough_border * 2 + slider_width;
2003 range_rect->height = stepper_size * n_steppers + stepper_spacing * 2 + trough_border * 2 + slider_length;
2007 range_rect->width = stepper_size * n_steppers + stepper_spacing * 2 + trough_border * 2 + slider_length;
2008 range_rect->height = trough_border * 2 + slider_width;
2012 *n_steppers_p = n_steppers;
2014 if (slider_length_p)
2015 *slider_length_p = slider_length;
2019 gtk_range_calc_layout (GtkRange *range,
2020 gdouble adjustment_value)
2022 gint slider_width, stepper_size, trough_border, stepper_spacing;
2026 GdkRectangle range_rect;
2027 GtkRangeLayout *layout;
2030 if (!range->need_recalc)
2033 /* If we have a too-small allocation, we prefer the steppers over
2034 * the trough/slider, probably the steppers are a more useful
2035 * feature in small spaces.
2037 * Also, we prefer to draw the range itself rather than the border
2038 * areas if there's a conflict, since the borders will be decoration
2039 * not controls. Though this depends on subclasses cooperating by
2040 * not drawing on range->range_rect.
2043 widget = GTK_WIDGET (range);
2044 layout = range->layout;
2046 gtk_range_get_props (range,
2047 &slider_width, &stepper_size, &trough_border, &stepper_spacing,
2050 gtk_range_calc_request (range,
2051 slider_width, stepper_size, trough_border, stepper_spacing,
2052 &range_rect, &border, &n_steppers, &slider_length);
2054 /* We never expand to fill available space in the small dimension
2055 * (i.e. vertical scrollbars are always a fixed width)
2057 if (range->orientation == GTK_ORIENTATION_VERTICAL)
2059 clamp_dimensions (widget, &range_rect, &border, TRUE);
2063 clamp_dimensions (widget, &range_rect, &border, FALSE);
2066 range_rect.x = border.left;
2067 range_rect.y = border.top;
2069 range->range_rect = range_rect;
2071 if (range->orientation == GTK_ORIENTATION_VERTICAL)
2073 gint stepper_width, stepper_height;
2075 /* Steppers are the width of the range, and stepper_size in
2076 * height, or if we don't have enough height, divided equally
2077 * among available space.
2079 stepper_width = range_rect.width - trough_border * 2;
2081 if (stepper_width < 1)
2082 stepper_width = range_rect.width; /* screw the trough border */
2084 if (n_steppers == 0)
2085 stepper_height = 0; /* avoid divide by n_steppers */
2087 stepper_height = MIN (stepper_size, (range_rect.height / n_steppers));
2091 layout->stepper_a.x = range_rect.x + trough_border;
2092 layout->stepper_a.y = range_rect.y + trough_border;
2094 if (range->has_stepper_a)
2096 layout->stepper_a.width = stepper_width;
2097 layout->stepper_a.height = stepper_height;
2101 layout->stepper_a.width = 0;
2102 layout->stepper_a.height = 0;
2107 layout->stepper_b.x = layout->stepper_a.x;
2108 layout->stepper_b.y = layout->stepper_a.y + layout->stepper_a.height;
2110 if (range->has_stepper_b)
2112 layout->stepper_b.width = stepper_width;
2113 layout->stepper_b.height = stepper_height;
2117 layout->stepper_b.width = 0;
2118 layout->stepper_b.height = 0;
2123 if (range->has_stepper_d)
2125 layout->stepper_d.width = stepper_width;
2126 layout->stepper_d.height = stepper_height;
2130 layout->stepper_d.width = 0;
2131 layout->stepper_d.height = 0;
2134 layout->stepper_d.x = layout->stepper_a.x;
2135 layout->stepper_d.y = range_rect.y + range_rect.height - layout->stepper_d.height - trough_border;
2139 if (range->has_stepper_c)
2141 layout->stepper_c.width = stepper_width;
2142 layout->stepper_c.height = stepper_height;
2146 layout->stepper_c.width = 0;
2147 layout->stepper_c.height = 0;
2150 layout->stepper_c.x = layout->stepper_a.x;
2151 layout->stepper_c.y = layout->stepper_d.y - layout->stepper_c.height;
2153 /* Now the trough is the remaining space between steppers B and C,
2156 layout->trough.x = range_rect.x;
2157 layout->trough.y = layout->stepper_b.y + layout->stepper_b.height;
2158 layout->trough.width = range_rect.width;
2159 layout->trough.height = layout->stepper_c.y - (layout->stepper_b.y + layout->stepper_b.height);
2161 /* Slider fits into the trough, with stepper_spacing on either side,
2162 * and the size/position based on the adjustment or fixed, depending.
2164 layout->slider.x = layout->trough.x + trough_border;
2165 layout->slider.width = layout->trough.width - trough_border * 2;
2167 /* Compute slider position/length */
2169 gint y, bottom, top, height;
2171 top = layout->trough.y + stepper_spacing;
2172 bottom = layout->trough.y + layout->trough.height - stepper_spacing;
2174 /* slider height is the fraction (page_size /
2175 * total_adjustment_range) times the trough height in pixels
2178 if (range->adjustment->upper - range->adjustment->lower != 0)
2179 height = ((bottom - top) * (range->adjustment->page_size /
2180 (range->adjustment->upper - range->adjustment->lower)));
2182 height = range->min_slider_size;
2184 if (height < range->min_slider_size ||
2185 range->slider_size_fixed)
2186 height = range->min_slider_size;
2188 height = MIN (height, (layout->trough.height - stepper_spacing * 2));
2192 if (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size != 0)
2193 y += (bottom - top - height) * ((adjustment_value - range->adjustment->lower) /
2194 (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size));
2196 y = CLAMP (y, top, bottom);
2198 if (should_invert (range))
2199 y = bottom - (y - top + height);
2201 layout->slider.y = y;
2202 layout->slider.height = height;
2204 /* These are publically exported */
2205 range->slider_start = layout->slider.y;
2206 range->slider_end = layout->slider.y + layout->slider.height;
2211 gint stepper_width, stepper_height;
2213 /* Steppers are the height of the range, and stepper_size in
2214 * width, or if we don't have enough width, divided equally
2215 * among available space.
2217 stepper_height = range_rect.height - trough_border * 2;
2219 if (stepper_height < 1)
2220 stepper_height = range_rect.height; /* screw the trough border */
2222 if (n_steppers == 0)
2223 stepper_width = 0; /* avoid divide by n_steppers */
2225 stepper_width = MIN (stepper_size, (range_rect.width / n_steppers));
2229 layout->stepper_a.x = range_rect.x + trough_border;
2230 layout->stepper_a.y = range_rect.y + trough_border;
2232 if (range->has_stepper_a)
2234 layout->stepper_a.width = stepper_width;
2235 layout->stepper_a.height = stepper_height;
2239 layout->stepper_a.width = 0;
2240 layout->stepper_a.height = 0;
2245 layout->stepper_b.x = layout->stepper_a.x + layout->stepper_a.width;
2246 layout->stepper_b.y = layout->stepper_a.y;
2248 if (range->has_stepper_b)
2250 layout->stepper_b.width = stepper_width;
2251 layout->stepper_b.height = stepper_height;
2255 layout->stepper_b.width = 0;
2256 layout->stepper_b.height = 0;
2261 if (range->has_stepper_d)
2263 layout->stepper_d.width = stepper_width;
2264 layout->stepper_d.height = stepper_height;
2268 layout->stepper_d.width = 0;
2269 layout->stepper_d.height = 0;
2272 layout->stepper_d.x = range_rect.x + range_rect.width - layout->stepper_d.width - trough_border;
2273 layout->stepper_d.y = layout->stepper_a.y;
2278 if (range->has_stepper_c)
2280 layout->stepper_c.width = stepper_width;
2281 layout->stepper_c.height = stepper_height;
2285 layout->stepper_c.width = 0;
2286 layout->stepper_c.height = 0;
2289 layout->stepper_c.x = layout->stepper_d.x - layout->stepper_c.width;
2290 layout->stepper_c.y = layout->stepper_a.y;
2292 /* Now the trough is the remaining space between steppers B and C,
2295 layout->trough.x = layout->stepper_b.x + layout->stepper_b.width;
2296 layout->trough.y = range_rect.y;
2298 layout->trough.width = layout->stepper_c.x - (layout->stepper_b.x + layout->stepper_b.width);
2299 layout->trough.height = range_rect.height;
2301 /* Slider fits into the trough, with stepper_spacing on either side,
2302 * and the size/position based on the adjustment or fixed, depending.
2304 layout->slider.y = layout->trough.y + trough_border;
2305 layout->slider.height = layout->trough.height - trough_border * 2;
2307 /* Compute slider position/length */
2309 gint x, left, right, width;
2311 left = layout->trough.x + stepper_spacing;
2312 right = layout->trough.x + layout->trough.width - stepper_spacing;
2314 /* slider width is the fraction (page_size /
2315 * total_adjustment_range) times the trough width in pixels
2318 if (range->adjustment->upper - range->adjustment->lower != 0)
2319 width = ((right - left) * (range->adjustment->page_size /
2320 (range->adjustment->upper - range->adjustment->lower)));
2322 width = range->min_slider_size;
2324 if (width < range->min_slider_size ||
2325 range->slider_size_fixed)
2326 width = range->min_slider_size;
2328 width = MIN (width, (layout->trough.width - stepper_spacing * 2));
2332 if (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size != 0)
2333 x += (right - left - width) * ((adjustment_value - range->adjustment->lower) /
2334 (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size));
2336 x = CLAMP (x, left, right);
2338 if (should_invert (range))
2339 x = right - (x - left + width);
2341 layout->slider.x = x;
2342 layout->slider.width = width;
2344 /* These are publically exported */
2345 range->slider_start = layout->slider.x;
2346 range->slider_end = layout->slider.x + layout->slider.width;
2350 gtk_range_update_mouse_location (range);
2353 static GdkRectangle*
2354 get_area (GtkRange *range,
2355 MouseLocation location)
2359 case MOUSE_STEPPER_A:
2360 return &range->layout->stepper_a;
2361 case MOUSE_STEPPER_B:
2362 return &range->layout->stepper_b;
2363 case MOUSE_STEPPER_C:
2364 return &range->layout->stepper_c;
2365 case MOUSE_STEPPER_D:
2366 return &range->layout->stepper_d;
2368 return &range->layout->trough;
2370 return &range->layout->slider;
2376 g_warning (G_STRLOC": bug");
2381 gtk_range_real_change_value (GtkRange *range,
2382 GtkScrollType scroll,
2385 /* potentially adjust the bounds _before we clamp */
2386 g_signal_emit (range, signals[ADJUST_BOUNDS], 0, value);
2388 value = CLAMP (value, range->adjustment->lower,
2389 (range->adjustment->upper - range->adjustment->page_size));
2391 if (range->round_digits >= 0)
2395 /* This is just so darn lame. */
2396 g_snprintf (buffer, 128, "%0.*f",
2397 range->round_digits, value);
2398 sscanf (buffer, "%lf", &value);
2401 if (range->adjustment->value != value)
2403 range->need_recalc = TRUE;
2405 gtk_widget_queue_draw (GTK_WIDGET (range));
2407 switch (range->update_policy)
2409 case GTK_UPDATE_CONTINUOUS:
2410 gtk_adjustment_set_value (range->adjustment, value);
2413 /* Delayed means we update after a period of inactivity */
2414 case GTK_UPDATE_DELAYED:
2415 gtk_range_reset_update_timer (range);
2418 /* Discontinuous means we update on button release */
2419 case GTK_UPDATE_DISCONTINUOUS:
2420 /* don't emit value_changed signal */
2421 range->adjustment->value = value;
2422 range->update_pending = TRUE;
2430 gtk_range_update_value (GtkRange *range)
2432 gtk_range_remove_update_timer (range);
2434 if (range->update_pending)
2436 gtk_adjustment_value_changed (range->adjustment);
2438 range->update_pending = FALSE;
2442 struct _GtkRangeStepTimer
2449 second_timeout (gpointer data)
2453 GDK_THREADS_ENTER ();
2454 range = GTK_RANGE (data);
2455 gtk_range_scroll (range, range->timer->step);
2456 GDK_THREADS_LEAVE ();
2462 initial_timeout (gpointer data)
2466 GDK_THREADS_ENTER ();
2467 range = GTK_RANGE (data);
2468 range->timer->timeout_id =
2469 g_timeout_add (SCROLL_LATER_DELAY,
2472 GDK_THREADS_LEAVE ();
2479 gtk_range_add_step_timer (GtkRange *range,
2482 g_return_if_fail (range->timer == NULL);
2483 g_return_if_fail (step != GTK_SCROLL_NONE);
2485 range->timer = g_new (GtkRangeStepTimer, 1);
2487 range->timer->timeout_id =
2488 g_timeout_add (SCROLL_INITIAL_DELAY,
2491 range->timer->step = step;
2493 gtk_range_scroll (range, range->timer->step);
2497 gtk_range_remove_step_timer (GtkRange *range)
2501 if (range->timer->timeout_id != 0)
2502 g_source_remove (range->timer->timeout_id);
2504 g_free (range->timer);
2506 range->timer = NULL;
2511 update_timeout (gpointer data)
2515 GDK_THREADS_ENTER ();
2516 range = GTK_RANGE (data);
2517 gtk_range_update_value (range);
2518 range->update_timeout_id = 0;
2519 GDK_THREADS_LEAVE ();
2526 gtk_range_reset_update_timer (GtkRange *range)
2528 gtk_range_remove_update_timer (range);
2530 range->update_timeout_id = g_timeout_add (UPDATE_DELAY,
2536 gtk_range_remove_update_timer (GtkRange *range)
2538 if (range->update_timeout_id != 0)
2540 g_source_remove (range->update_timeout_id);
2541 range->update_timeout_id = 0;