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/.
32 #include "gtksignal.h"
35 #define SCROLL_INITIAL_DELAY 250 /* must hold button this long before ... */
36 #define SCROLL_LATER_DELAY 100 /* ... it starts repeating at this rate */
37 #define UPDATE_DELAY 300 /* Delay for queued update */
60 MOUSE_WIDGET /* inside widget but not in any of the above GUI elements */
63 struct _GtkRangeLayout
65 /* These are in widget->window coordinates */
66 GdkRectangle stepper_a;
67 GdkRectangle stepper_b;
68 GdkRectangle stepper_c;
69 GdkRectangle stepper_d;
70 /* The trough rectangle is the area the thumb can slide in, not the
76 /* Layout-related state */
78 MouseLocation mouse_location;
79 /* last mouse coords we got, or -1 if mouse is outside the range */
82 /* "grabbed" mouse location, OUTSIDE for no grab */
83 MouseLocation grab_location;
84 gint grab_button; /* 0 if none */
88 static void gtk_range_class_init (GtkRangeClass *klass);
89 static void gtk_range_init (GtkRange *range);
90 static void gtk_range_set_property (GObject *object,
94 static void gtk_range_get_property (GObject *object,
98 static void gtk_range_destroy (GtkObject *object);
99 static void gtk_range_finalize (GObject *object);
100 static void gtk_range_size_request (GtkWidget *widget,
101 GtkRequisition *requisition);
102 static void gtk_range_size_allocate (GtkWidget *widget,
103 GtkAllocation *allocation);
104 static void gtk_range_realize (GtkWidget *widget);
105 static void gtk_range_unrealize (GtkWidget *widget);
106 static gint gtk_range_expose (GtkWidget *widget,
107 GdkEventExpose *event);
108 static gint gtk_range_button_press (GtkWidget *widget,
109 GdkEventButton *event);
110 static gint gtk_range_button_release (GtkWidget *widget,
111 GdkEventButton *event);
112 static gint gtk_range_motion_notify (GtkWidget *widget,
113 GdkEventMotion *event);
114 static gint gtk_range_enter_notify (GtkWidget *widget,
115 GdkEventCrossing *event);
116 static gint gtk_range_leave_notify (GtkWidget *widget,
117 GdkEventCrossing *event);
118 static gint gtk_range_scroll_event (GtkWidget *widget,
119 GdkEventScroll *event);
120 static void gtk_range_style_set (GtkWidget *widget,
121 GtkStyle *previous_style);
122 static void update_slider_position (GtkRange *range,
129 static void gtk_range_move_slider (GtkRange *range,
130 GtkScrollType scroll);
133 static void gtk_range_scroll (GtkRange *range,
134 GtkScrollType scroll);
135 static gboolean gtk_range_update_mouse_location (GtkRange *range);
136 static void gtk_range_calc_layout (GtkRange *range,
137 gdouble adjustment_value);
138 static void gtk_range_get_props (GtkRange *range,
142 gint *stepper_spacing);
143 static void gtk_range_calc_request (GtkRange *range,
147 gint stepper_spacing,
148 GdkRectangle *range_rect,
151 gint *slider_length_p);
152 static void gtk_range_adjustment_value_changed (GtkAdjustment *adjustment,
154 static void gtk_range_adjustment_changed (GtkAdjustment *adjustment,
156 static void gtk_range_add_step_timer (GtkRange *range,
158 static void gtk_range_remove_step_timer (GtkRange *range);
159 static void gtk_range_reset_update_timer (GtkRange *range);
160 static void gtk_range_remove_update_timer (GtkRange *range);
161 static GdkRectangle* get_area (GtkRange *range,
162 MouseLocation location);
163 static void gtk_range_internal_set_value (GtkRange *range,
165 static void gtk_range_update_value (GtkRange *range);
168 static GtkWidgetClass *parent_class = NULL;
169 static guint signals[LAST_SIGNAL];
173 gtk_range_get_type (void)
175 static GtkType range_type = 0;
179 static const GtkTypeInfo range_info =
183 sizeof (GtkRangeClass),
184 (GtkClassInitFunc) gtk_range_class_init,
185 (GtkObjectInitFunc) gtk_range_init,
186 /* reserved_1 */ NULL,
187 /* reserved_2 */ NULL,
188 (GtkClassInitFunc) NULL,
191 range_type = gtk_type_unique (GTK_TYPE_WIDGET, &range_info);
198 gtk_range_class_init (GtkRangeClass *class)
200 GObjectClass *gobject_class;
201 GtkObjectClass *object_class;
202 GtkWidgetClass *widget_class;
204 gobject_class = G_OBJECT_CLASS (class);
205 object_class = (GtkObjectClass*) class;
206 widget_class = (GtkWidgetClass*) class;
208 parent_class = g_type_class_peek_parent (class);
210 gobject_class->set_property = gtk_range_set_property;
211 gobject_class->get_property = gtk_range_get_property;
212 gobject_class->finalize = gtk_range_finalize;
213 object_class->destroy = gtk_range_destroy;
215 widget_class->size_request = gtk_range_size_request;
216 widget_class->size_allocate = gtk_range_size_allocate;
217 widget_class->realize = gtk_range_realize;
218 widget_class->unrealize = gtk_range_unrealize;
219 widget_class->expose_event = gtk_range_expose;
220 widget_class->button_press_event = gtk_range_button_press;
221 widget_class->button_release_event = gtk_range_button_release;
222 widget_class->motion_notify_event = gtk_range_motion_notify;
223 widget_class->scroll_event = gtk_range_scroll_event;
224 widget_class->enter_notify_event = gtk_range_enter_notify;
225 widget_class->leave_notify_event = gtk_range_leave_notify;
226 widget_class->style_set = gtk_range_style_set;
228 class->move_slider = gtk_range_move_slider;
230 class->slider_detail = "slider";
231 class->stepper_detail = "stepper";
233 signals[VALUE_CHANGED] =
234 g_signal_new ("value_changed",
235 G_TYPE_FROM_CLASS (object_class),
237 G_STRUCT_OFFSET (GtkRangeClass, value_changed),
239 gtk_marshal_NONE__NONE,
242 signals[MOVE_SLIDER] =
243 g_signal_new ("move_slider",
244 G_TYPE_FROM_CLASS (object_class),
245 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
246 G_STRUCT_OFFSET (GtkRangeClass, move_slider),
248 gtk_marshal_VOID__ENUM,
250 GTK_TYPE_SCROLL_TYPE);
253 g_object_class_install_property (gobject_class,
255 g_param_spec_enum ("update_policy",
257 _("How the range should be updated on the screen"),
258 GTK_TYPE_UPDATE_TYPE,
259 GTK_UPDATE_CONTINUOUS,
262 g_object_class_install_property (gobject_class,
264 g_param_spec_object ("adjustment",
266 _("The GtkAdjustment that contains the current value of this range object"),
268 G_PARAM_READWRITE | G_PARAM_CONSTRUCT));
270 g_object_class_install_property (gobject_class,
272 g_param_spec_boolean ("inverted",
274 _("Invert direction slider moves to increase range value"),
278 gtk_widget_class_install_style_property (widget_class,
279 g_param_spec_int ("slider_width",
281 _("Width of scrollbar or scale thumb"),
286 gtk_widget_class_install_style_property (widget_class,
287 g_param_spec_int ("trough_border",
289 _("Spacing between thumb/steppers and outer trough bevel"),
294 gtk_widget_class_install_style_property (widget_class,
295 g_param_spec_int ("stepper_size",
297 _("Length of step buttons at ends"),
302 gtk_widget_class_install_style_property (widget_class,
303 g_param_spec_int ("stepper_spacing",
304 _("Stepper Spacing"),
305 _("Spacing between step buttons and thumb"),
313 gtk_range_set_property (GObject *object,
320 range = GTK_RANGE (object);
324 case PROP_UPDATE_POLICY:
325 gtk_range_set_update_policy (range, g_value_get_enum (value));
327 case PROP_ADJUSTMENT:
328 gtk_range_set_adjustment (range, g_value_get_object (value));
331 gtk_range_set_inverted (range, g_value_get_boolean (value));
334 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
340 gtk_range_get_property (GObject *object,
347 range = GTK_RANGE (object);
351 case PROP_UPDATE_POLICY:
352 g_value_set_enum (value, range->update_policy);
354 case PROP_ADJUSTMENT:
355 g_value_set_object (value, G_OBJECT (range->adjustment));
358 g_value_set_boolean (value, range->inverted);
361 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
367 gtk_range_init (GtkRange *range)
369 range->adjustment = NULL;
370 range->update_policy = GTK_UPDATE_CONTINUOUS;
371 range->inverted = FALSE;
372 range->flippable = FALSE;
373 range->min_slider_size = 1;
374 range->has_stepper_a = FALSE;
375 range->has_stepper_b = FALSE;
376 range->has_stepper_c = FALSE;
377 range->has_stepper_d = FALSE;
378 range->need_recalc = TRUE;
379 range->round_digits = -1;
380 range->layout = g_new0 (GtkRangeLayout, 1);
381 range->layout->grab_location = MOUSE_OUTSIDE;
382 range->layout->grab_button = 0;
387 * gtk_range_get_adjustment:
388 * @range: a #GtkRange
390 * Get the #GtkAdjustment which is the "model" object for #GtkRange.
391 * See gtk_range_set_adjustment() for details.
392 * The return value does not have a reference added, so should not
395 * Return value: a #GtkAdjustment
398 gtk_range_get_adjustment (GtkRange *range)
400 g_return_val_if_fail (GTK_IS_RANGE (range), NULL);
402 if (!range->adjustment)
403 gtk_range_set_adjustment (range, NULL);
405 return range->adjustment;
409 * gtk_range_set_update_policy:
410 * @range: a #GtkRange
411 * @policy: update policy
413 * Sets the update policy for the range. #GTK_UPDATE_CONTINUOUS means that
414 * anytime the range slider is moved, the range value will change and the
415 * value_changed signal will be emitted. #GTK_UPDATE_DELAYED means that
416 * the value will be updated after a brief timeout where no slider motion
417 * occurs, so updates are spaced by a short time rather than
418 * continuous. #GTK_UPDATE_DISCONTINUOUS means that the value will only
419 * be updated when the user releases the button and ends the slider
424 gtk_range_set_update_policy (GtkRange *range,
425 GtkUpdateType policy)
427 g_return_if_fail (GTK_IS_RANGE (range));
429 if (range->update_policy != policy)
431 range->update_policy = policy;
432 g_object_notify (G_OBJECT (range), "update_policy");
437 * gtk_range_get_update_policy:
438 * @range: a #GtkRange
440 * Gets the update policy of @range. See gtk_range_set_update_policy().
442 * Return value: the current update policy
445 gtk_range_get_update_policy (GtkRange *range)
447 g_return_val_if_fail (GTK_IS_RANGE (range), GTK_UPDATE_CONTINUOUS);
449 return range->update_policy;
453 * gtk_range_set_adjustment:
454 * @range: a #GtkRange
455 * @adjustment: a #GtkAdjustment
457 * Sets the adjustment to be used as the "model" object for this range
458 * widget. The adjustment indicates the current range value, the
459 * minimum and maximum range values, the step/page increments used
460 * for keybindings and scrolling, and the page size. The page size
461 * is normally 0 for #GtkScale and nonzero for #GtkScrollbar, and
462 * indicates the size of the visible area of the widget being scrolled.
463 * The page size affects the size of the scrollbar slider.
467 gtk_range_set_adjustment (GtkRange *range,
468 GtkAdjustment *adjustment)
470 g_return_if_fail (GTK_IS_RANGE (range));
473 adjustment = (GtkAdjustment*) gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0);
475 g_return_if_fail (GTK_IS_ADJUSTMENT (adjustment));
477 if (range->adjustment != adjustment)
479 if (range->adjustment)
481 gtk_signal_disconnect_by_func (GTK_OBJECT (range->adjustment),
482 G_CALLBACK (gtk_range_adjustment_changed),
484 gtk_signal_disconnect_by_func (GTK_OBJECT (range->adjustment),
485 G_CALLBACK (gtk_range_adjustment_value_changed),
487 gtk_object_unref (GTK_OBJECT (range->adjustment));
490 range->adjustment = adjustment;
491 gtk_object_ref (GTK_OBJECT (adjustment));
492 gtk_object_sink (GTK_OBJECT (adjustment));
494 gtk_signal_connect (GTK_OBJECT (adjustment), "changed",
495 (GtkSignalFunc) gtk_range_adjustment_changed,
497 gtk_signal_connect (GTK_OBJECT (adjustment), "value_changed",
498 (GtkSignalFunc) gtk_range_adjustment_value_changed,
501 gtk_range_adjustment_changed (adjustment, range);
502 g_object_notify (G_OBJECT (range), "adjustment");
507 * gtk_range_set_inverted:
508 * @range: a #GtkRange
509 * @setting: %TRUE to invert the range
511 * Ranges normally move from lower to higher values as the
512 * slider moves from top to bottom or left to right. Inverted
513 * ranges have higher values at the top or on the right rather than
514 * on the bottom or left.
518 gtk_range_set_inverted (GtkRange *range,
521 g_return_if_fail (GTK_IS_RANGE (range));
523 setting = setting != FALSE;
525 if (setting != range->inverted)
527 range->inverted = setting;
528 g_object_notify (G_OBJECT (range), "inverted");
529 gtk_widget_queue_resize (GTK_WIDGET (range));
534 * gtk_range_get_inverted:
535 * @range: a #GtkRange
537 * Gets the value set by gtk_range_set_inverted().
539 * Return value: %TRUE if the range is inverted
542 gtk_range_get_inverted (GtkRange *range)
544 g_return_val_if_fail (GTK_IS_RANGE (range), FALSE);
546 return range->inverted;
550 * gtk_range_set_increments:
551 * @range: a #GtkRange
555 * Sets the step and page sizes for the range.
556 * The step size is used when the user clicks the #GtkScrollbar
557 * arrows or moves #GtkScale via arrow keys. The page size
558 * is used for example when moving via Page Up or Page Down keys.
562 gtk_range_set_increments (GtkRange *range,
566 g_return_if_fail (GTK_IS_RANGE (range));
568 range->adjustment->step_increment = step;
569 range->adjustment->page_increment = page;
571 gtk_adjustment_changed (range->adjustment);
575 * gtk_range_set_range:
576 * @range: a #GtkRange
577 * @min: minimum range value
578 * @max: maximum range value
580 * Sets the allowable values in the #GtkRange, and clamps the range
581 * value to be between min and max.
584 gtk_range_set_range (GtkRange *range,
590 g_return_if_fail (GTK_IS_RANGE (range));
591 g_return_if_fail (min < max);
593 range->adjustment->lower = min;
594 range->adjustment->upper = max;
596 value = CLAMP (range->adjustment->value,
597 range->adjustment->lower,
598 (range->adjustment->upper - range->adjustment->page_size));
600 gtk_adjustment_changed (range->adjustment);
604 * gtk_range_set_value:
605 * @range: a #GtkRange
606 * @value: new value of the range
608 * Sets the current value of the range; if the value is outside the
609 * minimum or maximum range values, it will be clamped to fit inside
610 * them. The range emits the "value_changed" signal if the value
615 gtk_range_set_value (GtkRange *range,
618 g_return_if_fail (GTK_IS_RANGE (range));
620 value = CLAMP (value, range->adjustment->lower,
621 (range->adjustment->upper - range->adjustment->page_size));
623 gtk_adjustment_set_value (range->adjustment, value);
627 * gtk_range_get_value:
628 * @range: a #GtkRange
630 * Gets the current value of the range.
632 * Return value: current value of the range.
635 gtk_range_get_value (GtkRange *range)
637 g_return_val_if_fail (GTK_IS_RANGE (range), 0.0);
639 return range->adjustment->value;
643 should_invert (GtkRange *range)
645 if (range->orientation == GTK_ORIENTATION_HORIZONTAL)
647 (range->inverted && !range->flippable) ||
648 (range->inverted && range->flippable && gtk_widget_get_direction (GTK_WIDGET (range)) == GTK_TEXT_DIR_LTR) ||
649 (!range->inverted && range->flippable && gtk_widget_get_direction (GTK_WIDGET (range)) == GTK_TEXT_DIR_RTL);
651 return range->inverted;
655 gtk_range_finalize (GObject *object)
659 g_return_if_fail (GTK_IS_RANGE (object));
661 range = GTK_RANGE (object);
663 g_free (range->layout);
665 (* G_OBJECT_CLASS (parent_class)->finalize) (object);
669 gtk_range_destroy (GtkObject *object)
673 g_return_if_fail (GTK_IS_RANGE (object));
675 range = GTK_RANGE (object);
677 gtk_range_remove_step_timer (range);
678 gtk_range_remove_update_timer (range);
680 if (range->adjustment)
682 if (range->adjustment)
683 gtk_signal_disconnect_by_data (GTK_OBJECT (range->adjustment),
685 gtk_object_unref (GTK_OBJECT (range->adjustment));
686 range->adjustment = NULL;
689 (* GTK_OBJECT_CLASS (parent_class)->destroy) (object);
693 gtk_range_size_request (GtkWidget *widget,
694 GtkRequisition *requisition)
697 gint slider_width, stepper_size, trough_border, stepper_spacing;
698 GdkRectangle range_rect;
701 range = GTK_RANGE (widget);
703 gtk_range_get_props (range,
704 &slider_width, &stepper_size, &trough_border, &stepper_spacing);
706 gtk_range_calc_request (range,
707 slider_width, stepper_size, trough_border, stepper_spacing,
708 &range_rect, &border, NULL, NULL);
710 requisition->width = range_rect.width + border.left + border.right;
711 requisition->height = range_rect.height + border.top + border.bottom;
715 gtk_range_size_allocate (GtkWidget *widget,
716 GtkAllocation *allocation)
720 range = GTK_RANGE (widget);
722 range->need_recalc = TRUE;
723 gtk_range_calc_layout (range, range->adjustment->value);
725 (* GTK_WIDGET_CLASS (parent_class)->size_allocate) (widget, allocation);
729 gtk_range_realize (GtkWidget *widget)
732 GdkWindowAttr attributes;
733 gint attributes_mask;
735 range = GTK_RANGE (widget);
737 gtk_range_calc_layout (range, range->adjustment->value);
739 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
741 attributes.window_type = GDK_WINDOW_CHILD;
742 attributes.x = widget->allocation.x;
743 attributes.y = widget->allocation.y;
744 attributes.width = widget->allocation.width;
745 attributes.height = widget->allocation.height;
746 attributes.wclass = GDK_INPUT_OUTPUT;
747 attributes.visual = gtk_widget_get_visual (widget);
748 attributes.colormap = gtk_widget_get_colormap (widget);
749 attributes.event_mask = gtk_widget_get_events (widget);
750 attributes.event_mask |= (GDK_EXPOSURE_MASK |
751 GDK_BUTTON_PRESS_MASK |
752 GDK_BUTTON_RELEASE_MASK |
753 GDK_ENTER_NOTIFY_MASK |
754 GDK_LEAVE_NOTIFY_MASK |
755 GDK_POINTER_MOTION_MASK |
756 GDK_POINTER_MOTION_HINT_MASK);
758 attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
760 widget->window = gdk_window_new (gtk_widget_get_parent_window (widget), &attributes, attributes_mask);
761 gdk_window_set_user_data (widget->window, range);
763 widget->style = gtk_style_attach (widget->style, widget->window);
764 gtk_style_set_background (widget->style, widget->window, widget->state);
768 gtk_range_unrealize (GtkWidget *widget)
772 g_return_if_fail (GTK_IS_RANGE (widget));
774 range = GTK_RANGE (widget);
776 gtk_range_remove_step_timer (range);
777 gtk_range_remove_update_timer (range);
779 if (GTK_WIDGET_CLASS (parent_class)->unrealize)
780 (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
784 draw_stepper (GtkRange *range,
786 GtkArrowType arrow_type,
791 GtkStateType state_type;
792 GtkShadowType shadow_type;
793 GdkRectangle intersection;
795 /* More to get the right clip region than for efficiency */
796 if (!gdk_rectangle_intersect (area, rect, &intersection))
799 if (!GTK_WIDGET_IS_SENSITIVE (range))
800 state_type = GTK_STATE_INSENSITIVE;
802 state_type = GTK_STATE_ACTIVE;
804 state_type = GTK_STATE_PRELIGHT;
806 state_type = GTK_STATE_NORMAL;
809 shadow_type = GTK_SHADOW_IN;
811 shadow_type = GTK_SHADOW_OUT;
813 gtk_paint_arrow (GTK_WIDGET (range)->style,
814 GTK_WIDGET (range)->window,
815 state_type, shadow_type,
816 &intersection, GTK_WIDGET (range),
817 GTK_RANGE_GET_CLASS (range)->stepper_detail,
819 TRUE, rect->x, rect->y, rect->width, rect->height);
823 gtk_range_expose (GtkWidget *widget,
824 GdkEventExpose *event)
831 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
832 g_return_val_if_fail (event != NULL, FALSE);
834 range = GTK_RANGE (widget);
836 gtk_range_calc_layout (range, range->adjustment->value);
838 sensitive = GTK_WIDGET_IS_SENSITIVE (widget);
840 /* Just to be confusing, we draw the trough for the whole
841 * range rectangle, not the trough rectangle (the trough
842 * rectangle is just for hit detection)
844 /* The gdk_rectangle_intersect is more to get the right
845 * clip region (limited to range_rect) than for efficiency
847 if (gdk_rectangle_intersect (&event->area, &range->range_rect,
850 gtk_paint_box (widget->style,
852 sensitive ? GTK_STATE_ACTIVE : GTK_STATE_INSENSITIVE,
854 &area, GTK_WIDGET(range), "trough",
857 range->range_rect.width,
858 range->range_rect.height);
862 GTK_WIDGET_HAS_FOCUS (range))
863 gtk_paint_focus (widget->style,
865 &area, widget, "trough",
868 range->range_rect.width,
869 range->range_rect.height);
873 state = GTK_STATE_INSENSITIVE;
874 else if (range->layout->mouse_location == MOUSE_SLIDER)
875 state = GTK_STATE_PRELIGHT;
877 state = GTK_STATE_NORMAL;
879 if (gdk_rectangle_intersect (&event->area,
880 &range->layout->slider,
883 gtk_paint_slider (widget->style,
889 GTK_RANGE_GET_CLASS (range)->slider_detail,
890 range->layout->slider.x,
891 range->layout->slider.y,
892 range->layout->slider.width,
893 range->layout->slider.height,
897 if (range->has_stepper_a)
898 draw_stepper (range, &range->layout->stepper_a,
899 range->orientation == GTK_ORIENTATION_VERTICAL ? GTK_ARROW_UP : GTK_ARROW_LEFT,
900 range->layout->grab_location == MOUSE_STEPPER_A,
901 range->layout->mouse_location == MOUSE_STEPPER_A,
904 if (range->has_stepper_b)
905 draw_stepper (range, &range->layout->stepper_b,
906 range->orientation == GTK_ORIENTATION_VERTICAL ? GTK_ARROW_DOWN : GTK_ARROW_RIGHT,
907 range->layout->grab_location == MOUSE_STEPPER_B,
908 range->layout->mouse_location == MOUSE_STEPPER_B,
911 if (range->has_stepper_c)
912 draw_stepper (range, &range->layout->stepper_c,
913 range->orientation == GTK_ORIENTATION_VERTICAL ? GTK_ARROW_UP : GTK_ARROW_LEFT,
914 range->layout->grab_location == MOUSE_STEPPER_C,
915 range->layout->mouse_location == MOUSE_STEPPER_C,
918 if (range->has_stepper_d)
919 draw_stepper (range, &range->layout->stepper_d,
920 range->orientation == GTK_ORIENTATION_VERTICAL ? GTK_ARROW_DOWN : GTK_ARROW_RIGHT,
921 range->layout->grab_location == MOUSE_STEPPER_D,
922 range->layout->mouse_location == MOUSE_STEPPER_D,
929 range_grab_add (GtkRange *range,
930 MouseLocation location,
933 /* we don't actually gtk_grab, since a button is down */
935 range->layout->grab_location = location;
936 range->layout->grab_button = button;
938 if (gtk_range_update_mouse_location (range))
939 gtk_widget_queue_draw (GTK_WIDGET (range));
943 range_grab_remove (GtkRange *range)
945 range->layout->grab_location = MOUSE_OUTSIDE;
946 range->layout->grab_button = 0;
948 if (gtk_range_update_mouse_location (range))
949 gtk_widget_queue_draw (GTK_WIDGET (range));
953 range_get_scroll_for_grab (GtkRange *range)
955 switch (range->layout->grab_location)
957 /* Backward stepper */
958 case MOUSE_STEPPER_A:
959 case MOUSE_STEPPER_C:
960 switch (range->layout->grab_button)
963 return GTK_SCROLL_STEP_BACKWARD;
966 return GTK_SCROLL_PAGE_BACKWARD;
969 return GTK_SCROLL_START;
974 /* Forward stepper */
975 case MOUSE_STEPPER_B:
976 case MOUSE_STEPPER_D:
977 switch (range->layout->grab_button)
980 return GTK_SCROLL_STEP_FORWARD;
983 return GTK_SCROLL_PAGE_FORWARD;
986 return GTK_SCROLL_END;
994 if (range->trough_click_forward)
996 return range->layout->grab_button == 3
997 ? GTK_SCROLL_PAGE_FORWARD : GTK_SCROLL_STEP_FORWARD;
1001 return range->layout->grab_button == 3
1002 ? GTK_SCROLL_PAGE_BACKWARD : GTK_SCROLL_STEP_BACKWARD;
1013 return GTK_SCROLL_NONE;
1017 coord_to_value (GtkRange *range,
1023 if (range->orientation == GTK_ORIENTATION_VERTICAL)
1024 if (range->layout->trough.height == range->layout->slider.height)
1027 frac = ((coord - range->layout->trough.y) /
1028 (gdouble) (range->layout->trough.height - range->layout->slider.height));
1030 if (range->layout->trough.width == range->layout->slider.width)
1033 frac = ((coord - range->layout->trough.x) /
1034 (gdouble) (range->layout->trough.width - range->layout->slider.width));
1036 if (should_invert (range))
1039 value = range->adjustment->lower +
1040 frac * (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size);
1046 gtk_range_button_press (GtkWidget *widget,
1047 GdkEventButton *event)
1051 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1052 g_return_val_if_fail (event != NULL, FALSE);
1054 range = GTK_RANGE (widget);
1056 if (!GTK_WIDGET_HAS_FOCUS (widget))
1057 gtk_widget_grab_focus (widget);
1059 /* ignore presses when we're already doing something else. */
1060 if (range->layout->grab_location != MOUSE_OUTSIDE)
1063 range->layout->mouse_x = event->x;
1064 range->layout->mouse_y = event->y;
1065 if (gtk_range_update_mouse_location (range))
1066 gtk_widget_queue_draw (widget);
1068 if (range->layout->mouse_location == MOUSE_TROUGH &&
1069 (event->button == 1 || event->button == 3))
1071 /* button 1 steps by step increment, as with button 1 on a stepper,
1072 * button 3 steps by page increment, as with button 2 on a stepper
1074 GtkScrollType scroll;
1075 gdouble click_value;
1077 click_value = coord_to_value (range,
1078 range->orientation == GTK_ORIENTATION_VERTICAL ?
1079 event->y : event->x);
1081 range->trough_click_forward = click_value > range->adjustment->value;
1082 range_grab_add (range, MOUSE_TROUGH, event->button);
1084 scroll = range_get_scroll_for_grab (range);
1086 gtk_range_add_step_timer (range, scroll);
1090 else if ((range->layout->mouse_location == MOUSE_STEPPER_A ||
1091 range->layout->mouse_location == MOUSE_STEPPER_B ||
1092 range->layout->mouse_location == MOUSE_STEPPER_C ||
1093 range->layout->mouse_location == MOUSE_STEPPER_D) &&
1094 (event->button == 1 || event->button == 2 || event->button == 3))
1096 GdkRectangle *stepper_area;
1097 GtkScrollType scroll;
1099 range_grab_add (range, range->layout->mouse_location, event->button);
1101 stepper_area = get_area (range, range->layout->mouse_location);
1102 gtk_widget_queue_draw_area (widget,
1105 stepper_area->width,
1106 stepper_area->height);
1108 scroll = range_get_scroll_for_grab (range);
1109 if (scroll != GTK_SCROLL_NONE)
1110 gtk_range_add_step_timer (range, scroll);
1114 else if ((range->layout->mouse_location == MOUSE_TROUGH &&
1115 event->button == 2) ||
1116 range->layout->mouse_location == MOUSE_SLIDER)
1118 gboolean need_value_update = FALSE;
1120 /* Any button can be used to drag the slider, but you can start
1121 * dragging the slider with a trough click using button 2;
1122 * On button 2 press, we warp the slider to mouse position,
1123 * then begin the slider drag.
1125 if (event->button == 2)
1127 gdouble slider_low_value, slider_high_value, new_value;
1130 coord_to_value (range,
1131 range->orientation == GTK_ORIENTATION_VERTICAL ?
1132 event->y : event->x);
1134 coord_to_value (range,
1135 range->orientation == GTK_ORIENTATION_VERTICAL ?
1136 event->y - range->layout->slider.height :
1137 event->x - range->layout->slider.width);
1139 /* compute new value for warped slider */
1140 new_value = slider_low_value + (slider_high_value - slider_low_value) / 2;
1142 /* recalc slider, so we can set slide_initial_slider_position
1145 range->need_recalc = TRUE;
1146 gtk_range_calc_layout (range, new_value);
1148 /* defer adjustment updates to update_slider_position() in order
1149 * to keep pixel quantisation
1151 need_value_update = TRUE;
1154 if (range->orientation == GTK_ORIENTATION_VERTICAL)
1156 range->slide_initial_slider_position = range->layout->slider.y;
1157 range->slide_initial_coordinate = event->y;
1161 range->slide_initial_slider_position = range->layout->slider.x;
1162 range->slide_initial_coordinate = event->x;
1165 if (need_value_update)
1166 update_slider_position (range, event->x, event->y);
1168 range_grab_add (range, MOUSE_SLIDER, event->button);
1176 /* During a slide, move the slider as required given new mouse position */
1178 update_slider_position (GtkRange *range,
1186 if (range->orientation == GTK_ORIENTATION_VERTICAL)
1187 delta = mouse_y - range->slide_initial_coordinate;
1189 delta = mouse_x - range->slide_initial_coordinate;
1191 c = range->slide_initial_slider_position + delta;
1193 new_value = coord_to_value (range, c);
1195 gtk_range_internal_set_value (range, new_value);
1199 gtk_range_button_release (GtkWidget *widget,
1200 GdkEventButton *event)
1204 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1205 g_return_val_if_fail (event != NULL, FALSE);
1207 range = GTK_RANGE (widget);
1209 range->layout->mouse_x = event->x;
1210 range->layout->mouse_y = event->y;
1212 if (range->layout->grab_button == event->button)
1214 GtkScrollType scroll;
1215 MouseLocation grab_location;
1217 grab_location = range->layout->grab_location;
1219 scroll = range_get_scroll_for_grab (range);
1221 range_grab_remove (range);
1222 gtk_range_remove_step_timer (range);
1224 /* We only do the move if we're still on top of the button at
1227 if (grab_location == range->layout->mouse_location &&
1228 scroll != GTK_SCROLL_NONE)
1230 gtk_range_scroll (range, scroll);
1233 if (grab_location == MOUSE_SLIDER)
1234 update_slider_position (range, event->x, event->y);
1236 /* Flush any pending discontinuous/delayed updates */
1237 gtk_range_update_value (range);
1239 /* Just be lazy about this, if we scrolled it will all redraw anyway,
1240 * so no point optimizing the button deactivate case
1242 gtk_widget_queue_draw (widget);
1251 gtk_range_scroll_event (GtkWidget *widget,
1252 GdkEventScroll *event)
1256 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1257 g_return_val_if_fail (event != NULL, FALSE);
1259 range = GTK_RANGE (widget);
1261 if (GTK_WIDGET_REALIZED (range))
1263 GtkAdjustment *adj = GTK_RANGE (range)->adjustment;
1264 gdouble new_value = adj->value + ((event->direction == GDK_SCROLL_UP ||
1265 event->direction == GDK_SCROLL_LEFT) ?
1266 -adj->page_increment / 2:
1267 adj->page_increment / 2);
1269 gtk_range_internal_set_value (range, new_value);
1271 /* Policy DELAYED makes sense with scroll events,
1272 * but DISCONTINUOUS doesn't, so we update immediately
1275 if (range->update_policy == GTK_UPDATE_DISCONTINUOUS)
1276 gtk_range_update_value (range);
1283 gtk_range_motion_notify (GtkWidget *widget,
1284 GdkEventMotion *event)
1289 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1290 g_return_val_if_fail (event != NULL, FALSE);
1292 range = GTK_RANGE (widget);
1294 gdk_window_get_pointer (widget->window, &x, &y, NULL);
1296 range->layout->mouse_x = x;
1297 range->layout->mouse_y = y;
1299 if (gtk_range_update_mouse_location (range))
1300 gtk_widget_queue_draw (widget);
1302 if (range->layout->grab_location == MOUSE_SLIDER)
1303 update_slider_position (range, x, y);
1305 /* We handled the event if the mouse was in the range_rect */
1306 return range->layout->mouse_location != MOUSE_OUTSIDE;
1310 gtk_range_enter_notify (GtkWidget *widget,
1311 GdkEventCrossing *event)
1315 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1316 g_return_val_if_fail (event != NULL, FALSE);
1318 range = GTK_RANGE (widget);
1320 range->layout->mouse_x = event->x;
1321 range->layout->mouse_y = event->y;
1323 if (gtk_range_update_mouse_location (range))
1324 gtk_widget_queue_draw (widget);
1330 gtk_range_leave_notify (GtkWidget *widget,
1331 GdkEventCrossing *event)
1335 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1336 g_return_val_if_fail (event != NULL, FALSE);
1338 range = GTK_RANGE (widget);
1340 range->layout->mouse_x = -1;
1341 range->layout->mouse_y = -1;
1343 if (gtk_range_update_mouse_location (range))
1344 gtk_widget_queue_draw (widget);
1350 gtk_range_adjustment_changed (GtkAdjustment *adjustment,
1355 g_return_if_fail (adjustment != NULL);
1356 g_return_if_fail (data != NULL);
1358 range = GTK_RANGE (data);
1360 range->need_recalc = TRUE;
1361 gtk_widget_queue_draw (GTK_WIDGET (range));
1363 /* Note that we don't round off to range->round_digits here.
1364 * that's because it's really broken to change a value
1365 * in response to a change signal on that value; round_digits
1366 * is therefore defined to be a filter on what the GtkRange
1367 * can input into the adjustment, not a filter that the GtkRange
1368 * will enforce on the adjustment.
1373 gtk_range_adjustment_value_changed (GtkAdjustment *adjustment,
1378 g_return_if_fail (adjustment != NULL);
1379 g_return_if_fail (data != NULL);
1381 range = GTK_RANGE (data);
1383 range->need_recalc = TRUE;
1385 gtk_widget_queue_draw (GTK_WIDGET (range));
1386 /* This is so we don't lag the widget being scrolled. */
1387 if (GTK_WIDGET_REALIZED (range))
1388 gdk_window_process_updates (GTK_WIDGET (range)->window, TRUE);
1390 /* Note that we don't round off to range->round_digits here.
1391 * that's because it's really broken to change a value
1392 * in response to a change signal on that value; round_digits
1393 * is therefore defined to be a filter on what the GtkRange
1394 * can input into the adjustment, not a filter that the GtkRange
1395 * will enforce on the adjustment.
1398 g_signal_emit (G_OBJECT (range), signals[VALUE_CHANGED], 0);
1402 gtk_range_style_set (GtkWidget *widget,
1403 GtkStyle *previous_style)
1407 g_return_if_fail (GTK_IS_RANGE (widget));
1409 range = GTK_RANGE (widget);
1411 range->need_recalc = TRUE;
1413 (* GTK_WIDGET_CLASS (parent_class)->style_set) (widget, previous_style);
1417 step_back (GtkRange *range)
1421 newval = range->adjustment->value - range->adjustment->step_increment;
1422 gtk_range_internal_set_value (range, newval);
1426 step_forward (GtkRange *range)
1430 newval = range->adjustment->value + range->adjustment->step_increment;
1432 gtk_range_internal_set_value (range, newval);
1437 page_back (GtkRange *range)
1441 newval = range->adjustment->value - range->adjustment->page_increment;
1442 gtk_range_internal_set_value (range, newval);
1446 page_forward (GtkRange *range)
1450 newval = range->adjustment->value + range->adjustment->page_increment;
1452 gtk_range_internal_set_value (range, newval);
1456 gtk_range_scroll (GtkRange *range,
1457 GtkScrollType scroll)
1461 case GTK_SCROLL_STEP_LEFT:
1462 if (should_invert (range))
1463 step_forward (range);
1468 case GTK_SCROLL_STEP_UP:
1469 if (should_invert (range))
1470 step_forward (range);
1475 case GTK_SCROLL_STEP_RIGHT:
1476 if (should_invert (range))
1479 step_forward (range);
1482 case GTK_SCROLL_STEP_DOWN:
1483 if (should_invert (range))
1486 step_forward (range);
1489 case GTK_SCROLL_STEP_BACKWARD:
1493 case GTK_SCROLL_STEP_FORWARD:
1494 step_forward (range);
1497 case GTK_SCROLL_PAGE_LEFT:
1498 if (should_invert (range))
1499 page_forward (range);
1504 case GTK_SCROLL_PAGE_UP:
1505 if (should_invert (range))
1506 page_forward (range);
1511 case GTK_SCROLL_PAGE_RIGHT:
1512 if (should_invert (range))
1515 page_forward (range);
1518 case GTK_SCROLL_PAGE_DOWN:
1519 if (should_invert (range))
1522 page_forward (range);
1525 case GTK_SCROLL_PAGE_BACKWARD:
1529 case GTK_SCROLL_PAGE_FORWARD:
1530 page_forward (range);
1533 case GTK_SCROLL_START:
1534 gtk_range_internal_set_value (range,
1535 range->adjustment->lower);
1538 case GTK_SCROLL_END:
1539 gtk_range_internal_set_value (range,
1540 range->adjustment->upper - range->adjustment->page_size);
1543 case GTK_SCROLL_JUMP:
1544 /* Used by CList, range doesn't use it. */
1547 case GTK_SCROLL_NONE:
1553 gtk_range_move_slider (GtkRange *range,
1554 GtkScrollType scroll)
1556 gtk_range_scroll (range, scroll);
1558 /* Policy DELAYED makes sense with key events,
1559 * but DISCONTINUOUS doesn't, so we update immediately
1562 if (range->update_policy == GTK_UPDATE_DISCONTINUOUS)
1563 gtk_range_update_value (range);
1567 gtk_range_get_props (GtkRange *range,
1570 gint *trough_border,
1571 gint *stepper_spacing)
1573 GtkWidget *widget = GTK_WIDGET (range);
1574 gint tmp_slider_width, tmp_stepper_size, tmp_trough_border, tmp_stepper_spacing;
1576 gtk_widget_style_get (widget,
1577 "slider_width", &tmp_slider_width,
1578 "trough_border", &tmp_trough_border,
1579 "stepper_size", &tmp_stepper_size,
1580 "stepper_spacing", &tmp_stepper_spacing,
1584 *slider_width = tmp_slider_width;
1587 *trough_border = tmp_trough_border;
1590 *stepper_size = tmp_stepper_size;
1592 if (stepper_spacing)
1593 *stepper_spacing = tmp_stepper_spacing;
1596 #define POINT_IN_RECT(xcoord, ycoord, rect) \
1597 ((xcoord) >= (rect).x && \
1598 (xcoord) < ((rect).x + (rect).width) && \
1599 (ycoord) >= (rect).y && \
1600 (ycoord) < ((rect).y + (rect).height))
1602 /* Update mouse location, return TRUE if it changes */
1604 gtk_range_update_mouse_location (GtkRange *range)
1610 widget = GTK_WIDGET (range);
1612 old = range->layout->mouse_location;
1614 x = range->layout->mouse_x;
1615 y = range->layout->mouse_y;
1617 if (range->layout->grab_location != MOUSE_OUTSIDE)
1618 range->layout->mouse_location = range->layout->grab_location;
1619 else if (POINT_IN_RECT (x, y, range->layout->stepper_a))
1620 range->layout->mouse_location = MOUSE_STEPPER_A;
1621 else if (POINT_IN_RECT (x, y, range->layout->stepper_b))
1622 range->layout->mouse_location = MOUSE_STEPPER_B;
1623 else if (POINT_IN_RECT (x, y, range->layout->stepper_c))
1624 range->layout->mouse_location = MOUSE_STEPPER_C;
1625 else if (POINT_IN_RECT (x, y, range->layout->stepper_d))
1626 range->layout->mouse_location = MOUSE_STEPPER_D;
1627 else if (POINT_IN_RECT (x, y, range->layout->slider))
1628 range->layout->mouse_location = MOUSE_SLIDER;
1629 else if (POINT_IN_RECT (x, y, range->layout->trough))
1630 range->layout->mouse_location = MOUSE_TROUGH;
1631 else if (POINT_IN_RECT (x, y, widget->allocation))
1632 range->layout->mouse_location = MOUSE_WIDGET;
1634 range->layout->mouse_location = MOUSE_OUTSIDE;
1636 return old != range->layout->mouse_location;
1639 /* Clamp rect, border inside widget->allocation, such that we prefer
1640 * to take space from border not rect in all directions, and prefer to
1641 * give space to border over rect in one direction.
1644 clamp_dimensions (GtkWidget *widget,
1647 gboolean border_expands_horizontally)
1649 gint extra, shortage;
1651 g_return_if_fail (rect->x == 0);
1652 g_return_if_fail (rect->y == 0);
1653 g_return_if_fail (rect->width >= 0);
1654 g_return_if_fail (rect->height >= 0);
1658 extra = widget->allocation.width - border->left - border->right - rect->width;
1661 if (border_expands_horizontally)
1663 border->left += extra / 2;
1664 border->right += extra / 2 + extra % 2;
1668 rect->width += extra;
1672 /* See if we can fit rect, if not kill the border */
1673 shortage = rect->width - widget->allocation.width;
1676 rect->width = widget->allocation.width;
1677 /* lose the border */
1683 /* See if we can fit rect with borders */
1684 shortage = rect->width + border->left + border->right -
1685 widget->allocation.width;
1688 /* Shrink borders */
1689 border->left -= shortage / 2;
1690 border->right -= shortage / 2 + shortage % 2;
1696 extra = widget->allocation.height - border->top - border->bottom - rect->height;
1699 if (border_expands_horizontally)
1701 /* don't expand border vertically */
1702 rect->height += extra;
1706 border->top += extra / 2;
1707 border->bottom += extra / 2 + extra % 2;
1711 /* See if we can fit rect, if not kill the border */
1712 shortage = rect->height - widget->allocation.height;
1715 rect->height = widget->allocation.height;
1716 /* lose the border */
1722 /* See if we can fit rect with borders */
1723 shortage = rect->height + border->top + border->bottom -
1724 widget->allocation.height;
1727 /* Shrink borders */
1728 border->top -= shortage / 2;
1729 border->bottom -= shortage / 2 + shortage % 2;
1735 gtk_range_calc_request (GtkRange *range,
1739 gint stepper_spacing,
1740 GdkRectangle *range_rect,
1743 gint *slider_length_p)
1753 if (GTK_RANGE_GET_CLASS (range)->get_range_border)
1754 (* GTK_RANGE_GET_CLASS (range)->get_range_border) (range, border);
1757 if (range->has_stepper_a)
1759 if (range->has_stepper_b)
1761 if (range->has_stepper_c)
1763 if (range->has_stepper_d)
1766 slider_length = range->min_slider_size;
1771 /* We never expand to fill available space in the small dimension
1772 * (i.e. vertical scrollbars are always a fixed width)
1774 if (range->orientation == GTK_ORIENTATION_VERTICAL)
1776 range_rect->width = trough_border * 2 + slider_width;
1777 range_rect->height = stepper_size * n_steppers + stepper_spacing * 2 + trough_border * 2 + slider_length;
1781 range_rect->width = stepper_size * n_steppers + stepper_spacing * 2 + trough_border * 2 + slider_length;
1782 range_rect->height = trough_border * 2 + slider_width;
1786 *n_steppers_p = n_steppers;
1788 if (slider_length_p)
1789 *slider_length_p = slider_length;
1793 gtk_range_calc_layout (GtkRange *range,
1794 gdouble adjustment_value)
1796 gint slider_width, stepper_size, trough_border, stepper_spacing;
1800 GdkRectangle range_rect;
1801 GtkRangeLayout *layout;
1804 if (!range->need_recalc)
1807 /* If we have a too-small allocation, we prefer the steppers over
1808 * the trough/slider, probably the steppers are a more useful
1809 * feature in small spaces.
1811 * Also, we prefer to draw the range itself rather than the border
1812 * areas if there's a conflict, since the borders will be decoration
1813 * not controls. Though this depends on subclasses cooperating by
1814 * not drawing on range->range_rect.
1817 widget = GTK_WIDGET (range);
1818 layout = range->layout;
1820 gtk_range_get_props (range,
1821 &slider_width, &stepper_size, &trough_border, &stepper_spacing);
1823 gtk_range_calc_request (range,
1824 slider_width, stepper_size, trough_border, stepper_spacing,
1825 &range_rect, &border, &n_steppers, &slider_length);
1827 /* We never expand to fill available space in the small dimension
1828 * (i.e. vertical scrollbars are always a fixed width)
1830 if (range->orientation == GTK_ORIENTATION_VERTICAL)
1832 clamp_dimensions (widget, &range_rect, &border, TRUE);
1836 clamp_dimensions (widget, &range_rect, &border, FALSE);
1839 range_rect.x = border.left;
1840 range_rect.y = border.top;
1842 range->range_rect = range_rect;
1844 if (range->orientation == GTK_ORIENTATION_VERTICAL)
1846 gint stepper_width, stepper_height;
1848 /* Steppers are the width of the range, and stepper_size in
1849 * height, or if we don't have enough height, divided equally
1850 * among available space.
1852 stepper_width = range_rect.width - trough_border * 2;
1854 if (stepper_width < 1)
1855 stepper_width = range_rect.width; /* screw the trough border */
1857 if (n_steppers == 0)
1858 stepper_height = 0; /* avoid divide by n_steppers */
1860 stepper_height = MIN (stepper_size, (range_rect.height / n_steppers));
1864 layout->stepper_a.x = range_rect.x + trough_border;
1865 layout->stepper_a.y = range_rect.y + trough_border;
1867 if (range->has_stepper_a)
1869 layout->stepper_a.width = stepper_width;
1870 layout->stepper_a.height = stepper_height;
1874 layout->stepper_a.width = 0;
1875 layout->stepper_a.height = 0;
1880 layout->stepper_b.x = layout->stepper_a.x;
1881 layout->stepper_b.y = layout->stepper_a.y + layout->stepper_a.height;
1883 if (range->has_stepper_b)
1885 layout->stepper_b.width = stepper_width;
1886 layout->stepper_b.height = stepper_height;
1890 layout->stepper_b.width = 0;
1891 layout->stepper_b.height = 0;
1896 if (range->has_stepper_d)
1898 layout->stepper_d.width = stepper_width;
1899 layout->stepper_d.height = stepper_height;
1903 layout->stepper_d.width = 0;
1904 layout->stepper_d.height = 0;
1907 layout->stepper_d.x = layout->stepper_a.x;
1908 layout->stepper_d.y = range_rect.y + range_rect.height - layout->stepper_d.height - trough_border;
1912 if (range->has_stepper_c)
1914 layout->stepper_c.width = stepper_width;
1915 layout->stepper_c.height = stepper_height;
1919 layout->stepper_c.width = 0;
1920 layout->stepper_c.height = 0;
1923 layout->stepper_c.x = layout->stepper_a.x;
1924 layout->stepper_c.y = layout->stepper_d.y - layout->stepper_c.height;
1926 /* Now the trough is the remaining space between steppers B and C,
1929 layout->trough.x = range_rect.x;
1930 layout->trough.y = layout->stepper_b.y + layout->stepper_b.height;
1931 layout->trough.width = range_rect.width;
1932 layout->trough.height = layout->stepper_c.y - (layout->stepper_b.y + layout->stepper_b.height);
1934 /* Slider fits into the trough, with stepper_spacing on either side,
1935 * and the size/position based on the adjustment or fixed, depending.
1937 layout->slider.x = layout->trough.x + trough_border;
1938 layout->slider.width = layout->trough.width - trough_border * 2;
1940 /* Compute slider position/length */
1942 gint y, bottom, top, height;
1944 top = layout->trough.y + stepper_spacing;
1945 bottom = layout->trough.y + layout->trough.height - stepper_spacing;
1947 /* slider height is the fraction (page_size /
1948 * total_adjustment_range) times the trough height in pixels
1950 height = ((bottom - top) * (range->adjustment->page_size /
1951 (range->adjustment->upper - range->adjustment->lower)));
1953 if (height < range->min_slider_size ||
1954 range->slider_size_fixed)
1955 height = range->min_slider_size;
1957 height = MIN (height, (layout->trough.height - stepper_spacing * 2));
1961 if (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size != 0)
1962 y += (bottom - top - height) * ((adjustment_value - range->adjustment->lower) /
1963 (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size));
1965 y = CLAMP (y, top, bottom);
1967 if (should_invert (range))
1968 y = bottom - (y - top + height);
1970 layout->slider.y = y;
1971 layout->slider.height = height;
1973 /* These are publically exported */
1974 range->slider_start = layout->slider.y;
1975 range->slider_end = layout->slider.y + layout->slider.height;
1980 gint stepper_width, stepper_height;
1982 /* Steppers are the height of the range, and stepper_size in
1983 * width, or if we don't have enough width, divided equally
1984 * among available space.
1986 stepper_height = range_rect.height - trough_border * 2;
1988 if (stepper_height < 1)
1989 stepper_height = range_rect.height; /* screw the trough border */
1991 if (n_steppers == 0)
1992 stepper_width = 0; /* avoid divide by n_steppers */
1994 stepper_width = MIN (stepper_size, (range_rect.width / n_steppers));
1998 layout->stepper_a.x = range_rect.x + trough_border;
1999 layout->stepper_a.y = range_rect.y + trough_border;
2001 if (range->has_stepper_a)
2003 layout->stepper_a.width = stepper_width;
2004 layout->stepper_a.height = stepper_height;
2008 layout->stepper_a.width = 0;
2009 layout->stepper_a.height = 0;
2014 layout->stepper_b.x = layout->stepper_a.x + layout->stepper_a.width;
2015 layout->stepper_b.y = layout->stepper_a.y;
2017 if (range->has_stepper_b)
2019 layout->stepper_b.width = stepper_width;
2020 layout->stepper_b.height = stepper_height;
2024 layout->stepper_b.width = 0;
2025 layout->stepper_b.height = 0;
2030 if (range->has_stepper_d)
2032 layout->stepper_d.width = stepper_width;
2033 layout->stepper_d.height = stepper_height;
2037 layout->stepper_d.width = 0;
2038 layout->stepper_d.height = 0;
2041 layout->stepper_d.x = range_rect.x + range_rect.width - layout->stepper_d.width - trough_border;
2042 layout->stepper_d.y = layout->stepper_a.y;
2047 if (range->has_stepper_c)
2049 layout->stepper_c.width = stepper_width;
2050 layout->stepper_c.height = stepper_height;
2054 layout->stepper_c.width = 0;
2055 layout->stepper_c.height = 0;
2058 layout->stepper_c.x = layout->stepper_d.x - layout->stepper_c.width;
2059 layout->stepper_c.y = layout->stepper_a.y;
2061 /* Now the trough is the remaining space between steppers B and C,
2064 layout->trough.x = layout->stepper_b.x + layout->stepper_b.width;
2065 layout->trough.y = range_rect.y;
2067 layout->trough.width = layout->stepper_c.x - (layout->stepper_b.x + layout->stepper_b.width);
2068 layout->trough.height = range_rect.height;
2070 /* Slider fits into the trough, with stepper_spacing on either side,
2071 * and the size/position based on the adjustment or fixed, depending.
2073 layout->slider.y = layout->trough.y + trough_border;
2074 layout->slider.height = layout->trough.height - trough_border * 2;
2076 /* Compute slider position/length */
2078 gint x, left, right, width;
2080 left = layout->trough.x + stepper_spacing;
2081 right = layout->trough.x + layout->trough.width - stepper_spacing;
2083 /* slider width is the fraction (page_size /
2084 * total_adjustment_range) times the trough width in pixels
2086 width = ((right - left) * (range->adjustment->page_size /
2087 (range->adjustment->upper - range->adjustment->lower)));
2089 if (width < range->min_slider_size ||
2090 range->slider_size_fixed)
2091 width = range->min_slider_size;
2093 width = MIN (width, (layout->trough.width - stepper_spacing * 2));
2097 x += (right - left - width) * ((adjustment_value - range->adjustment->lower) /
2098 (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size));
2100 x = CLAMP (x, left, right);
2102 if (should_invert (range))
2103 x = right - (x - left + width);
2105 layout->slider.x = x;
2106 layout->slider.width = width;
2108 /* These are publically exported */
2109 range->slider_start = layout->slider.x;
2110 range->slider_end = layout->slider.x + layout->slider.width;
2114 gtk_range_update_mouse_location (range);
2117 static GdkRectangle*
2118 get_area (GtkRange *range,
2119 MouseLocation location)
2123 case MOUSE_STEPPER_A:
2124 return &range->layout->stepper_a;
2125 case MOUSE_STEPPER_B:
2126 return &range->layout->stepper_b;
2127 case MOUSE_STEPPER_C:
2128 return &range->layout->stepper_c;
2129 case MOUSE_STEPPER_D:
2130 return &range->layout->stepper_d;
2132 return &range->layout->trough;
2134 return &range->layout->slider;
2140 g_warning (G_STRLOC": bug");
2145 gtk_range_internal_set_value (GtkRange *range,
2148 value = CLAMP (value, range->adjustment->lower,
2149 (range->adjustment->upper - range->adjustment->page_size));
2151 if (range->round_digits >= 0)
2155 /* This is just so darn lame. */
2156 g_snprintf (buffer, 128, "%0.*f",
2157 range->round_digits, value);
2158 sscanf (buffer, "%lf", &value);
2161 if (range->adjustment->value != value)
2163 range->need_recalc = TRUE;
2165 gtk_widget_queue_draw (GTK_WIDGET (range));
2167 switch (range->update_policy)
2169 case GTK_UPDATE_CONTINUOUS:
2170 gtk_adjustment_set_value (range->adjustment, value);
2173 /* Delayed means we update after a period of inactivity */
2174 case GTK_UPDATE_DELAYED:
2175 gtk_range_reset_update_timer (range);
2178 /* Discontinuous means we update on button release */
2179 case GTK_UPDATE_DISCONTINUOUS:
2180 /* don't emit value_changed signal */
2181 range->adjustment->value = value;
2182 range->update_pending = TRUE;
2189 gtk_range_update_value (GtkRange *range)
2191 gtk_range_remove_update_timer (range);
2193 if (range->update_pending)
2195 gtk_adjustment_value_changed (range->adjustment);
2197 range->update_pending = FALSE;
2201 struct _GtkRangeStepTimer
2208 second_timeout (gpointer data)
2212 GDK_THREADS_ENTER ();
2213 range = GTK_RANGE (data);
2214 gtk_range_scroll (range, range->timer->step);
2215 GDK_THREADS_LEAVE ();
2221 initial_timeout (gpointer data)
2225 GDK_THREADS_ENTER ();
2226 range = GTK_RANGE (data);
2227 range->timer->timeout_id =
2228 g_timeout_add (SCROLL_LATER_DELAY,
2231 GDK_THREADS_LEAVE ();
2238 gtk_range_add_step_timer (GtkRange *range,
2241 g_return_if_fail (range->timer == NULL);
2242 g_return_if_fail (step != GTK_SCROLL_NONE);
2244 range->timer = g_new (GtkRangeStepTimer, 1);
2246 range->timer->timeout_id =
2247 g_timeout_add (SCROLL_INITIAL_DELAY,
2250 range->timer->step = step;
2254 gtk_range_remove_step_timer (GtkRange *range)
2258 if (range->timer->timeout_id != 0)
2259 g_source_remove (range->timer->timeout_id);
2261 g_free (range->timer);
2263 range->timer = NULL;
2268 update_timeout (gpointer data)
2272 GDK_THREADS_ENTER ();
2273 range = GTK_RANGE (data);
2274 gtk_range_update_value (range);
2275 range->update_timeout_id = 0;
2276 GDK_THREADS_LEAVE ();
2283 gtk_range_reset_update_timer (GtkRange *range)
2285 gtk_range_remove_update_timer (range);
2287 range->update_timeout_id = g_timeout_add (UPDATE_DELAY,
2293 gtk_range_remove_update_timer (GtkRange *range)
2295 if (range->update_timeout_id != 0)
2297 g_source_remove (range->update_timeout_id);
2298 range->update_timeout_id = 0;