1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 * Modified by the GTK+ Team and others 1997-1999. See the AUTHORS
22 * file for a list of people on the GTK+ Team. See the ChangeLog
23 * files for a list of changes. These files are distributed with
24 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
30 #include "gtksignal.h"
33 #define SCROLL_TIMER_LENGTH 20
34 #define SCROLL_INITIAL_DELAY 100
35 #define SCROLL_DELAY_LENGTH 300
37 #define RANGE_CLASS(w) GTK_RANGE_CLASS (GTK_OBJECT (w)->klass)
44 static void gtk_range_class_init (GtkRangeClass *klass);
45 static void gtk_range_init (GtkRange *range);
46 static void gtk_range_set_arg (GtkObject *object,
49 static void gtk_range_get_arg (GtkObject *object,
52 static void gtk_range_destroy (GtkObject *object);
53 static void gtk_range_finalize (GtkObject *object);
54 static void gtk_range_draw (GtkWidget *widget,
56 static void gtk_range_draw_focus (GtkWidget *widget);
57 static void gtk_range_unrealize (GtkWidget *widget);
58 static gint gtk_range_expose (GtkWidget *widget,
59 GdkEventExpose *event);
60 static gint gtk_range_button_press (GtkWidget *widget,
61 GdkEventButton *event);
62 static gint gtk_range_button_release (GtkWidget *widget,
63 GdkEventButton *event);
64 static gint gtk_range_motion_notify (GtkWidget *widget,
65 GdkEventMotion *event);
66 static gint gtk_range_key_press (GtkWidget *widget,
68 static gint gtk_range_enter_notify (GtkWidget *widget,
69 GdkEventCrossing *event);
70 static gint gtk_range_leave_notify (GtkWidget *widget,
71 GdkEventCrossing *event);
72 static gint gtk_range_focus_in (GtkWidget *widget,
73 GdkEventFocus *event);
74 static gint gtk_range_focus_out (GtkWidget *widget,
75 GdkEventFocus *event);
76 static gint gtk_range_scroll_event (GtkWidget *widget,
77 GdkEventScroll *event);
78 static void gtk_range_style_set (GtkWidget *widget,
79 GtkStyle *previous_style);
81 static void gtk_real_range_draw_trough (GtkRange *range);
82 static void gtk_real_range_draw_slider (GtkRange *range);
83 static gint gtk_real_range_timer (GtkRange *range);
84 static gint gtk_range_scroll (GtkRange *range,
87 static void gtk_range_add_timer (GtkRange *range);
88 static void gtk_range_remove_timer (GtkRange *range);
90 static void gtk_range_adjustment_changed (GtkAdjustment *adjustment,
92 static void gtk_range_adjustment_value_changed (GtkAdjustment *adjustment,
95 static void gtk_range_trough_hdims (GtkRange *range,
98 static void gtk_range_trough_vdims (GtkRange *range,
102 static GtkWidgetClass *parent_class = NULL;
106 gtk_range_get_type (void)
108 static GtkType range_type = 0;
112 static const GtkTypeInfo range_info =
116 sizeof (GtkRangeClass),
117 (GtkClassInitFunc) gtk_range_class_init,
118 (GtkObjectInitFunc) gtk_range_init,
119 /* reserved_1 */ NULL,
120 /* reserved_2 */ NULL,
121 (GtkClassInitFunc) NULL,
124 range_type = gtk_type_unique (GTK_TYPE_WIDGET, &range_info);
131 gtk_range_class_init (GtkRangeClass *class)
133 GtkObjectClass *object_class;
134 GtkWidgetClass *widget_class;
136 object_class = (GtkObjectClass*) class;
137 widget_class = (GtkWidgetClass*) class;
139 parent_class = gtk_type_class (GTK_TYPE_WIDGET);
141 gtk_object_add_arg_type ("GtkRange::update_policy",
142 GTK_TYPE_UPDATE_TYPE,
146 object_class->set_arg = gtk_range_set_arg;
147 object_class->get_arg = gtk_range_get_arg;
148 object_class->destroy = gtk_range_destroy;
149 object_class->finalize = gtk_range_finalize;
151 widget_class->draw = gtk_range_draw;
152 widget_class->draw_focus = gtk_range_draw_focus;
153 widget_class->unrealize = gtk_range_unrealize;
154 widget_class->expose_event = gtk_range_expose;
155 widget_class->button_press_event = gtk_range_button_press;
156 widget_class->button_release_event = gtk_range_button_release;
157 widget_class->motion_notify_event = gtk_range_motion_notify;
158 widget_class->scroll_event = gtk_range_scroll_event;
159 widget_class->key_press_event = gtk_range_key_press;
160 widget_class->enter_notify_event = gtk_range_enter_notify;
161 widget_class->leave_notify_event = gtk_range_leave_notify;
162 widget_class->focus_in_event = gtk_range_focus_in;
163 widget_class->focus_out_event = gtk_range_focus_out;
164 widget_class->style_set = gtk_range_style_set;
166 class->slider_width = 11;
167 class->stepper_size = 11;
168 class->stepper_slider_spacing = 1;
169 class->min_slider_size = 7;
172 class->step_forw = 3;
173 class->step_back = 4;
174 class->draw_background = NULL;
175 class->clear_background = NULL;
176 class->draw_trough = gtk_real_range_draw_trough;
177 class->draw_slider = gtk_real_range_draw_slider;
178 class->draw_step_forw = NULL;
179 class->draw_step_back = NULL;
180 class->trough_click = NULL;
181 class->trough_keys = NULL;
182 class->motion = NULL;
183 class->timer = gtk_real_range_timer;
187 gtk_range_set_arg (GtkObject *object,
193 range = GTK_RANGE (object);
197 case ARG_UPDATE_POLICY:
198 gtk_range_set_update_policy (range, GTK_VALUE_ENUM (*arg));
206 gtk_range_get_arg (GtkObject *object,
212 range = GTK_RANGE (object);
216 case ARG_UPDATE_POLICY:
217 GTK_VALUE_ENUM (*arg) = range->policy;
220 arg->type = GTK_TYPE_INVALID;
226 gtk_range_init (GtkRange *range)
228 range->trough = NULL;
229 range->slider = NULL;
230 range->step_forw = NULL;
231 range->step_back = NULL;
233 range->x_click_point = 0;
234 range->y_click_point = 0;
237 range->policy = GTK_UPDATE_CONTINUOUS;
238 range->scroll_type = GTK_SCROLL_NONE;
240 range->click_child = 0;
241 range->need_timer = FALSE;
243 range->old_value = 0.0;
244 range->old_lower = 0.0;
245 range->old_upper = 0.0;
246 range->old_page_size = 0.0;
247 range->adjustment = NULL;
251 gtk_range_get_adjustment (GtkRange *range)
253 g_return_val_if_fail (range != NULL, NULL);
254 g_return_val_if_fail (GTK_IS_RANGE (range), NULL);
256 return range->adjustment;
260 gtk_range_set_update_policy (GtkRange *range,
261 GtkUpdateType policy)
263 g_return_if_fail (range != NULL);
264 g_return_if_fail (GTK_IS_RANGE (range));
266 range->policy = policy;
270 gtk_range_set_adjustment (GtkRange *range,
271 GtkAdjustment *adjustment)
273 g_return_if_fail (range != NULL);
274 g_return_if_fail (GTK_IS_RANGE (range));
277 adjustment = (GtkAdjustment*) gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0);
279 g_return_if_fail (GTK_IS_ADJUSTMENT (adjustment));
281 if (range->adjustment != adjustment)
283 if (range->adjustment)
285 gtk_signal_disconnect_by_data (GTK_OBJECT (range->adjustment),
287 gtk_object_unref (GTK_OBJECT (range->adjustment));
290 range->adjustment = adjustment;
291 gtk_object_ref (GTK_OBJECT (adjustment));
292 gtk_object_sink (GTK_OBJECT (adjustment));
294 gtk_signal_connect (GTK_OBJECT (adjustment), "changed",
295 (GtkSignalFunc) gtk_range_adjustment_changed,
297 gtk_signal_connect (GTK_OBJECT (adjustment), "value_changed",
298 (GtkSignalFunc) gtk_range_adjustment_value_changed,
301 range->old_value = adjustment->value;
302 range->old_lower = adjustment->lower;
303 range->old_upper = adjustment->upper;
304 range->old_page_size = adjustment->page_size;
306 gtk_range_adjustment_changed (adjustment, (gpointer) range);
311 gtk_range_draw_background (GtkRange *range)
313 g_return_if_fail (range != NULL);
314 g_return_if_fail (GTK_IS_RANGE (range));
316 if (range->trough && RANGE_CLASS (range)->draw_background)
317 (* RANGE_CLASS (range)->draw_background) (range);
321 gtk_range_clear_background (GtkRange *range)
323 g_return_if_fail (range != NULL);
324 g_return_if_fail (GTK_IS_RANGE (range));
326 if (range->trough && RANGE_CLASS (range)->clear_background)
327 (* RANGE_CLASS (range)->clear_background) (range);
331 gtk_range_draw_trough (GtkRange *range)
333 g_return_if_fail (range != NULL);
334 g_return_if_fail (GTK_IS_RANGE (range));
336 if (range->trough && RANGE_CLASS (range)->draw_trough)
337 (* RANGE_CLASS (range)->draw_trough) (range);
341 gtk_range_draw_slider (GtkRange *range)
343 g_return_if_fail (range != NULL);
344 g_return_if_fail (GTK_IS_RANGE (range));
346 if (range->slider && RANGE_CLASS (range)->draw_slider)
347 (* RANGE_CLASS (range)->draw_slider) (range);
351 gtk_range_draw_step_forw (GtkRange *range)
353 g_return_if_fail (range != NULL);
354 g_return_if_fail (GTK_IS_RANGE (range));
356 if (range->step_forw && RANGE_CLASS (range)->draw_step_forw)
357 (* RANGE_CLASS (range)->draw_step_forw) (range);
361 gtk_range_draw_step_back (GtkRange *range)
363 g_return_if_fail (range != NULL);
364 g_return_if_fail (GTK_IS_RANGE (range));
366 if (range->step_back && RANGE_CLASS (range)->draw_step_back)
367 (* RANGE_CLASS (range)->draw_step_back) (range);
371 gtk_range_slider_update (GtkRange *range)
373 g_return_if_fail (range != NULL);
374 g_return_if_fail (GTK_IS_RANGE (range));
376 if (RANGE_CLASS (range)->slider_update)
377 (* RANGE_CLASS (range)->slider_update) (range);
381 gtk_range_trough_click (GtkRange *range,
386 g_return_val_if_fail (range != NULL, GTK_TROUGH_NONE);
387 g_return_val_if_fail (GTK_IS_RANGE (range), GTK_TROUGH_NONE);
389 if (RANGE_CLASS (range)->trough_click)
390 return (* RANGE_CLASS (range)->trough_click) (range, x, y, jump_perc);
392 return GTK_TROUGH_NONE;
396 gtk_range_default_hslider_update (GtkRange *range)
402 g_return_if_fail (range != NULL);
403 g_return_if_fail (GTK_IS_RANGE (range));
405 if (GTK_WIDGET_REALIZED (range))
407 gtk_range_trough_hdims (range, &left, &right);
410 if (range->adjustment->value < range->adjustment->lower)
412 range->adjustment->value = range->adjustment->lower;
413 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
415 else if (range->adjustment->value > range->adjustment->upper)
417 range->adjustment->value = range->adjustment->upper;
418 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
421 if (range->adjustment->lower != (range->adjustment->upper - range->adjustment->page_size))
422 x += ((right - left) * (range->adjustment->value - range->adjustment->lower) /
423 (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size));
430 gdk_window_move (range->slider, x, GTK_WIDGET (range)->style->klass->ythickness);
435 gtk_range_default_vslider_update (GtkRange *range)
441 g_return_if_fail (range != NULL);
442 g_return_if_fail (GTK_IS_RANGE (range));
444 if (GTK_WIDGET_REALIZED (range))
446 gtk_range_trough_vdims (range, &top, &bottom);
449 if (range->adjustment->value < range->adjustment->lower)
451 range->adjustment->value = range->adjustment->lower;
452 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
454 else if (range->adjustment->value > range->adjustment->upper)
456 range->adjustment->value = range->adjustment->upper;
457 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
460 if (range->adjustment->lower != (range->adjustment->upper - range->adjustment->page_size))
461 y += ((bottom - top) * (range->adjustment->value - range->adjustment->lower) /
462 (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size));
469 gdk_window_move (range->slider, GTK_WIDGET (range)->style->klass->xthickness, y);
474 gtk_range_default_htrough_click (GtkRange *range,
486 g_return_val_if_fail (range != NULL, GTK_TROUGH_NONE);
487 g_return_val_if_fail (GTK_IS_RANGE (range), GTK_TROUGH_NONE);
489 ythickness = GTK_WIDGET (range)->style->klass->ythickness;
491 gtk_range_trough_hdims (range, &left, &right);
492 gdk_window_get_size (range->slider, &slider_length, NULL);
493 right += slider_length;
495 if ((x > left) && (y > ythickness))
497 gdk_window_get_size (range->trough, &trough_width, &trough_height);
499 if ((x < right) && (y < (trough_height - ythickness)))
503 *jump_perc = ((gdouble) (x - left)) / ((gdouble) (right - left));
504 return GTK_TROUGH_JUMP;
507 gdk_window_get_position (range->slider, &slider_x, NULL);
510 return GTK_TROUGH_START;
512 return GTK_TROUGH_END;
516 return GTK_TROUGH_NONE;
520 gtk_range_default_vtrough_click (GtkRange *range,
532 g_return_val_if_fail (range != NULL, GTK_TROUGH_NONE);
533 g_return_val_if_fail (GTK_IS_RANGE (range), GTK_TROUGH_NONE);
535 xthickness = GTK_WIDGET (range)->style->klass->xthickness;
537 gtk_range_trough_vdims (range, &top, &bottom);
538 gdk_window_get_size (range->slider, NULL, &slider_length);
539 bottom += slider_length;
541 if ((x > xthickness) && (y > top))
543 gdk_window_get_size (range->trough, &trough_width, &trough_height);
545 if ((x < (trough_width - xthickness) && (y < bottom)))
549 *jump_perc = ((gdouble) (y - top)) / ((gdouble) (bottom - top));
551 return GTK_TROUGH_JUMP;
554 gdk_window_get_position (range->slider, NULL, &slider_y);
557 return GTK_TROUGH_START;
559 return GTK_TROUGH_END;
563 return GTK_TROUGH_NONE;
567 gtk_range_default_hmotion (GtkRange *range,
573 gint slider_x, slider_y;
576 g_return_if_fail (range != NULL);
577 g_return_if_fail (GTK_IS_RANGE (range));
579 range = GTK_RANGE (range);
581 gdk_window_get_position (range->slider, &slider_x, &slider_y);
582 gtk_range_trough_hdims (range, &left, &right);
587 new_pos = slider_x + xdelta;
591 else if (new_pos > right)
594 old_value = range->adjustment->value;
595 range->adjustment->value = ((range->adjustment->upper -
596 range->adjustment->lower -
597 range->adjustment->page_size) *
598 (new_pos - left) / (right - left) +
599 range->adjustment->lower);
601 if (range->digits >= 0)
605 sprintf (buffer, "%0.*f", range->digits, range->adjustment->value);
606 sscanf (buffer, "%f", &range->adjustment->value);
609 if (old_value != range->adjustment->value)
611 if (range->policy == GTK_UPDATE_CONTINUOUS)
613 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
617 gtk_range_slider_update (range);
618 gtk_range_clear_background (range);
620 if (range->policy == GTK_UPDATE_DELAYED)
622 gtk_range_remove_timer (range);
623 range->timer = gtk_timeout_add (SCROLL_DELAY_LENGTH,
624 (GtkFunction) RANGE_CLASS (range)->timer,
632 gtk_range_default_vmotion (GtkRange *range,
638 gint slider_x, slider_y;
641 g_return_if_fail (range != NULL);
642 g_return_if_fail (GTK_IS_RANGE (range));
644 range = GTK_RANGE (range);
646 gdk_window_get_position (range->slider, &slider_x, &slider_y);
647 gtk_range_trough_vdims (range, &top, &bottom);
652 new_pos = slider_y + ydelta;
656 else if (new_pos > bottom)
659 old_value = range->adjustment->value;
660 range->adjustment->value = ((range->adjustment->upper -
661 range->adjustment->lower -
662 range->adjustment->page_size) *
663 (new_pos - top) / (bottom - top) +
664 range->adjustment->lower);
666 if (range->digits >= 0)
670 sprintf (buffer, "%0.*f", range->digits, range->adjustment->value);
671 sscanf (buffer, "%f", &range->adjustment->value);
674 if (old_value != range->adjustment->value)
676 if (range->policy == GTK_UPDATE_CONTINUOUS)
678 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
682 gtk_range_slider_update (range);
683 gtk_range_clear_background (range);
685 if (range->policy == GTK_UPDATE_DELAYED)
687 gtk_range_remove_timer (range);
688 range->timer = gtk_timeout_add (SCROLL_DELAY_LENGTH,
689 (GtkFunction) RANGE_CLASS (range)->timer,
698 gtk_range_destroy (GtkObject *object)
702 g_return_if_fail (object != NULL);
703 g_return_if_fail (GTK_IS_RANGE (object));
705 range = GTK_RANGE (object);
707 if (range->adjustment)
708 gtk_signal_disconnect_by_data (GTK_OBJECT (range->adjustment),
711 (* GTK_OBJECT_CLASS (parent_class)->destroy) (object);
715 gtk_range_finalize (GtkObject *object)
719 g_return_if_fail (object != NULL);
720 g_return_if_fail (GTK_IS_RANGE (object));
722 range = GTK_RANGE (object);
724 if (range->adjustment)
725 gtk_object_unref (GTK_OBJECT (range->adjustment));
727 (* GTK_OBJECT_CLASS (parent_class)->finalize) (object);
731 gtk_range_draw (GtkWidget *widget,
736 g_return_if_fail (widget != NULL);
737 g_return_if_fail (GTK_IS_RANGE (widget));
738 g_return_if_fail (area != NULL);
740 if (GTK_WIDGET_VISIBLE (widget) && GTK_WIDGET_MAPPED (widget))
742 range = GTK_RANGE (widget);
744 gtk_range_draw_background (range);
745 gtk_range_draw_trough (range);
746 gtk_range_draw_slider (range);
747 gtk_range_draw_step_forw (range);
748 gtk_range_draw_step_back (range);
753 gtk_range_draw_focus (GtkWidget *widget)
755 g_return_if_fail (widget != NULL);
756 g_return_if_fail (GTK_IS_RANGE (widget));
758 if (GTK_WIDGET_DRAWABLE (widget))
759 gtk_range_draw_trough (GTK_RANGE (widget));
763 gtk_range_unrealize (GtkWidget *widget)
767 g_return_if_fail (widget != NULL);
768 g_return_if_fail (GTK_IS_RANGE (widget));
770 range = GTK_RANGE (widget);
774 gdk_window_set_user_data (range->slider, NULL);
775 gdk_window_destroy (range->slider);
776 range->slider = NULL;
780 gdk_window_set_user_data (range->trough, NULL);
781 gdk_window_destroy (range->trough);
782 range->trough = NULL;
784 if (range->step_forw)
786 gdk_window_set_user_data (range->step_forw, NULL);
787 gdk_window_destroy (range->step_forw);
788 range->step_forw = NULL;
790 if (range->step_back)
792 gdk_window_set_user_data (range->step_back, NULL);
793 gdk_window_destroy (range->step_back);
794 range->step_back = NULL;
797 if (GTK_WIDGET_CLASS (parent_class)->unrealize)
798 (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
802 gtk_range_expose (GtkWidget *widget,
803 GdkEventExpose *event)
807 g_return_val_if_fail (widget != NULL, FALSE);
808 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
809 g_return_val_if_fail (event != NULL, FALSE);
811 range = GTK_RANGE (widget);
813 if (event->window == range->trough)
815 /* Don't redraw if we are only exposing the literal trough region.
816 * this may not work correctly if someone overrides the default
817 * trough-drawing handler. (Probably should really pass another
818 * argument - the redrawn area to all the drawing functions)
820 gint xt = widget->style->klass->xthickness;
821 gint yt = widget->style->klass->ythickness;
823 if (!((event->area.x >= xt) &&
824 (event->area.y >= yt) &&
825 (event->area.x + event->area.width <=
826 widget->allocation.width - xt) &&
827 (event->area.y + event->area.height <=
828 widget->allocation.height - yt)))
829 gtk_range_draw_trough (range);
831 else if (event->window == widget->window)
833 gtk_range_draw_background (range);
835 else if (event->window == range->slider)
837 gtk_range_draw_slider (range);
839 else if (event->window == range->step_forw)
841 gtk_range_draw_step_forw (range);
843 else if (event->window == range->step_back)
845 gtk_range_draw_step_back (range);
851 gtk_range_button_press (GtkWidget *widget,
852 GdkEventButton *event)
858 g_return_val_if_fail (widget != NULL, FALSE);
859 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
860 g_return_val_if_fail (event != NULL, FALSE);
862 if (!GTK_WIDGET_HAS_FOCUS (widget))
863 gtk_widget_grab_focus (widget);
866 range = GTK_RANGE (widget);
867 if (range->button == 0)
869 gtk_grab_add (widget);
871 range->button = event->button;
872 range->x_click_point = event->x;
873 range->y_click_point = event->y;
875 if (event->window == range->trough)
877 range->click_child = RANGE_CLASS (range)->trough;
879 if (range->button == 2)
880 trough_part = gtk_range_trough_click (range, event->x, event->y, &jump_perc);
882 trough_part = gtk_range_trough_click (range, event->x, event->y, NULL);
884 range->scroll_type = GTK_SCROLL_NONE;
885 if (trough_part == GTK_TROUGH_START)
886 range->scroll_type = GTK_SCROLL_PAGE_BACKWARD;
887 else if (trough_part == GTK_TROUGH_END)
888 range->scroll_type = GTK_SCROLL_PAGE_FORWARD;
889 else if (trough_part == GTK_TROUGH_JUMP &&
890 jump_perc >= 0 && jump_perc <= 1)
891 range->scroll_type = GTK_SCROLL_JUMP;
893 if (range->scroll_type != GTK_SCROLL_NONE)
895 gtk_range_scroll (range, jump_perc);
896 gtk_range_add_timer (range);
899 else if (event->window == range->slider)
901 range->click_child = RANGE_CLASS (range)->slider;
902 range->scroll_type = GTK_SCROLL_NONE;
904 else if (event->window == range->step_forw)
906 range->click_child = RANGE_CLASS (range)->step_forw;
907 range->scroll_type = GTK_SCROLL_STEP_FORWARD;
909 gtk_range_scroll (range, -1);
910 gtk_range_add_timer (range);
911 gtk_range_draw_step_forw (range);
913 else if (event->window == range->step_back)
915 range->click_child = RANGE_CLASS (range)->step_back;
916 range->scroll_type = GTK_SCROLL_STEP_BACKWARD;
918 gtk_range_scroll (range, -1);
919 gtk_range_add_timer (range);
920 gtk_range_draw_step_back (range);
928 gtk_range_button_release (GtkWidget *widget,
929 GdkEventButton *event)
933 g_return_val_if_fail (widget != NULL, FALSE);
934 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
935 g_return_val_if_fail (event != NULL, FALSE);
937 range = GTK_RANGE (widget);
939 if (range->button == event->button)
941 gtk_grab_remove (widget);
944 range->x_click_point = -1;
945 range->y_click_point = -1;
947 if (range->click_child == RANGE_CLASS (range)->slider)
949 if (range->policy == GTK_UPDATE_DELAYED)
950 gtk_range_remove_timer (range);
952 if ((range->policy != GTK_UPDATE_CONTINUOUS) &&
953 (range->old_value != range->adjustment->value))
954 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
956 else if ((range->click_child == RANGE_CLASS (range)->trough) ||
957 (range->click_child == RANGE_CLASS (range)->step_forw) ||
958 (range->click_child == RANGE_CLASS (range)->step_back))
960 gtk_range_remove_timer (range);
962 if ((range->policy != GTK_UPDATE_CONTINUOUS) &&
963 (range->old_value != range->adjustment->value))
964 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
966 if (range->click_child == RANGE_CLASS (range)->step_forw)
968 range->click_child = 0;
969 gtk_range_draw_step_forw (range);
971 else if (range->click_child == RANGE_CLASS (range)->step_back)
973 range->click_child = 0;
974 gtk_range_draw_step_back (range);
978 range->click_child = 0;
985 gtk_range_scroll_event (GtkWidget *widget,
986 GdkEventScroll *event)
990 g_return_val_if_fail (widget != NULL, FALSE);
991 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
992 g_return_val_if_fail (event != NULL, FALSE);
994 range = GTK_RANGE (widget);
996 if (GTK_WIDGET_VISIBLE (range)) {
997 GtkAdjustment *adj = GTK_RANGE (range)->adjustment;
998 gfloat new_value = adj->value + ((event->direction == GDK_SCROLL_UP) ?
999 -adj->page_increment / 2:
1000 adj->page_increment / 2);
1001 new_value = CLAMP (new_value, adj->lower, adj->upper - adj->page_size);
1002 gtk_adjustment_set_value (adj, new_value);
1009 gtk_range_motion_notify (GtkWidget *widget,
1010 GdkEventMotion *event)
1013 GdkModifierType mods;
1016 g_return_val_if_fail (widget != NULL, FALSE);
1017 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1018 g_return_val_if_fail (event != NULL, FALSE);
1020 range = GTK_RANGE (widget);
1022 if (range->click_child == RANGE_CLASS (range)->slider)
1027 if (event->is_hint || (event->window != range->slider))
1028 gdk_window_get_pointer (range->slider, &x, &y, &mods);
1030 mods = event->state;
1032 switch (range->button)
1035 mask = GDK_BUTTON1_MASK;
1038 mask = GDK_BUTTON2_MASK;
1041 mask = GDK_BUTTON3_MASK;
1050 if (RANGE_CLASS (range)->motion)
1051 (* RANGE_CLASS (range)->motion) (range, x - range->x_click_point, y - range->y_click_point);
1059 gtk_range_key_press (GtkWidget *widget,
1064 GtkScrollType scroll = GTK_SCROLL_NONE;
1065 GtkTroughType pos = GTK_TROUGH_NONE;
1067 g_return_val_if_fail (widget != NULL, FALSE);
1068 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1069 g_return_val_if_fail (event != NULL, FALSE);
1071 range = GTK_RANGE (widget);
1074 if (RANGE_CLASS (range)->trough_keys)
1075 return_val = (* RANGE_CLASS (range)->trough_keys) (range, event, &scroll, &pos);
1079 if (scroll != GTK_SCROLL_NONE)
1081 range->scroll_type = scroll;
1082 gtk_range_scroll (range, -1);
1083 if (range->old_value != range->adjustment->value)
1085 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
1086 switch (range->scroll_type)
1088 case GTK_SCROLL_STEP_BACKWARD:
1089 gtk_range_draw_step_back (range);
1091 case GTK_SCROLL_STEP_FORWARD:
1092 gtk_range_draw_step_forw (range);
1097 if (pos != GTK_TROUGH_NONE)
1099 if (pos == GTK_TROUGH_START)
1100 range->adjustment->value = range->adjustment->lower;
1101 else if (pos == GTK_TROUGH_END)
1102 range->adjustment->value =
1103 range->adjustment->upper - range->adjustment->page_size;
1105 if (range->old_value != range->adjustment->value)
1107 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment),
1110 gtk_range_slider_update (range);
1111 gtk_range_clear_background (range);
1119 gtk_range_enter_notify (GtkWidget *widget,
1120 GdkEventCrossing *event)
1124 g_return_val_if_fail (widget != NULL, FALSE);
1125 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1126 g_return_val_if_fail (event != NULL, FALSE);
1128 range = GTK_RANGE (widget);
1130 if (event->window == range->trough)
1132 range->in_child = RANGE_CLASS (range)->trough;
1134 else if (event->window == range->slider)
1136 range->in_child = RANGE_CLASS (range)->slider;
1138 if ((range->click_child == 0) ||
1139 (range->click_child == RANGE_CLASS (range)->trough))
1140 gtk_range_draw_slider (range);
1142 else if (event->window == range->step_forw)
1144 range->in_child = RANGE_CLASS (range)->step_forw;
1146 if ((range->click_child == 0) ||
1147 (range->click_child == RANGE_CLASS (range)->trough))
1148 gtk_range_draw_step_forw (range);
1150 else if (event->window == range->step_back)
1152 range->in_child = RANGE_CLASS (range)->step_back;
1154 if ((range->click_child == 0) ||
1155 (range->click_child == RANGE_CLASS (range)->trough))
1156 gtk_range_draw_step_back (range);
1163 gtk_range_leave_notify (GtkWidget *widget,
1164 GdkEventCrossing *event)
1168 g_return_val_if_fail (widget != NULL, FALSE);
1169 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1170 g_return_val_if_fail (event != NULL, FALSE);
1172 range = GTK_RANGE (widget);
1174 range->in_child = 0;
1176 if (event->window == range->trough)
1179 else if (event->window == range->slider)
1181 if ((range->click_child == 0) ||
1182 (range->click_child == RANGE_CLASS (range)->trough))
1183 gtk_range_draw_slider (range);
1185 else if (event->window == range->step_forw)
1187 if ((range->click_child == 0) ||
1188 (range->click_child == RANGE_CLASS (range)->trough))
1189 gtk_range_draw_step_forw (range);
1191 else if (event->window == range->step_back)
1193 if ((range->click_child == 0) ||
1194 (range->click_child == RANGE_CLASS (range)->trough))
1195 gtk_range_draw_step_back (range);
1202 gtk_range_focus_in (GtkWidget *widget,
1203 GdkEventFocus *event)
1205 g_return_val_if_fail (widget != NULL, FALSE);
1206 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1207 g_return_val_if_fail (event != NULL, FALSE);
1209 GTK_WIDGET_SET_FLAGS (widget, GTK_HAS_FOCUS);
1210 gtk_widget_draw_focus (widget);
1216 gtk_range_focus_out (GtkWidget *widget,
1217 GdkEventFocus *event)
1219 g_return_val_if_fail (widget != NULL, FALSE);
1220 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1221 g_return_val_if_fail (event != NULL, FALSE);
1223 GTK_WIDGET_UNSET_FLAGS (widget, GTK_HAS_FOCUS);
1224 gtk_widget_draw_focus (widget);
1230 gtk_real_range_draw_trough (GtkRange *range)
1232 g_return_if_fail (range != NULL);
1233 g_return_if_fail (GTK_IS_RANGE (range));
1237 gtk_paint_box (GTK_WIDGET (range)->style, range->trough,
1238 GTK_STATE_ACTIVE, GTK_SHADOW_IN,
1239 NULL, GTK_WIDGET(range), "trough",
1241 if (GTK_WIDGET_HAS_FOCUS (range))
1242 gtk_paint_focus (GTK_WIDGET (range)->style,
1244 NULL, GTK_WIDGET(range), "trough",
1250 gtk_real_range_draw_slider (GtkRange *range)
1252 GtkStateType state_type;
1254 g_return_if_fail (range != NULL);
1255 g_return_if_fail (GTK_IS_RANGE (range));
1259 if ((range->in_child == RANGE_CLASS (range)->slider) ||
1260 (range->click_child == RANGE_CLASS (range)->slider))
1261 state_type = GTK_STATE_PRELIGHT;
1263 state_type = GTK_STATE_NORMAL;
1264 gtk_paint_box (GTK_WIDGET (range)->style, range->slider,
1265 state_type, GTK_SHADOW_OUT,
1266 NULL, GTK_WIDGET (range), "slider",
1272 gtk_real_range_timer (GtkRange *range)
1276 GDK_THREADS_ENTER ();
1279 if (range->click_child == RANGE_CLASS (range)->slider)
1281 if (range->policy == GTK_UPDATE_DELAYED)
1282 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
1287 GdkModifierType mods, mask;
1292 if (range->need_timer)
1293 range->timer = gtk_timeout_add (SCROLL_TIMER_LENGTH,
1294 (GtkFunction) RANGE_CLASS (range)->timer,
1298 GDK_THREADS_LEAVE ();
1301 range->need_timer = FALSE;
1304 switch (range->button)
1307 mask = GDK_BUTTON1_MASK;
1310 mask = GDK_BUTTON2_MASK;
1313 mask = GDK_BUTTON3_MASK;
1320 gdk_window_get_pointer (range->slider, NULL, NULL, &mods);
1323 return_val = gtk_range_scroll (range, -1);
1326 GDK_THREADS_LEAVE ();
1332 gtk_range_scroll (GtkRange *range,
1338 g_return_val_if_fail (range != NULL, FALSE);
1339 g_return_val_if_fail (GTK_IS_RANGE (range), FALSE);
1341 new_value = range->adjustment->value;
1344 switch (range->scroll_type)
1346 case GTK_SCROLL_NONE:
1349 case GTK_SCROLL_JUMP:
1350 if (jump_perc >= 0 && jump_perc <= 1)
1352 new_value = (range->adjustment->lower +
1353 (range->adjustment->upper - range->adjustment->page_size -
1354 range->adjustment->lower) * jump_perc);
1358 case GTK_SCROLL_STEP_BACKWARD:
1359 new_value -= range->adjustment->step_increment;
1360 if (new_value <= range->adjustment->lower)
1362 new_value = range->adjustment->lower;
1368 case GTK_SCROLL_STEP_FORWARD:
1369 new_value += range->adjustment->step_increment;
1370 if (new_value >= (range->adjustment->upper - range->adjustment->page_size))
1372 new_value = range->adjustment->upper - range->adjustment->page_size;
1378 case GTK_SCROLL_PAGE_BACKWARD:
1379 new_value -= range->adjustment->page_increment;
1380 if (new_value <= range->adjustment->lower)
1382 new_value = range->adjustment->lower;
1388 case GTK_SCROLL_PAGE_FORWARD:
1389 new_value += range->adjustment->page_increment;
1390 if (new_value >= (range->adjustment->upper - range->adjustment->page_size))
1392 new_value = range->adjustment->upper - range->adjustment->page_size;
1399 if (new_value != range->adjustment->value)
1401 range->adjustment->value = new_value;
1403 if ((range->policy == GTK_UPDATE_CONTINUOUS) ||
1404 (!return_val && (range->policy == GTK_UPDATE_DELAYED)))
1406 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
1410 gtk_range_slider_update (range);
1411 gtk_range_clear_background (range);
1420 gtk_range_add_timer (GtkRange *range)
1422 g_return_if_fail (range != NULL);
1423 g_return_if_fail (GTK_IS_RANGE (range));
1427 range->need_timer = TRUE;
1428 range->timer = gtk_timeout_add (SCROLL_INITIAL_DELAY,
1429 (GtkFunction) RANGE_CLASS (range)->timer,
1435 gtk_range_remove_timer (GtkRange *range)
1437 g_return_if_fail (range != NULL);
1438 g_return_if_fail (GTK_IS_RANGE (range));
1442 gtk_timeout_remove (range->timer);
1445 range->need_timer = FALSE;
1449 gtk_range_adjustment_changed (GtkAdjustment *adjustment,
1454 g_return_if_fail (adjustment != NULL);
1455 g_return_if_fail (data != NULL);
1457 range = GTK_RANGE (data);
1459 if (((range->old_lower != adjustment->lower) ||
1460 (range->old_upper != adjustment->upper) ||
1461 (range->old_page_size != adjustment->page_size)) &&
1462 (range->old_value == adjustment->value))
1464 if ((adjustment->lower == adjustment->upper) ||
1465 (range->old_lower == (range->old_upper - range->old_page_size)))
1467 adjustment->value = adjustment->lower;
1468 gtk_signal_emit_by_name (GTK_OBJECT (adjustment), "value_changed");
1472 if ((range->old_value != adjustment->value) ||
1473 (range->old_lower != adjustment->lower) ||
1474 (range->old_upper != adjustment->upper) ||
1475 (range->old_page_size != adjustment->page_size))
1477 gtk_range_slider_update (range);
1478 gtk_range_clear_background (range);
1480 range->old_value = adjustment->value;
1481 range->old_lower = adjustment->lower;
1482 range->old_upper = adjustment->upper;
1483 range->old_page_size = adjustment->page_size;
1488 gtk_range_adjustment_value_changed (GtkAdjustment *adjustment,
1493 g_return_if_fail (adjustment != NULL);
1494 g_return_if_fail (data != NULL);
1496 range = GTK_RANGE (data);
1498 if (range->old_value != adjustment->value)
1500 gtk_range_slider_update (range);
1501 gtk_range_clear_background (range);
1503 range->old_value = adjustment->value;
1509 gtk_range_trough_hdims (GtkRange *range,
1519 g_return_if_fail (range != NULL);
1521 gdk_window_get_size (range->trough, &trough_width, NULL);
1522 gdk_window_get_size (range->slider, &slider_length, NULL);
1524 tleft = GTK_WIDGET (range)->style->klass->xthickness;
1525 tright = trough_width - slider_length - GTK_WIDGET (range)->style->klass->xthickness;
1527 if (range->step_back)
1529 gdk_window_get_size (range->step_back, &tmp_width, NULL);
1530 tleft += (tmp_width + RANGE_CLASS (range)->stepper_slider_spacing);
1533 if (range->step_forw)
1535 gdk_window_get_size (range->step_forw, &tmp_width, NULL);
1536 tright -= (tmp_width + RANGE_CLASS (range)->stepper_slider_spacing);
1546 gtk_range_trough_vdims (GtkRange *range,
1556 g_return_if_fail (range != NULL);
1558 gdk_window_get_size (range->trough, NULL, &trough_height);
1559 gdk_window_get_size (range->slider, NULL, &slider_length);
1561 ttop = GTK_WIDGET (range)->style->klass->ythickness;
1562 tbottom = trough_height - slider_length - GTK_WIDGET (range)->style->klass->ythickness;
1564 if (range->step_back)
1566 gdk_window_get_size (range->step_back, NULL, &tmp_height);
1567 ttop += (tmp_height + RANGE_CLASS (range)->stepper_slider_spacing);
1570 if (range->step_forw)
1572 gdk_window_get_size (range->step_forw, NULL, &tmp_height);
1573 tbottom -= (tmp_height + RANGE_CLASS (range)->stepper_slider_spacing);
1583 gtk_range_style_set (GtkWidget *widget,
1584 GtkStyle *previous_style)
1588 g_return_if_fail (widget != NULL);
1589 g_return_if_fail (GTK_IS_RANGE (widget));
1591 range = GTK_RANGE (widget);
1593 if (GTK_WIDGET_REALIZED (widget))
1596 gtk_style_set_background (widget->style, range->trough, GTK_STATE_ACTIVE);
1599 gtk_style_set_background (widget->style, range->slider, GTK_STATE_NORMAL);
1601 /* The backgrounds of the step_forw and step_back never actually
1602 * get drawn in draw calls, so we call gdk_window_clear() here
1603 * so they get the correct colors. This is a hack. OWT.
1606 if (range->step_forw)
1608 gtk_style_set_background (widget->style, range->step_forw, GTK_STATE_ACTIVE);
1609 gdk_window_clear (range->step_forw);
1612 if (range->step_back)
1614 gtk_style_set_background (widget->style, range->step_back, GTK_STATE_ACTIVE);
1615 gdk_window_clear (range->step_back);