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-2000. 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/.
31 #include "gtkmarshalers.h"
33 #include "gtksignal.h"
36 #define SCROLL_INITIAL_DELAY 250 /* must hold button this long before ... */
37 #define SCROLL_LATER_DELAY 100 /* ... it starts repeating at this rate */
38 #define UPDATE_DELAY 300 /* Delay for queued update */
61 MOUSE_WIDGET /* inside widget but not in any of the above GUI elements */
64 struct _GtkRangeLayout
66 /* These are in widget->window coordinates */
67 GdkRectangle stepper_a;
68 GdkRectangle stepper_b;
69 GdkRectangle stepper_c;
70 GdkRectangle stepper_d;
71 /* The trough rectangle is the area the thumb can slide in, not the
77 /* Layout-related state */
79 MouseLocation mouse_location;
80 /* last mouse coords we got, or -1 if mouse is outside the range */
83 /* "grabbed" mouse location, OUTSIDE for no grab */
84 MouseLocation grab_location;
85 gint grab_button; /* 0 if none */
89 static void gtk_range_class_init (GtkRangeClass *klass);
90 static void gtk_range_init (GtkRange *range);
91 static void gtk_range_set_property (GObject *object,
95 static void gtk_range_get_property (GObject *object,
99 static void gtk_range_destroy (GtkObject *object);
100 static void gtk_range_finalize (GObject *object);
101 static void gtk_range_size_request (GtkWidget *widget,
102 GtkRequisition *requisition);
103 static void gtk_range_size_allocate (GtkWidget *widget,
104 GtkAllocation *allocation);
105 static void gtk_range_realize (GtkWidget *widget);
106 static void gtk_range_unrealize (GtkWidget *widget);
107 static void gtk_range_map (GtkWidget *widget);
108 static void gtk_range_unmap (GtkWidget *widget);
109 static gint gtk_range_expose (GtkWidget *widget,
110 GdkEventExpose *event);
111 static gint gtk_range_button_press (GtkWidget *widget,
112 GdkEventButton *event);
113 static gint gtk_range_button_release (GtkWidget *widget,
114 GdkEventButton *event);
115 static gint gtk_range_motion_notify (GtkWidget *widget,
116 GdkEventMotion *event);
117 static gint gtk_range_enter_notify (GtkWidget *widget,
118 GdkEventCrossing *event);
119 static gint gtk_range_leave_notify (GtkWidget *widget,
120 GdkEventCrossing *event);
121 static gint gtk_range_scroll_event (GtkWidget *widget,
122 GdkEventScroll *event);
123 static void gtk_range_style_set (GtkWidget *widget,
124 GtkStyle *previous_style);
125 static void update_slider_position (GtkRange *range,
132 static void gtk_range_move_slider (GtkRange *range,
133 GtkScrollType scroll);
136 static void gtk_range_scroll (GtkRange *range,
137 GtkScrollType scroll);
138 static gboolean gtk_range_update_mouse_location (GtkRange *range);
139 static void gtk_range_calc_layout (GtkRange *range,
140 gdouble adjustment_value);
141 static void gtk_range_get_props (GtkRange *range,
145 gint *stepper_spacing);
146 static void gtk_range_calc_request (GtkRange *range,
150 gint stepper_spacing,
151 GdkRectangle *range_rect,
154 gint *slider_length_p);
155 static void gtk_range_adjustment_value_changed (GtkAdjustment *adjustment,
157 static void gtk_range_adjustment_changed (GtkAdjustment *adjustment,
159 static void gtk_range_add_step_timer (GtkRange *range,
161 static void gtk_range_remove_step_timer (GtkRange *range);
162 static void gtk_range_reset_update_timer (GtkRange *range);
163 static void gtk_range_remove_update_timer (GtkRange *range);
164 static GdkRectangle* get_area (GtkRange *range,
165 MouseLocation location);
166 static void gtk_range_internal_set_value (GtkRange *range,
168 static void gtk_range_update_value (GtkRange *range);
171 static GtkWidgetClass *parent_class = NULL;
172 static guint signals[LAST_SIGNAL];
176 gtk_range_get_type (void)
178 static GtkType range_type = 0;
182 static const GtkTypeInfo range_info =
186 sizeof (GtkRangeClass),
187 (GtkClassInitFunc) gtk_range_class_init,
188 (GtkObjectInitFunc) gtk_range_init,
189 /* reserved_1 */ NULL,
190 /* reserved_2 */ NULL,
191 (GtkClassInitFunc) NULL,
194 range_type = gtk_type_unique (GTK_TYPE_WIDGET, &range_info);
201 gtk_range_class_init (GtkRangeClass *class)
203 GObjectClass *gobject_class;
204 GtkObjectClass *object_class;
205 GtkWidgetClass *widget_class;
207 gobject_class = G_OBJECT_CLASS (class);
208 object_class = (GtkObjectClass*) class;
209 widget_class = (GtkWidgetClass*) class;
211 parent_class = g_type_class_peek_parent (class);
213 gobject_class->set_property = gtk_range_set_property;
214 gobject_class->get_property = gtk_range_get_property;
215 gobject_class->finalize = gtk_range_finalize;
216 object_class->destroy = gtk_range_destroy;
218 widget_class->size_request = gtk_range_size_request;
219 widget_class->size_allocate = gtk_range_size_allocate;
220 widget_class->realize = gtk_range_realize;
221 widget_class->unrealize = gtk_range_unrealize;
222 widget_class->map = gtk_range_map;
223 widget_class->unmap = gtk_range_unmap;
224 widget_class->expose_event = gtk_range_expose;
225 widget_class->button_press_event = gtk_range_button_press;
226 widget_class->button_release_event = gtk_range_button_release;
227 widget_class->motion_notify_event = gtk_range_motion_notify;
228 widget_class->scroll_event = gtk_range_scroll_event;
229 widget_class->enter_notify_event = gtk_range_enter_notify;
230 widget_class->leave_notify_event = gtk_range_leave_notify;
231 widget_class->style_set = gtk_range_style_set;
233 class->move_slider = gtk_range_move_slider;
235 class->slider_detail = "slider";
236 class->stepper_detail = "stepper";
238 signals[VALUE_CHANGED] =
239 g_signal_new ("value_changed",
240 G_TYPE_FROM_CLASS (object_class),
242 G_STRUCT_OFFSET (GtkRangeClass, value_changed),
244 _gtk_marshal_NONE__NONE,
247 signals[MOVE_SLIDER] =
248 g_signal_new ("move_slider",
249 G_TYPE_FROM_CLASS (object_class),
250 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
251 G_STRUCT_OFFSET (GtkRangeClass, move_slider),
253 _gtk_marshal_VOID__ENUM,
255 GTK_TYPE_SCROLL_TYPE);
258 g_object_class_install_property (gobject_class,
260 g_param_spec_enum ("update_policy",
262 _("How the range should be updated on the screen"),
263 GTK_TYPE_UPDATE_TYPE,
264 GTK_UPDATE_CONTINUOUS,
267 g_object_class_install_property (gobject_class,
269 g_param_spec_object ("adjustment",
271 _("The GtkAdjustment that contains the current value of this range object"),
273 G_PARAM_READWRITE | G_PARAM_CONSTRUCT));
275 g_object_class_install_property (gobject_class,
277 g_param_spec_boolean ("inverted",
279 _("Invert direction slider moves to increase range value"),
283 gtk_widget_class_install_style_property (widget_class,
284 g_param_spec_int ("slider_width",
286 _("Width of scrollbar or scale thumb"),
291 gtk_widget_class_install_style_property (widget_class,
292 g_param_spec_int ("trough_border",
294 _("Spacing between thumb/steppers and outer trough bevel"),
299 gtk_widget_class_install_style_property (widget_class,
300 g_param_spec_int ("stepper_size",
302 _("Length of step buttons at ends"),
307 gtk_widget_class_install_style_property (widget_class,
308 g_param_spec_int ("stepper_spacing",
309 _("Stepper Spacing"),
310 _("Spacing between step buttons and thumb"),
318 gtk_range_set_property (GObject *object,
325 range = GTK_RANGE (object);
329 case PROP_UPDATE_POLICY:
330 gtk_range_set_update_policy (range, g_value_get_enum (value));
332 case PROP_ADJUSTMENT:
333 gtk_range_set_adjustment (range, g_value_get_object (value));
336 gtk_range_set_inverted (range, g_value_get_boolean (value));
339 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
345 gtk_range_get_property (GObject *object,
352 range = GTK_RANGE (object);
356 case PROP_UPDATE_POLICY:
357 g_value_set_enum (value, range->update_policy);
359 case PROP_ADJUSTMENT:
360 g_value_set_object (value, range->adjustment);
363 g_value_set_boolean (value, range->inverted);
366 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
372 gtk_range_init (GtkRange *range)
374 GTK_WIDGET_SET_FLAGS (range, GTK_NO_WINDOW);
376 range->adjustment = NULL;
377 range->update_policy = GTK_UPDATE_CONTINUOUS;
378 range->inverted = FALSE;
379 range->flippable = FALSE;
380 range->min_slider_size = 1;
381 range->has_stepper_a = FALSE;
382 range->has_stepper_b = FALSE;
383 range->has_stepper_c = FALSE;
384 range->has_stepper_d = FALSE;
385 range->need_recalc = TRUE;
386 range->round_digits = -1;
387 range->layout = g_new0 (GtkRangeLayout, 1);
388 range->layout->grab_location = MOUSE_OUTSIDE;
389 range->layout->grab_button = 0;
394 * gtk_range_get_adjustment:
395 * @range: a #GtkRange
397 * Get the #GtkAdjustment which is the "model" object for #GtkRange.
398 * See gtk_range_set_adjustment() for details.
399 * The return value does not have a reference added, so should not
402 * Return value: a #GtkAdjustment
405 gtk_range_get_adjustment (GtkRange *range)
407 g_return_val_if_fail (GTK_IS_RANGE (range), NULL);
409 if (!range->adjustment)
410 gtk_range_set_adjustment (range, NULL);
412 return range->adjustment;
416 * gtk_range_set_update_policy:
417 * @range: a #GtkRange
418 * @policy: update policy
420 * Sets the update policy for the range. #GTK_UPDATE_CONTINUOUS means that
421 * anytime the range slider is moved, the range value will change and the
422 * value_changed signal will be emitted. #GTK_UPDATE_DELAYED means that
423 * the value will be updated after a brief timeout where no slider motion
424 * occurs, so updates are spaced by a short time rather than
425 * continuous. #GTK_UPDATE_DISCONTINUOUS means that the value will only
426 * be updated when the user releases the button and ends the slider
431 gtk_range_set_update_policy (GtkRange *range,
432 GtkUpdateType policy)
434 g_return_if_fail (GTK_IS_RANGE (range));
436 if (range->update_policy != policy)
438 range->update_policy = policy;
439 g_object_notify (G_OBJECT (range), "update_policy");
444 * gtk_range_get_update_policy:
445 * @range: a #GtkRange
447 * Gets the update policy of @range. See gtk_range_set_update_policy().
449 * Return value: the current update policy
452 gtk_range_get_update_policy (GtkRange *range)
454 g_return_val_if_fail (GTK_IS_RANGE (range), GTK_UPDATE_CONTINUOUS);
456 return range->update_policy;
460 * gtk_range_set_adjustment:
461 * @range: a #GtkRange
462 * @adjustment: a #GtkAdjustment
464 * Sets the adjustment to be used as the "model" object for this range
465 * widget. The adjustment indicates the current range value, the
466 * minimum and maximum range values, the step/page increments used
467 * for keybindings and scrolling, and the page size. The page size
468 * is normally 0 for #GtkScale and nonzero for #GtkScrollbar, and
469 * indicates the size of the visible area of the widget being scrolled.
470 * The page size affects the size of the scrollbar slider.
474 gtk_range_set_adjustment (GtkRange *range,
475 GtkAdjustment *adjustment)
477 g_return_if_fail (GTK_IS_RANGE (range));
480 adjustment = (GtkAdjustment*) gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0);
482 g_return_if_fail (GTK_IS_ADJUSTMENT (adjustment));
484 if (range->adjustment != adjustment)
486 if (range->adjustment)
488 gtk_signal_disconnect_by_func (GTK_OBJECT (range->adjustment),
489 G_CALLBACK (gtk_range_adjustment_changed),
491 gtk_signal_disconnect_by_func (GTK_OBJECT (range->adjustment),
492 G_CALLBACK (gtk_range_adjustment_value_changed),
494 gtk_object_unref (GTK_OBJECT (range->adjustment));
497 range->adjustment = adjustment;
498 gtk_object_ref (GTK_OBJECT (adjustment));
499 gtk_object_sink (GTK_OBJECT (adjustment));
501 gtk_signal_connect (GTK_OBJECT (adjustment), "changed",
502 (GtkSignalFunc) gtk_range_adjustment_changed,
504 gtk_signal_connect (GTK_OBJECT (adjustment), "value_changed",
505 (GtkSignalFunc) gtk_range_adjustment_value_changed,
508 gtk_range_adjustment_changed (adjustment, range);
509 g_object_notify (G_OBJECT (range), "adjustment");
514 * gtk_range_set_inverted:
515 * @range: a #GtkRange
516 * @setting: %TRUE to invert the range
518 * Ranges normally move from lower to higher values as the
519 * slider moves from top to bottom or left to right. Inverted
520 * ranges have higher values at the top or on the right rather than
521 * on the bottom or left.
525 gtk_range_set_inverted (GtkRange *range,
528 g_return_if_fail (GTK_IS_RANGE (range));
530 setting = setting != FALSE;
532 if (setting != range->inverted)
534 range->inverted = setting;
535 g_object_notify (G_OBJECT (range), "inverted");
536 gtk_widget_queue_resize (GTK_WIDGET (range));
541 * gtk_range_get_inverted:
542 * @range: a #GtkRange
544 * Gets the value set by gtk_range_set_inverted().
546 * Return value: %TRUE if the range is inverted
549 gtk_range_get_inverted (GtkRange *range)
551 g_return_val_if_fail (GTK_IS_RANGE (range), FALSE);
553 return range->inverted;
557 * gtk_range_set_increments:
558 * @range: a #GtkRange
562 * Sets the step and page sizes for the range.
563 * The step size is used when the user clicks the #GtkScrollbar
564 * arrows or moves #GtkScale via arrow keys. The page size
565 * is used for example when moving via Page Up or Page Down keys.
569 gtk_range_set_increments (GtkRange *range,
573 g_return_if_fail (GTK_IS_RANGE (range));
575 range->adjustment->step_increment = step;
576 range->adjustment->page_increment = page;
578 gtk_adjustment_changed (range->adjustment);
582 * gtk_range_set_range:
583 * @range: a #GtkRange
584 * @min: minimum range value
585 * @max: maximum range value
587 * Sets the allowable values in the #GtkRange, and clamps the range
588 * value to be between min and max.
591 gtk_range_set_range (GtkRange *range,
597 g_return_if_fail (GTK_IS_RANGE (range));
598 g_return_if_fail (min < max);
600 range->adjustment->lower = min;
601 range->adjustment->upper = max;
603 value = CLAMP (range->adjustment->value,
604 range->adjustment->lower,
605 (range->adjustment->upper - range->adjustment->page_size));
607 gtk_adjustment_changed (range->adjustment);
611 * gtk_range_set_value:
612 * @range: a #GtkRange
613 * @value: new value of the range
615 * Sets the current value of the range; if the value is outside the
616 * minimum or maximum range values, it will be clamped to fit inside
617 * them. The range emits the "value_changed" signal if the value
622 gtk_range_set_value (GtkRange *range,
625 g_return_if_fail (GTK_IS_RANGE (range));
627 value = CLAMP (value, range->adjustment->lower,
628 (range->adjustment->upper - range->adjustment->page_size));
630 gtk_adjustment_set_value (range->adjustment, value);
634 * gtk_range_get_value:
635 * @range: a #GtkRange
637 * Gets the current value of the range.
639 * Return value: current value of the range.
642 gtk_range_get_value (GtkRange *range)
644 g_return_val_if_fail (GTK_IS_RANGE (range), 0.0);
646 return range->adjustment->value;
650 should_invert (GtkRange *range)
652 if (range->orientation == GTK_ORIENTATION_HORIZONTAL)
654 (range->inverted && !range->flippable) ||
655 (range->inverted && range->flippable && gtk_widget_get_direction (GTK_WIDGET (range)) == GTK_TEXT_DIR_LTR) ||
656 (!range->inverted && range->flippable && gtk_widget_get_direction (GTK_WIDGET (range)) == GTK_TEXT_DIR_RTL);
658 return range->inverted;
662 gtk_range_finalize (GObject *object)
666 g_return_if_fail (GTK_IS_RANGE (object));
668 range = GTK_RANGE (object);
670 g_free (range->layout);
672 (* G_OBJECT_CLASS (parent_class)->finalize) (object);
676 gtk_range_destroy (GtkObject *object)
680 g_return_if_fail (GTK_IS_RANGE (object));
682 range = GTK_RANGE (object);
684 gtk_range_remove_step_timer (range);
685 gtk_range_remove_update_timer (range);
687 if (range->adjustment)
689 if (range->adjustment)
690 gtk_signal_disconnect_by_data (GTK_OBJECT (range->adjustment),
692 gtk_object_unref (GTK_OBJECT (range->adjustment));
693 range->adjustment = NULL;
696 (* GTK_OBJECT_CLASS (parent_class)->destroy) (object);
700 gtk_range_size_request (GtkWidget *widget,
701 GtkRequisition *requisition)
704 gint slider_width, stepper_size, trough_border, stepper_spacing;
705 GdkRectangle range_rect;
708 range = GTK_RANGE (widget);
710 gtk_range_get_props (range,
711 &slider_width, &stepper_size, &trough_border, &stepper_spacing);
713 gtk_range_calc_request (range,
714 slider_width, stepper_size, trough_border, stepper_spacing,
715 &range_rect, &border, NULL, NULL);
717 requisition->width = range_rect.width + border.left + border.right;
718 requisition->height = range_rect.height + border.top + border.bottom;
722 gtk_range_size_allocate (GtkWidget *widget,
723 GtkAllocation *allocation)
727 range = GTK_RANGE (widget);
729 widget->allocation = *allocation;
731 range->need_recalc = TRUE;
732 gtk_range_calc_layout (range, range->adjustment->value);
734 if (GTK_WIDGET_REALIZED (range))
735 gdk_window_move_resize (range->event_window,
736 widget->allocation.x,
737 widget->allocation.y,
738 widget->allocation.width,
739 widget->allocation.height);
743 gtk_range_realize (GtkWidget *widget)
746 GdkWindowAttr attributes;
747 gint attributes_mask;
749 range = GTK_RANGE (widget);
751 gtk_range_calc_layout (range, range->adjustment->value);
753 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
755 widget->window = gtk_widget_get_parent_window (widget);
756 gdk_window_ref (widget->window);
758 attributes.window_type = GDK_WINDOW_CHILD;
759 attributes.x = widget->allocation.x;
760 attributes.y = widget->allocation.y;
761 attributes.width = widget->allocation.width;
762 attributes.height = widget->allocation.height;
763 attributes.wclass = GDK_INPUT_ONLY;
764 attributes.event_mask = gtk_widget_get_events (widget);
765 attributes.event_mask |= (GDK_EXPOSURE_MASK |
766 GDK_BUTTON_PRESS_MASK |
767 GDK_BUTTON_RELEASE_MASK |
768 GDK_ENTER_NOTIFY_MASK |
769 GDK_LEAVE_NOTIFY_MASK |
770 GDK_POINTER_MOTION_MASK |
771 GDK_POINTER_MOTION_HINT_MASK);
773 attributes_mask = GDK_WA_X | GDK_WA_Y;
775 range->event_window = gdk_window_new (gtk_widget_get_parent_window (widget),
776 &attributes, attributes_mask);
777 gdk_window_set_user_data (range->event_window, range);
779 widget->style = gtk_style_attach (widget->style, widget->window);
783 gtk_range_unrealize (GtkWidget *widget)
787 g_return_if_fail (GTK_IS_RANGE (widget));
789 range = GTK_RANGE (widget);
791 gtk_range_remove_step_timer (range);
792 gtk_range_remove_update_timer (range);
794 gdk_window_set_user_data (range->event_window, NULL);
795 gdk_window_destroy (range->event_window);
796 range->event_window = NULL;
798 if (GTK_WIDGET_CLASS (parent_class)->unrealize)
799 (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
803 gtk_range_map (GtkWidget *widget)
805 GtkRange *range = GTK_RANGE (widget);
807 g_return_if_fail (GTK_IS_RANGE (widget));
809 gdk_window_show (range->event_window);
811 GTK_WIDGET_CLASS (parent_class)->map (widget);
815 gtk_range_unmap (GtkWidget *widget)
817 GtkRange *range = GTK_RANGE (widget);
819 g_return_if_fail (GTK_IS_RANGE (widget));
821 gdk_window_hide (range->event_window);
823 GTK_WIDGET_CLASS (parent_class)->unmap (widget);
827 draw_stepper (GtkRange *range,
829 GtkArrowType arrow_type,
834 GtkStateType state_type;
835 GtkShadowType shadow_type;
836 GdkRectangle intersection;
837 GtkWidget *widget = GTK_WIDGET (range);
839 /* More to get the right clip region than for efficiency */
840 if (!gdk_rectangle_intersect (area, rect, &intersection))
843 intersection.x += widget->allocation.x;
844 intersection.y += widget->allocation.y;
846 if (!GTK_WIDGET_IS_SENSITIVE (range))
847 state_type = GTK_STATE_INSENSITIVE;
849 state_type = GTK_STATE_ACTIVE;
851 state_type = GTK_STATE_PRELIGHT;
853 state_type = GTK_STATE_NORMAL;
856 shadow_type = GTK_SHADOW_IN;
858 shadow_type = GTK_SHADOW_OUT;
860 gtk_paint_arrow (GTK_WIDGET (range)->style,
861 GTK_WIDGET (range)->window,
862 state_type, shadow_type,
863 &intersection, GTK_WIDGET (range),
864 GTK_RANGE_GET_CLASS (range)->stepper_detail,
867 widget->allocation.x + rect->x,
868 widget->allocation.y + rect->y,
869 rect->width, rect->height);
873 gtk_range_expose (GtkWidget *widget,
874 GdkEventExpose *event)
879 GdkRectangle expose_area; /* Relative to widget->allocation */
882 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
883 g_return_val_if_fail (event != NULL, FALSE);
885 range = GTK_RANGE (widget);
887 expose_area = event->area;
888 expose_area.x -= widget->allocation.x;
889 expose_area.y -= widget->allocation.y;
891 gtk_range_calc_layout (range, range->adjustment->value);
893 sensitive = GTK_WIDGET_IS_SENSITIVE (widget);
895 /* Just to be confusing, we draw the trough for the whole
896 * range rectangle, not the trough rectangle (the trough
897 * rectangle is just for hit detection)
899 /* The gdk_rectangle_intersect is more to get the right
900 * clip region (limited to range_rect) than for efficiency
902 if (gdk_rectangle_intersect (&expose_area, &range->range_rect,
905 area.x += widget->allocation.x;
906 area.y += widget->allocation.y;
908 gtk_paint_box (widget->style,
910 sensitive ? GTK_STATE_ACTIVE : GTK_STATE_INSENSITIVE,
912 &area, GTK_WIDGET(range), "trough",
913 widget->allocation.x + range->range_rect.x,
914 widget->allocation.y + range->range_rect.y,
915 range->range_rect.width,
916 range->range_rect.height);
920 GTK_WIDGET_HAS_FOCUS (range))
921 gtk_paint_focus (widget->style, widget->window, GTK_WIDGET_STATE (widget),
922 &area, widget, "trough",
923 widget->allocation.x + range->range_rect.x,
924 widget->allocation.y + range->range_rect.y,
925 range->range_rect.width,
926 range->range_rect.height);
930 state = GTK_STATE_INSENSITIVE;
931 else if (range->layout->mouse_location == MOUSE_SLIDER)
932 state = GTK_STATE_PRELIGHT;
934 state = GTK_STATE_NORMAL;
936 if (gdk_rectangle_intersect (&expose_area,
937 &range->layout->slider,
940 area.x += widget->allocation.x;
941 area.y += widget->allocation.y;
943 gtk_paint_slider (widget->style,
949 GTK_RANGE_GET_CLASS (range)->slider_detail,
950 widget->allocation.x + range->layout->slider.x,
951 widget->allocation.y + range->layout->slider.y,
952 range->layout->slider.width,
953 range->layout->slider.height,
957 if (range->has_stepper_a)
958 draw_stepper (range, &range->layout->stepper_a,
959 range->orientation == GTK_ORIENTATION_VERTICAL ? GTK_ARROW_UP : GTK_ARROW_LEFT,
960 range->layout->grab_location == MOUSE_STEPPER_A,
961 range->layout->mouse_location == MOUSE_STEPPER_A,
964 if (range->has_stepper_b)
965 draw_stepper (range, &range->layout->stepper_b,
966 range->orientation == GTK_ORIENTATION_VERTICAL ? GTK_ARROW_DOWN : GTK_ARROW_RIGHT,
967 range->layout->grab_location == MOUSE_STEPPER_B,
968 range->layout->mouse_location == MOUSE_STEPPER_B,
971 if (range->has_stepper_c)
972 draw_stepper (range, &range->layout->stepper_c,
973 range->orientation == GTK_ORIENTATION_VERTICAL ? GTK_ARROW_UP : GTK_ARROW_LEFT,
974 range->layout->grab_location == MOUSE_STEPPER_C,
975 range->layout->mouse_location == MOUSE_STEPPER_C,
978 if (range->has_stepper_d)
979 draw_stepper (range, &range->layout->stepper_d,
980 range->orientation == GTK_ORIENTATION_VERTICAL ? GTK_ARROW_DOWN : GTK_ARROW_RIGHT,
981 range->layout->grab_location == MOUSE_STEPPER_D,
982 range->layout->mouse_location == MOUSE_STEPPER_D,
989 range_grab_add (GtkRange *range,
990 MouseLocation location,
993 /* we don't actually gtk_grab, since a button is down */
995 range->layout->grab_location = location;
996 range->layout->grab_button = button;
998 if (gtk_range_update_mouse_location (range))
999 gtk_widget_queue_draw (GTK_WIDGET (range));
1003 range_grab_remove (GtkRange *range)
1005 range->layout->grab_location = MOUSE_OUTSIDE;
1006 range->layout->grab_button = 0;
1008 if (gtk_range_update_mouse_location (range))
1009 gtk_widget_queue_draw (GTK_WIDGET (range));
1012 static GtkScrollType
1013 range_get_scroll_for_grab (GtkRange *range)
1015 switch (range->layout->grab_location)
1017 /* Backward stepper */
1018 case MOUSE_STEPPER_A:
1019 case MOUSE_STEPPER_C:
1020 switch (range->layout->grab_button)
1023 return GTK_SCROLL_STEP_BACKWARD;
1026 return GTK_SCROLL_PAGE_BACKWARD;
1029 return GTK_SCROLL_START;
1034 /* Forward stepper */
1035 case MOUSE_STEPPER_B:
1036 case MOUSE_STEPPER_D:
1037 switch (range->layout->grab_button)
1040 return GTK_SCROLL_STEP_FORWARD;
1043 return GTK_SCROLL_PAGE_FORWARD;
1046 return GTK_SCROLL_END;
1054 if (range->trough_click_forward)
1056 return range->layout->grab_button == 3
1057 ? GTK_SCROLL_STEP_FORWARD : GTK_SCROLL_PAGE_FORWARD;
1061 return range->layout->grab_button == 3
1062 ? GTK_SCROLL_STEP_BACKWARD : GTK_SCROLL_PAGE_BACKWARD;
1073 return GTK_SCROLL_NONE;
1077 coord_to_value (GtkRange *range,
1083 if (range->orientation == GTK_ORIENTATION_VERTICAL)
1084 if (range->layout->trough.height == range->layout->slider.height)
1087 frac = ((coord - range->layout->trough.y) /
1088 (gdouble) (range->layout->trough.height - range->layout->slider.height));
1090 if (range->layout->trough.width == range->layout->slider.width)
1093 frac = ((coord - range->layout->trough.x) /
1094 (gdouble) (range->layout->trough.width - range->layout->slider.width));
1096 if (should_invert (range))
1099 value = range->adjustment->lower +
1100 frac * (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size);
1106 gtk_range_button_press (GtkWidget *widget,
1107 GdkEventButton *event)
1111 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1112 g_return_val_if_fail (event != NULL, FALSE);
1114 range = GTK_RANGE (widget);
1116 if (!GTK_WIDGET_HAS_FOCUS (widget))
1117 gtk_widget_grab_focus (widget);
1119 /* ignore presses when we're already doing something else. */
1120 if (range->layout->grab_location != MOUSE_OUTSIDE)
1123 range->layout->mouse_x = event->x;
1124 range->layout->mouse_y = event->y;
1125 if (gtk_range_update_mouse_location (range))
1126 gtk_widget_queue_draw (widget);
1128 if (range->layout->mouse_location == MOUSE_TROUGH &&
1129 (event->button == 1 || event->button == 3))
1131 /* button 1 steps by step increment, as with button 1 on a stepper,
1132 * button 3 steps by page increment, as with button 2 on a stepper
1134 GtkScrollType scroll;
1135 gdouble click_value;
1137 click_value = coord_to_value (range,
1138 range->orientation == GTK_ORIENTATION_VERTICAL ?
1139 event->y : event->x);
1141 range->trough_click_forward = click_value > range->adjustment->value;
1142 range_grab_add (range, MOUSE_TROUGH, event->button);
1144 scroll = range_get_scroll_for_grab (range);
1146 gtk_range_add_step_timer (range, scroll);
1150 else if ((range->layout->mouse_location == MOUSE_STEPPER_A ||
1151 range->layout->mouse_location == MOUSE_STEPPER_B ||
1152 range->layout->mouse_location == MOUSE_STEPPER_C ||
1153 range->layout->mouse_location == MOUSE_STEPPER_D) &&
1154 (event->button == 1 || event->button == 2 || event->button == 3))
1156 GdkRectangle *stepper_area;
1157 GtkScrollType scroll;
1159 range_grab_add (range, range->layout->mouse_location, event->button);
1161 stepper_area = get_area (range, range->layout->mouse_location);
1162 gtk_widget_queue_draw_area (widget,
1163 widget->allocation.x + stepper_area->x,
1164 widget->allocation.y + stepper_area->y,
1165 stepper_area->width,
1166 stepper_area->height);
1168 scroll = range_get_scroll_for_grab (range);
1169 if (scroll != GTK_SCROLL_NONE)
1170 gtk_range_add_step_timer (range, scroll);
1174 else if ((range->layout->mouse_location == MOUSE_TROUGH &&
1175 event->button == 2) ||
1176 range->layout->mouse_location == MOUSE_SLIDER)
1178 gboolean need_value_update = FALSE;
1180 /* Any button can be used to drag the slider, but you can start
1181 * dragging the slider with a trough click using button 2;
1182 * On button 2 press, we warp the slider to mouse position,
1183 * then begin the slider drag.
1185 if (event->button == 2)
1187 gdouble slider_low_value, slider_high_value, new_value;
1190 coord_to_value (range,
1191 range->orientation == GTK_ORIENTATION_VERTICAL ?
1192 event->y : event->x);
1194 coord_to_value (range,
1195 range->orientation == GTK_ORIENTATION_VERTICAL ?
1196 event->y - range->layout->slider.height :
1197 event->x - range->layout->slider.width);
1199 /* compute new value for warped slider */
1200 new_value = slider_low_value + (slider_high_value - slider_low_value) / 2;
1202 /* recalc slider, so we can set slide_initial_slider_position
1205 range->need_recalc = TRUE;
1206 gtk_range_calc_layout (range, new_value);
1208 /* defer adjustment updates to update_slider_position() in order
1209 * to keep pixel quantisation
1211 need_value_update = TRUE;
1214 if (range->orientation == GTK_ORIENTATION_VERTICAL)
1216 range->slide_initial_slider_position = range->layout->slider.y;
1217 range->slide_initial_coordinate = event->y;
1221 range->slide_initial_slider_position = range->layout->slider.x;
1222 range->slide_initial_coordinate = event->x;
1225 if (need_value_update)
1226 update_slider_position (range, event->x, event->y);
1228 range_grab_add (range, MOUSE_SLIDER, event->button);
1236 /* During a slide, move the slider as required given new mouse position */
1238 update_slider_position (GtkRange *range,
1246 if (range->orientation == GTK_ORIENTATION_VERTICAL)
1247 delta = mouse_y - range->slide_initial_coordinate;
1249 delta = mouse_x - range->slide_initial_coordinate;
1251 c = range->slide_initial_slider_position + delta;
1253 new_value = coord_to_value (range, c);
1255 gtk_range_internal_set_value (range, new_value);
1259 gtk_range_button_release (GtkWidget *widget,
1260 GdkEventButton *event)
1264 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1265 g_return_val_if_fail (event != NULL, FALSE);
1267 range = GTK_RANGE (widget);
1269 range->layout->mouse_x = event->x;
1270 range->layout->mouse_y = event->y;
1272 if (range->layout->grab_button == event->button)
1274 GtkScrollType scroll;
1275 MouseLocation grab_location;
1277 grab_location = range->layout->grab_location;
1279 scroll = range_get_scroll_for_grab (range);
1281 range_grab_remove (range);
1282 gtk_range_remove_step_timer (range);
1284 /* We only do the move if we're still on top of the button at
1287 if (grab_location == range->layout->mouse_location &&
1288 scroll != GTK_SCROLL_NONE)
1290 gtk_range_scroll (range, scroll);
1293 if (grab_location == MOUSE_SLIDER)
1294 update_slider_position (range, event->x, event->y);
1296 /* Flush any pending discontinuous/delayed updates */
1297 gtk_range_update_value (range);
1299 /* Just be lazy about this, if we scrolled it will all redraw anyway,
1300 * so no point optimizing the button deactivate case
1302 gtk_widget_queue_draw (widget);
1311 gtk_range_scroll_event (GtkWidget *widget,
1312 GdkEventScroll *event)
1316 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1317 g_return_val_if_fail (event != NULL, FALSE);
1319 range = GTK_RANGE (widget);
1321 if (GTK_WIDGET_REALIZED (range))
1323 GtkAdjustment *adj = GTK_RANGE (range)->adjustment;
1324 gdouble new_value = adj->value + ((event->direction == GDK_SCROLL_UP ||
1325 event->direction == GDK_SCROLL_LEFT) ?
1326 -adj->page_increment / 2:
1327 adj->page_increment / 2);
1329 gtk_range_internal_set_value (range, new_value);
1331 /* Policy DELAYED makes sense with scroll events,
1332 * but DISCONTINUOUS doesn't, so we update immediately
1335 if (range->update_policy == GTK_UPDATE_DISCONTINUOUS)
1336 gtk_range_update_value (range);
1343 gtk_range_motion_notify (GtkWidget *widget,
1344 GdkEventMotion *event)
1349 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1350 g_return_val_if_fail (event != NULL, FALSE);
1352 range = GTK_RANGE (widget);
1354 gdk_window_get_pointer (range->event_window, &x, &y, NULL);
1356 range->layout->mouse_x = x;
1357 range->layout->mouse_y = y;
1359 if (gtk_range_update_mouse_location (range))
1360 gtk_widget_queue_draw (widget);
1362 if (range->layout->grab_location == MOUSE_SLIDER)
1363 update_slider_position (range, x, y);
1365 /* We handled the event if the mouse was in the range_rect */
1366 return range->layout->mouse_location != MOUSE_OUTSIDE;
1370 gtk_range_enter_notify (GtkWidget *widget,
1371 GdkEventCrossing *event)
1375 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1376 g_return_val_if_fail (event != NULL, FALSE);
1378 range = GTK_RANGE (widget);
1380 range->layout->mouse_x = event->x;
1381 range->layout->mouse_y = event->y;
1383 if (gtk_range_update_mouse_location (range))
1384 gtk_widget_queue_draw (widget);
1390 gtk_range_leave_notify (GtkWidget *widget,
1391 GdkEventCrossing *event)
1395 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1396 g_return_val_if_fail (event != NULL, FALSE);
1398 range = GTK_RANGE (widget);
1400 range->layout->mouse_x = -1;
1401 range->layout->mouse_y = -1;
1403 if (gtk_range_update_mouse_location (range))
1404 gtk_widget_queue_draw (widget);
1410 gtk_range_adjustment_changed (GtkAdjustment *adjustment,
1415 g_return_if_fail (adjustment != NULL);
1416 g_return_if_fail (data != NULL);
1418 range = GTK_RANGE (data);
1420 range->need_recalc = TRUE;
1421 gtk_widget_queue_draw (GTK_WIDGET (range));
1423 /* Note that we don't round off to range->round_digits here.
1424 * that's because it's really broken to change a value
1425 * in response to a change signal on that value; round_digits
1426 * is therefore defined to be a filter on what the GtkRange
1427 * can input into the adjustment, not a filter that the GtkRange
1428 * will enforce on the adjustment.
1433 gtk_range_adjustment_value_changed (GtkAdjustment *adjustment,
1438 g_return_if_fail (adjustment != NULL);
1439 g_return_if_fail (data != NULL);
1441 range = GTK_RANGE (data);
1443 range->need_recalc = TRUE;
1445 gtk_widget_queue_draw (GTK_WIDGET (range));
1446 /* This is so we don't lag the widget being scrolled. */
1447 if (GTK_WIDGET_REALIZED (range))
1448 gdk_window_process_updates (GTK_WIDGET (range)->window, FALSE);
1450 /* Note that we don't round off to range->round_digits here.
1451 * that's because it's really broken to change a value
1452 * in response to a change signal on that value; round_digits
1453 * is therefore defined to be a filter on what the GtkRange
1454 * can input into the adjustment, not a filter that the GtkRange
1455 * will enforce on the adjustment.
1458 g_signal_emit (G_OBJECT (range), signals[VALUE_CHANGED], 0);
1462 gtk_range_style_set (GtkWidget *widget,
1463 GtkStyle *previous_style)
1467 g_return_if_fail (GTK_IS_RANGE (widget));
1469 range = GTK_RANGE (widget);
1471 range->need_recalc = TRUE;
1473 (* GTK_WIDGET_CLASS (parent_class)->style_set) (widget, previous_style);
1477 step_back (GtkRange *range)
1481 newval = range->adjustment->value - range->adjustment->step_increment;
1482 gtk_range_internal_set_value (range, newval);
1486 step_forward (GtkRange *range)
1490 newval = range->adjustment->value + range->adjustment->step_increment;
1492 gtk_range_internal_set_value (range, newval);
1497 page_back (GtkRange *range)
1501 newval = range->adjustment->value - range->adjustment->page_increment;
1502 gtk_range_internal_set_value (range, newval);
1506 page_forward (GtkRange *range)
1510 newval = range->adjustment->value + range->adjustment->page_increment;
1512 gtk_range_internal_set_value (range, newval);
1516 gtk_range_scroll (GtkRange *range,
1517 GtkScrollType scroll)
1521 case GTK_SCROLL_STEP_LEFT:
1522 if (should_invert (range))
1523 step_forward (range);
1528 case GTK_SCROLL_STEP_UP:
1529 if (should_invert (range))
1530 step_forward (range);
1535 case GTK_SCROLL_STEP_RIGHT:
1536 if (should_invert (range))
1539 step_forward (range);
1542 case GTK_SCROLL_STEP_DOWN:
1543 if (should_invert (range))
1546 step_forward (range);
1549 case GTK_SCROLL_STEP_BACKWARD:
1553 case GTK_SCROLL_STEP_FORWARD:
1554 step_forward (range);
1557 case GTK_SCROLL_PAGE_LEFT:
1558 if (should_invert (range))
1559 page_forward (range);
1564 case GTK_SCROLL_PAGE_UP:
1565 if (should_invert (range))
1566 page_forward (range);
1571 case GTK_SCROLL_PAGE_RIGHT:
1572 if (should_invert (range))
1575 page_forward (range);
1578 case GTK_SCROLL_PAGE_DOWN:
1579 if (should_invert (range))
1582 page_forward (range);
1585 case GTK_SCROLL_PAGE_BACKWARD:
1589 case GTK_SCROLL_PAGE_FORWARD:
1590 page_forward (range);
1593 case GTK_SCROLL_START:
1594 gtk_range_internal_set_value (range,
1595 range->adjustment->lower);
1598 case GTK_SCROLL_END:
1599 gtk_range_internal_set_value (range,
1600 range->adjustment->upper - range->adjustment->page_size);
1603 case GTK_SCROLL_JUMP:
1604 /* Used by CList, range doesn't use it. */
1607 case GTK_SCROLL_NONE:
1613 gtk_range_move_slider (GtkRange *range,
1614 GtkScrollType scroll)
1616 gtk_range_scroll (range, scroll);
1618 /* Policy DELAYED makes sense with key events,
1619 * but DISCONTINUOUS doesn't, so we update immediately
1622 if (range->update_policy == GTK_UPDATE_DISCONTINUOUS)
1623 gtk_range_update_value (range);
1627 gtk_range_get_props (GtkRange *range,
1630 gint *trough_border,
1631 gint *stepper_spacing)
1633 GtkWidget *widget = GTK_WIDGET (range);
1634 gint tmp_slider_width, tmp_stepper_size, tmp_trough_border, tmp_stepper_spacing;
1636 gtk_widget_style_get (widget,
1637 "slider_width", &tmp_slider_width,
1638 "trough_border", &tmp_trough_border,
1639 "stepper_size", &tmp_stepper_size,
1640 "stepper_spacing", &tmp_stepper_spacing,
1644 *slider_width = tmp_slider_width;
1647 *trough_border = tmp_trough_border;
1650 *stepper_size = tmp_stepper_size;
1652 if (stepper_spacing)
1653 *stepper_spacing = tmp_stepper_spacing;
1656 #define POINT_IN_RECT(xcoord, ycoord, rect) \
1657 ((xcoord) >= (rect).x && \
1658 (xcoord) < ((rect).x + (rect).width) && \
1659 (ycoord) >= (rect).y && \
1660 (ycoord) < ((rect).y + (rect).height))
1662 /* Update mouse location, return TRUE if it changes */
1664 gtk_range_update_mouse_location (GtkRange *range)
1670 widget = GTK_WIDGET (range);
1672 old = range->layout->mouse_location;
1674 x = range->layout->mouse_x;
1675 y = range->layout->mouse_y;
1677 if (range->layout->grab_location != MOUSE_OUTSIDE)
1678 range->layout->mouse_location = range->layout->grab_location;
1679 else if (POINT_IN_RECT (x, y, range->layout->stepper_a))
1680 range->layout->mouse_location = MOUSE_STEPPER_A;
1681 else if (POINT_IN_RECT (x, y, range->layout->stepper_b))
1682 range->layout->mouse_location = MOUSE_STEPPER_B;
1683 else if (POINT_IN_RECT (x, y, range->layout->stepper_c))
1684 range->layout->mouse_location = MOUSE_STEPPER_C;
1685 else if (POINT_IN_RECT (x, y, range->layout->stepper_d))
1686 range->layout->mouse_location = MOUSE_STEPPER_D;
1687 else if (POINT_IN_RECT (x, y, range->layout->slider))
1688 range->layout->mouse_location = MOUSE_SLIDER;
1689 else if (POINT_IN_RECT (x, y, range->layout->trough))
1690 range->layout->mouse_location = MOUSE_TROUGH;
1691 else if (POINT_IN_RECT (x, y, widget->allocation))
1692 range->layout->mouse_location = MOUSE_WIDGET;
1694 range->layout->mouse_location = MOUSE_OUTSIDE;
1696 return old != range->layout->mouse_location;
1699 /* Clamp rect, border inside widget->allocation, such that we prefer
1700 * to take space from border not rect in all directions, and prefer to
1701 * give space to border over rect in one direction.
1704 clamp_dimensions (GtkWidget *widget,
1707 gboolean border_expands_horizontally)
1709 gint extra, shortage;
1711 g_return_if_fail (rect->x == 0);
1712 g_return_if_fail (rect->y == 0);
1713 g_return_if_fail (rect->width >= 0);
1714 g_return_if_fail (rect->height >= 0);
1718 extra = widget->allocation.width - border->left - border->right - rect->width;
1721 if (border_expands_horizontally)
1723 border->left += extra / 2;
1724 border->right += extra / 2 + extra % 2;
1728 rect->width += extra;
1732 /* See if we can fit rect, if not kill the border */
1733 shortage = rect->width - widget->allocation.width;
1736 rect->width = widget->allocation.width;
1737 /* lose the border */
1743 /* See if we can fit rect with borders */
1744 shortage = rect->width + border->left + border->right -
1745 widget->allocation.width;
1748 /* Shrink borders */
1749 border->left -= shortage / 2;
1750 border->right -= shortage / 2 + shortage % 2;
1756 extra = widget->allocation.height - border->top - border->bottom - rect->height;
1759 if (border_expands_horizontally)
1761 /* don't expand border vertically */
1762 rect->height += extra;
1766 border->top += extra / 2;
1767 border->bottom += extra / 2 + extra % 2;
1771 /* See if we can fit rect, if not kill the border */
1772 shortage = rect->height - widget->allocation.height;
1775 rect->height = widget->allocation.height;
1776 /* lose the border */
1782 /* See if we can fit rect with borders */
1783 shortage = rect->height + border->top + border->bottom -
1784 widget->allocation.height;
1787 /* Shrink borders */
1788 border->top -= shortage / 2;
1789 border->bottom -= shortage / 2 + shortage % 2;
1795 gtk_range_calc_request (GtkRange *range,
1799 gint stepper_spacing,
1800 GdkRectangle *range_rect,
1803 gint *slider_length_p)
1813 if (GTK_RANGE_GET_CLASS (range)->get_range_border)
1814 (* GTK_RANGE_GET_CLASS (range)->get_range_border) (range, border);
1817 if (range->has_stepper_a)
1819 if (range->has_stepper_b)
1821 if (range->has_stepper_c)
1823 if (range->has_stepper_d)
1826 slider_length = range->min_slider_size;
1831 /* We never expand to fill available space in the small dimension
1832 * (i.e. vertical scrollbars are always a fixed width)
1834 if (range->orientation == GTK_ORIENTATION_VERTICAL)
1836 range_rect->width = trough_border * 2 + slider_width;
1837 range_rect->height = stepper_size * n_steppers + stepper_spacing * 2 + trough_border * 2 + slider_length;
1841 range_rect->width = stepper_size * n_steppers + stepper_spacing * 2 + trough_border * 2 + slider_length;
1842 range_rect->height = trough_border * 2 + slider_width;
1846 *n_steppers_p = n_steppers;
1848 if (slider_length_p)
1849 *slider_length_p = slider_length;
1853 gtk_range_calc_layout (GtkRange *range,
1854 gdouble adjustment_value)
1856 gint slider_width, stepper_size, trough_border, stepper_spacing;
1860 GdkRectangle range_rect;
1861 GtkRangeLayout *layout;
1864 if (!range->need_recalc)
1867 /* If we have a too-small allocation, we prefer the steppers over
1868 * the trough/slider, probably the steppers are a more useful
1869 * feature in small spaces.
1871 * Also, we prefer to draw the range itself rather than the border
1872 * areas if there's a conflict, since the borders will be decoration
1873 * not controls. Though this depends on subclasses cooperating by
1874 * not drawing on range->range_rect.
1877 widget = GTK_WIDGET (range);
1878 layout = range->layout;
1880 gtk_range_get_props (range,
1881 &slider_width, &stepper_size, &trough_border, &stepper_spacing);
1883 gtk_range_calc_request (range,
1884 slider_width, stepper_size, trough_border, stepper_spacing,
1885 &range_rect, &border, &n_steppers, &slider_length);
1887 /* We never expand to fill available space in the small dimension
1888 * (i.e. vertical scrollbars are always a fixed width)
1890 if (range->orientation == GTK_ORIENTATION_VERTICAL)
1892 clamp_dimensions (widget, &range_rect, &border, TRUE);
1896 clamp_dimensions (widget, &range_rect, &border, FALSE);
1899 range_rect.x = border.left;
1900 range_rect.y = border.top;
1902 range->range_rect = range_rect;
1904 if (range->orientation == GTK_ORIENTATION_VERTICAL)
1906 gint stepper_width, stepper_height;
1908 /* Steppers are the width of the range, and stepper_size in
1909 * height, or if we don't have enough height, divided equally
1910 * among available space.
1912 stepper_width = range_rect.width - trough_border * 2;
1914 if (stepper_width < 1)
1915 stepper_width = range_rect.width; /* screw the trough border */
1917 if (n_steppers == 0)
1918 stepper_height = 0; /* avoid divide by n_steppers */
1920 stepper_height = MIN (stepper_size, (range_rect.height / n_steppers));
1924 layout->stepper_a.x = range_rect.x + trough_border;
1925 layout->stepper_a.y = range_rect.y + trough_border;
1927 if (range->has_stepper_a)
1929 layout->stepper_a.width = stepper_width;
1930 layout->stepper_a.height = stepper_height;
1934 layout->stepper_a.width = 0;
1935 layout->stepper_a.height = 0;
1940 layout->stepper_b.x = layout->stepper_a.x;
1941 layout->stepper_b.y = layout->stepper_a.y + layout->stepper_a.height;
1943 if (range->has_stepper_b)
1945 layout->stepper_b.width = stepper_width;
1946 layout->stepper_b.height = stepper_height;
1950 layout->stepper_b.width = 0;
1951 layout->stepper_b.height = 0;
1956 if (range->has_stepper_d)
1958 layout->stepper_d.width = stepper_width;
1959 layout->stepper_d.height = stepper_height;
1963 layout->stepper_d.width = 0;
1964 layout->stepper_d.height = 0;
1967 layout->stepper_d.x = layout->stepper_a.x;
1968 layout->stepper_d.y = range_rect.y + range_rect.height - layout->stepper_d.height - trough_border;
1972 if (range->has_stepper_c)
1974 layout->stepper_c.width = stepper_width;
1975 layout->stepper_c.height = stepper_height;
1979 layout->stepper_c.width = 0;
1980 layout->stepper_c.height = 0;
1983 layout->stepper_c.x = layout->stepper_a.x;
1984 layout->stepper_c.y = layout->stepper_d.y - layout->stepper_c.height;
1986 /* Now the trough is the remaining space between steppers B and C,
1989 layout->trough.x = range_rect.x;
1990 layout->trough.y = layout->stepper_b.y + layout->stepper_b.height;
1991 layout->trough.width = range_rect.width;
1992 layout->trough.height = layout->stepper_c.y - (layout->stepper_b.y + layout->stepper_b.height);
1994 /* Slider fits into the trough, with stepper_spacing on either side,
1995 * and the size/position based on the adjustment or fixed, depending.
1997 layout->slider.x = layout->trough.x + trough_border;
1998 layout->slider.width = layout->trough.width - trough_border * 2;
2000 /* Compute slider position/length */
2002 gint y, bottom, top, height;
2004 top = layout->trough.y + stepper_spacing;
2005 bottom = layout->trough.y + layout->trough.height - stepper_spacing;
2007 /* slider height is the fraction (page_size /
2008 * total_adjustment_range) times the trough height in pixels
2010 height = ((bottom - top) * (range->adjustment->page_size /
2011 (range->adjustment->upper - range->adjustment->lower)));
2013 if (height < range->min_slider_size ||
2014 range->slider_size_fixed)
2015 height = range->min_slider_size;
2017 height = MIN (height, (layout->trough.height - stepper_spacing * 2));
2021 if (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size != 0)
2022 y += (bottom - top - height) * ((adjustment_value - range->adjustment->lower) /
2023 (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size));
2025 y = CLAMP (y, top, bottom);
2027 if (should_invert (range))
2028 y = bottom - (y - top + height);
2030 layout->slider.y = y;
2031 layout->slider.height = height;
2033 /* These are publically exported */
2034 range->slider_start = layout->slider.y;
2035 range->slider_end = layout->slider.y + layout->slider.height;
2040 gint stepper_width, stepper_height;
2042 /* Steppers are the height of the range, and stepper_size in
2043 * width, or if we don't have enough width, divided equally
2044 * among available space.
2046 stepper_height = range_rect.height - trough_border * 2;
2048 if (stepper_height < 1)
2049 stepper_height = range_rect.height; /* screw the trough border */
2051 if (n_steppers == 0)
2052 stepper_width = 0; /* avoid divide by n_steppers */
2054 stepper_width = MIN (stepper_size, (range_rect.width / n_steppers));
2058 layout->stepper_a.x = range_rect.x + trough_border;
2059 layout->stepper_a.y = range_rect.y + trough_border;
2061 if (range->has_stepper_a)
2063 layout->stepper_a.width = stepper_width;
2064 layout->stepper_a.height = stepper_height;
2068 layout->stepper_a.width = 0;
2069 layout->stepper_a.height = 0;
2074 layout->stepper_b.x = layout->stepper_a.x + layout->stepper_a.width;
2075 layout->stepper_b.y = layout->stepper_a.y;
2077 if (range->has_stepper_b)
2079 layout->stepper_b.width = stepper_width;
2080 layout->stepper_b.height = stepper_height;
2084 layout->stepper_b.width = 0;
2085 layout->stepper_b.height = 0;
2090 if (range->has_stepper_d)
2092 layout->stepper_d.width = stepper_width;
2093 layout->stepper_d.height = stepper_height;
2097 layout->stepper_d.width = 0;
2098 layout->stepper_d.height = 0;
2101 layout->stepper_d.x = range_rect.x + range_rect.width - layout->stepper_d.width - trough_border;
2102 layout->stepper_d.y = layout->stepper_a.y;
2107 if (range->has_stepper_c)
2109 layout->stepper_c.width = stepper_width;
2110 layout->stepper_c.height = stepper_height;
2114 layout->stepper_c.width = 0;
2115 layout->stepper_c.height = 0;
2118 layout->stepper_c.x = layout->stepper_d.x - layout->stepper_c.width;
2119 layout->stepper_c.y = layout->stepper_a.y;
2121 /* Now the trough is the remaining space between steppers B and C,
2124 layout->trough.x = layout->stepper_b.x + layout->stepper_b.width;
2125 layout->trough.y = range_rect.y;
2127 layout->trough.width = layout->stepper_c.x - (layout->stepper_b.x + layout->stepper_b.width);
2128 layout->trough.height = range_rect.height;
2130 /* Slider fits into the trough, with stepper_spacing on either side,
2131 * and the size/position based on the adjustment or fixed, depending.
2133 layout->slider.y = layout->trough.y + trough_border;
2134 layout->slider.height = layout->trough.height - trough_border * 2;
2136 /* Compute slider position/length */
2138 gint x, left, right, width;
2140 left = layout->trough.x + stepper_spacing;
2141 right = layout->trough.x + layout->trough.width - stepper_spacing;
2143 /* slider width is the fraction (page_size /
2144 * total_adjustment_range) times the trough width in pixels
2146 width = ((right - left) * (range->adjustment->page_size /
2147 (range->adjustment->upper - range->adjustment->lower)));
2149 if (width < range->min_slider_size ||
2150 range->slider_size_fixed)
2151 width = range->min_slider_size;
2153 width = MIN (width, (layout->trough.width - stepper_spacing * 2));
2157 if (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size != 0)
2158 x += (right - left - width) * ((adjustment_value - range->adjustment->lower) /
2159 (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size));
2161 x = CLAMP (x, left, right);
2163 if (should_invert (range))
2164 x = right - (x - left + width);
2166 layout->slider.x = x;
2167 layout->slider.width = width;
2169 /* These are publically exported */
2170 range->slider_start = layout->slider.x;
2171 range->slider_end = layout->slider.x + layout->slider.width;
2175 gtk_range_update_mouse_location (range);
2178 static GdkRectangle*
2179 get_area (GtkRange *range,
2180 MouseLocation location)
2184 case MOUSE_STEPPER_A:
2185 return &range->layout->stepper_a;
2186 case MOUSE_STEPPER_B:
2187 return &range->layout->stepper_b;
2188 case MOUSE_STEPPER_C:
2189 return &range->layout->stepper_c;
2190 case MOUSE_STEPPER_D:
2191 return &range->layout->stepper_d;
2193 return &range->layout->trough;
2195 return &range->layout->slider;
2201 g_warning (G_STRLOC": bug");
2206 gtk_range_internal_set_value (GtkRange *range,
2209 value = CLAMP (value, range->adjustment->lower,
2210 (range->adjustment->upper - range->adjustment->page_size));
2212 if (range->round_digits >= 0)
2216 /* This is just so darn lame. */
2217 g_snprintf (buffer, 128, "%0.*f",
2218 range->round_digits, value);
2219 sscanf (buffer, "%lf", &value);
2222 if (range->adjustment->value != value)
2224 range->need_recalc = TRUE;
2226 gtk_widget_queue_draw (GTK_WIDGET (range));
2228 switch (range->update_policy)
2230 case GTK_UPDATE_CONTINUOUS:
2231 gtk_adjustment_set_value (range->adjustment, value);
2234 /* Delayed means we update after a period of inactivity */
2235 case GTK_UPDATE_DELAYED:
2236 gtk_range_reset_update_timer (range);
2239 /* Discontinuous means we update on button release */
2240 case GTK_UPDATE_DISCONTINUOUS:
2241 /* don't emit value_changed signal */
2242 range->adjustment->value = value;
2243 range->update_pending = TRUE;
2250 gtk_range_update_value (GtkRange *range)
2252 gtk_range_remove_update_timer (range);
2254 if (range->update_pending)
2256 gtk_adjustment_value_changed (range->adjustment);
2258 range->update_pending = FALSE;
2262 struct _GtkRangeStepTimer
2269 second_timeout (gpointer data)
2273 GDK_THREADS_ENTER ();
2274 range = GTK_RANGE (data);
2275 gtk_range_scroll (range, range->timer->step);
2276 GDK_THREADS_LEAVE ();
2282 initial_timeout (gpointer data)
2286 GDK_THREADS_ENTER ();
2287 range = GTK_RANGE (data);
2288 range->timer->timeout_id =
2289 g_timeout_add (SCROLL_LATER_DELAY,
2292 GDK_THREADS_LEAVE ();
2299 gtk_range_add_step_timer (GtkRange *range,
2302 g_return_if_fail (range->timer == NULL);
2303 g_return_if_fail (step != GTK_SCROLL_NONE);
2305 range->timer = g_new (GtkRangeStepTimer, 1);
2307 range->timer->timeout_id =
2308 g_timeout_add (SCROLL_INITIAL_DELAY,
2311 range->timer->step = step;
2315 gtk_range_remove_step_timer (GtkRange *range)
2319 if (range->timer->timeout_id != 0)
2320 g_source_remove (range->timer->timeout_id);
2322 g_free (range->timer);
2324 range->timer = NULL;
2329 update_timeout (gpointer data)
2333 GDK_THREADS_ENTER ();
2334 range = GTK_RANGE (data);
2335 gtk_range_update_value (range);
2336 range->update_timeout_id = 0;
2337 GDK_THREADS_LEAVE ();
2344 gtk_range_reset_update_timer (GtkRange *range)
2346 gtk_range_remove_update_timer (range);
2348 range->update_timeout_id = g_timeout_add (UPDATE_DELAY,
2354 gtk_range_remove_update_timer (GtkRange *range)
2356 if (range->update_timeout_id != 0)
2358 g_source_remove (range->update_timeout_id);
2359 range->update_timeout_id = 0;