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"
32 #define SCROLL_TIMER_LENGTH 20
33 #define SCROLL_INITIAL_DELAY 100
34 #define SCROLL_DELAY_LENGTH 300
36 #define RANGE_CLASS(w) GTK_RANGE_GET_CLASS (w)
43 static void gtk_range_class_init (GtkRangeClass *klass);
44 static void gtk_range_init (GtkRange *range);
45 static void gtk_range_set_arg (GtkObject *object,
48 static void gtk_range_get_arg (GtkObject *object,
51 static void gtk_range_destroy (GtkObject *object);
52 static void gtk_range_draw (GtkWidget *widget,
54 static void gtk_range_draw_focus (GtkWidget *widget);
55 static void gtk_range_unrealize (GtkWidget *widget);
56 static gint gtk_range_expose (GtkWidget *widget,
57 GdkEventExpose *event);
58 static gint gtk_range_button_press (GtkWidget *widget,
59 GdkEventButton *event);
60 static gint gtk_range_button_release (GtkWidget *widget,
61 GdkEventButton *event);
62 static gint gtk_range_motion_notify (GtkWidget *widget,
63 GdkEventMotion *event);
64 static gint gtk_range_key_press (GtkWidget *widget,
66 static gint gtk_range_enter_notify (GtkWidget *widget,
67 GdkEventCrossing *event);
68 static gint gtk_range_leave_notify (GtkWidget *widget,
69 GdkEventCrossing *event);
70 static gint gtk_range_focus_in (GtkWidget *widget,
71 GdkEventFocus *event);
72 static gint gtk_range_focus_out (GtkWidget *widget,
73 GdkEventFocus *event);
74 static gint gtk_range_scroll_event (GtkWidget *widget,
75 GdkEventScroll *event);
76 static void gtk_range_style_set (GtkWidget *widget,
77 GtkStyle *previous_style);
79 static void gtk_real_range_draw_trough (GtkRange *range);
80 static void gtk_real_range_draw_slider (GtkRange *range);
81 static gint gtk_real_range_timer (GtkRange *range);
82 static gint gtk_range_scroll (GtkRange *range,
85 static void gtk_range_add_timer (GtkRange *range);
86 static void gtk_range_remove_timer (GtkRange *range);
88 static void gtk_range_adjustment_changed (GtkAdjustment *adjustment,
90 static void gtk_range_adjustment_value_changed (GtkAdjustment *adjustment,
93 static void gtk_range_trough_hdims (GtkRange *range,
96 static void gtk_range_trough_vdims (GtkRange *range,
100 static GtkWidgetClass *parent_class = NULL;
104 gtk_range_get_type (void)
106 static GtkType range_type = 0;
110 static const GtkTypeInfo range_info =
114 sizeof (GtkRangeClass),
115 (GtkClassInitFunc) gtk_range_class_init,
116 (GtkObjectInitFunc) gtk_range_init,
117 /* reserved_1 */ NULL,
118 /* reserved_2 */ NULL,
119 (GtkClassInitFunc) NULL,
122 range_type = gtk_type_unique (GTK_TYPE_WIDGET, &range_info);
129 gtk_range_class_init (GtkRangeClass *class)
131 GtkObjectClass *object_class;
132 GtkWidgetClass *widget_class;
134 object_class = (GtkObjectClass*) class;
135 widget_class = (GtkWidgetClass*) class;
137 parent_class = gtk_type_class (GTK_TYPE_WIDGET);
139 object_class->set_arg = gtk_range_set_arg;
140 object_class->get_arg = gtk_range_get_arg;
141 object_class->destroy = gtk_range_destroy;
143 widget_class->draw = gtk_range_draw;
144 widget_class->draw_focus = gtk_range_draw_focus;
145 widget_class->unrealize = gtk_range_unrealize;
146 widget_class->expose_event = gtk_range_expose;
147 widget_class->button_press_event = gtk_range_button_press;
148 widget_class->button_release_event = gtk_range_button_release;
149 widget_class->motion_notify_event = gtk_range_motion_notify;
150 widget_class->scroll_event = gtk_range_scroll_event;
151 widget_class->key_press_event = gtk_range_key_press;
152 widget_class->enter_notify_event = gtk_range_enter_notify;
153 widget_class->leave_notify_event = gtk_range_leave_notify;
154 widget_class->focus_in_event = gtk_range_focus_in;
155 widget_class->focus_out_event = gtk_range_focus_out;
156 widget_class->style_set = gtk_range_style_set;
158 class->slider_width = 11;
159 class->stepper_size = 11;
160 class->stepper_slider_spacing = 1;
161 class->min_slider_size = 7;
164 class->step_forw = 3;
165 class->step_back = 4;
166 class->draw_background = NULL;
167 class->clear_background = NULL;
168 class->draw_trough = gtk_real_range_draw_trough;
169 class->draw_slider = gtk_real_range_draw_slider;
170 class->draw_step_forw = NULL;
171 class->draw_step_back = NULL;
172 class->trough_click = NULL;
173 class->trough_keys = NULL;
174 class->motion = NULL;
175 class->timer = gtk_real_range_timer;
177 gtk_object_add_arg_type ("GtkRange::update_policy",
178 GTK_TYPE_UPDATE_TYPE,
184 gtk_range_set_arg (GtkObject *object,
190 range = GTK_RANGE (object);
194 case ARG_UPDATE_POLICY:
195 gtk_range_set_update_policy (range, GTK_VALUE_ENUM (*arg));
203 gtk_range_get_arg (GtkObject *object,
209 range = GTK_RANGE (object);
213 case ARG_UPDATE_POLICY:
214 GTK_VALUE_ENUM (*arg) = range->policy;
217 arg->type = GTK_TYPE_INVALID;
223 gtk_range_init (GtkRange *range)
225 range->trough = NULL;
226 range->slider = NULL;
227 range->step_forw = NULL;
228 range->step_back = NULL;
230 range->x_click_point = 0;
231 range->y_click_point = 0;
234 range->policy = GTK_UPDATE_CONTINUOUS;
235 range->scroll_type = GTK_SCROLL_NONE;
237 range->click_child = 0;
238 range->need_timer = FALSE;
240 range->old_value = 0.0;
241 range->old_lower = 0.0;
242 range->old_upper = 0.0;
243 range->old_page_size = 0.0;
244 range->adjustment = NULL;
248 gtk_range_get_adjustment (GtkRange *range)
250 g_return_val_if_fail (range != NULL, NULL);
251 g_return_val_if_fail (GTK_IS_RANGE (range), NULL);
253 if (!range->adjustment)
254 gtk_range_set_adjustment (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 get_window_region (GdkWindow *window)
400 gdk_window_get_position (window, &rect.x, &rect.y);
401 gdk_window_get_size (window, &rect.width, &rect.height);
403 return gdk_region_rectangle (&rect);
407 move_and_update_window (GdkWindow *window, gint x, gint y)
409 GdkRegion *old_region;
410 GdkRegion *new_region;
411 GdkWindow *parent = gdk_window_get_parent (window);
413 old_region = get_window_region (window);
414 gdk_window_move (window, x, y);
415 new_region = get_window_region (window);
417 gdk_region_subtract (old_region, new_region);
418 gdk_window_invalidate_region (parent, old_region, TRUE);
419 gdk_region_destroy (old_region);
420 gdk_region_destroy (new_region);
422 gdk_window_process_updates (parent, TRUE);
426 gtk_range_default_hslider_update (GtkRange *range)
432 g_return_if_fail (range != NULL);
433 g_return_if_fail (GTK_IS_RANGE (range));
435 if (GTK_WIDGET_REALIZED (range))
437 gtk_range_trough_hdims (range, &left, &right);
440 if (range->adjustment->value < range->adjustment->lower)
442 range->adjustment->value = range->adjustment->lower;
443 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
445 else if (range->adjustment->value > range->adjustment->upper)
447 range->adjustment->value = range->adjustment->upper;
448 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
451 if (range->adjustment->lower != (range->adjustment->upper - range->adjustment->page_size))
452 x += ((right - left) * (range->adjustment->value - range->adjustment->lower) /
453 (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size));
460 move_and_update_window (range->slider, x, GTK_WIDGET (range)->style->ythickness);
465 gtk_range_default_vslider_update (GtkRange *range)
471 g_return_if_fail (range != NULL);
472 g_return_if_fail (GTK_IS_RANGE (range));
474 if (GTK_WIDGET_REALIZED (range))
476 gtk_range_trough_vdims (range, &top, &bottom);
479 if (range->adjustment->value < range->adjustment->lower)
481 range->adjustment->value = range->adjustment->lower;
482 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
484 else if (range->adjustment->value > range->adjustment->upper)
486 range->adjustment->value = range->adjustment->upper;
487 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
490 if (range->adjustment->lower != (range->adjustment->upper - range->adjustment->page_size))
491 y += ((bottom - top) * (range->adjustment->value - range->adjustment->lower) /
492 (range->adjustment->upper - range->adjustment->lower - range->adjustment->page_size));
499 move_and_update_window (range->slider, GTK_WIDGET (range)->style->xthickness, y);
504 gtk_range_default_htrough_click (GtkRange *range,
516 g_return_val_if_fail (range != NULL, GTK_TROUGH_NONE);
517 g_return_val_if_fail (GTK_IS_RANGE (range), GTK_TROUGH_NONE);
519 ythickness = GTK_WIDGET (range)->style->ythickness;
521 gtk_range_trough_hdims (range, &left, &right);
522 gdk_window_get_size (range->slider, &slider_length, NULL);
523 right += slider_length;
525 if ((x > left) && (y > ythickness))
527 gdk_window_get_size (range->trough, &trough_width, &trough_height);
529 if ((x < right) && (y < (trough_height - ythickness)))
533 *jump_perc = ((gdouble) (x - left)) / ((gdouble) (right - left));
534 return GTK_TROUGH_JUMP;
537 gdk_window_get_position (range->slider, &slider_x, NULL);
540 return GTK_TROUGH_START;
542 return GTK_TROUGH_END;
546 return GTK_TROUGH_NONE;
550 gtk_range_default_vtrough_click (GtkRange *range,
562 g_return_val_if_fail (range != NULL, GTK_TROUGH_NONE);
563 g_return_val_if_fail (GTK_IS_RANGE (range), GTK_TROUGH_NONE);
565 xthickness = GTK_WIDGET (range)->style->xthickness;
567 gtk_range_trough_vdims (range, &top, &bottom);
568 gdk_window_get_size (range->slider, NULL, &slider_length);
569 bottom += slider_length;
571 if ((x > xthickness) && (y > top))
573 gdk_window_get_size (range->trough, &trough_width, &trough_height);
575 if ((x < (trough_width - xthickness) && (y < bottom)))
579 *jump_perc = ((gdouble) (y - top)) / ((gdouble) (bottom - top));
581 return GTK_TROUGH_JUMP;
584 gdk_window_get_position (range->slider, NULL, &slider_y);
587 return GTK_TROUGH_START;
589 return GTK_TROUGH_END;
593 return GTK_TROUGH_NONE;
597 gtk_range_default_hmotion (GtkRange *range,
603 gint slider_x, slider_y;
606 g_return_if_fail (GTK_IS_RANGE (range));
607 g_return_if_fail (GTK_WIDGET_REALIZED (range));
609 range = GTK_RANGE (range);
611 gdk_window_get_position (range->slider, &slider_x, &slider_y);
612 gtk_range_trough_hdims (range, &left, &right);
617 new_pos = slider_x + xdelta;
621 else if (new_pos > right)
624 old_value = range->adjustment->value;
625 range->adjustment->value = ((range->adjustment->upper -
626 range->adjustment->lower -
627 range->adjustment->page_size) *
628 (new_pos - left) / (right - left) +
629 range->adjustment->lower);
631 if (range->digits >= 0)
635 sprintf (buffer, "%0.*f", range->digits, range->adjustment->value);
636 sscanf (buffer, "%f", &range->adjustment->value);
639 if (old_value != range->adjustment->value)
641 if (range->policy == GTK_UPDATE_CONTINUOUS)
643 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
647 gtk_range_slider_update (range);
648 gtk_range_clear_background (range);
650 if (range->policy == GTK_UPDATE_DELAYED)
652 gtk_range_remove_timer (range);
653 range->timer = gtk_timeout_add (SCROLL_DELAY_LENGTH,
654 (GtkFunction) RANGE_CLASS (range)->timer,
662 gtk_range_default_vmotion (GtkRange *range,
668 gint slider_x, slider_y;
671 g_return_if_fail (GTK_IS_RANGE (range));
672 g_return_if_fail (GTK_WIDGET_REALIZED (range));
674 range = GTK_RANGE (range);
676 gdk_window_get_position (range->slider, &slider_x, &slider_y);
677 gtk_range_trough_vdims (range, &top, &bottom);
682 new_pos = slider_y + ydelta;
686 else if (new_pos > bottom)
689 old_value = range->adjustment->value;
690 range->adjustment->value = ((range->adjustment->upper -
691 range->adjustment->lower -
692 range->adjustment->page_size) *
693 (new_pos - top) / (bottom - top) +
694 range->adjustment->lower);
696 if (range->digits >= 0)
700 sprintf (buffer, "%0.*f", range->digits, range->adjustment->value);
701 sscanf (buffer, "%f", &range->adjustment->value);
704 if (old_value != range->adjustment->value)
706 if (range->policy == GTK_UPDATE_CONTINUOUS)
708 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
712 gtk_range_slider_update (range);
713 gtk_range_clear_background (range);
715 if (range->policy == GTK_UPDATE_DELAYED)
717 gtk_range_remove_timer (range);
718 range->timer = gtk_timeout_add (SCROLL_DELAY_LENGTH,
719 (GtkFunction) RANGE_CLASS (range)->timer,
728 gtk_range_destroy (GtkObject *object)
732 g_return_if_fail (object != NULL);
733 g_return_if_fail (GTK_IS_RANGE (object));
735 range = GTK_RANGE (object);
737 gtk_range_remove_timer (range);
738 if (range->adjustment)
740 if (range->adjustment)
741 gtk_signal_disconnect_by_data (GTK_OBJECT (range->adjustment),
743 gtk_object_unref (GTK_OBJECT (range->adjustment));
744 range->adjustment = NULL;
747 (* GTK_OBJECT_CLASS (parent_class)->destroy) (object);
751 gtk_range_draw (GtkWidget *widget,
756 g_return_if_fail (widget != NULL);
757 g_return_if_fail (GTK_IS_RANGE (widget));
758 g_return_if_fail (area != NULL);
760 if (GTK_WIDGET_DRAWABLE (widget))
762 range = GTK_RANGE (widget);
764 gtk_range_draw_background (range);
765 gtk_range_draw_trough (range);
766 gtk_range_draw_slider (range);
767 gtk_range_draw_step_forw (range);
768 gtk_range_draw_step_back (range);
773 gtk_range_draw_focus (GtkWidget *widget)
775 g_return_if_fail (widget != NULL);
776 g_return_if_fail (GTK_IS_RANGE (widget));
778 if (GTK_WIDGET_DRAWABLE (widget))
779 gtk_range_draw_trough (GTK_RANGE (widget));
783 gtk_range_unrealize (GtkWidget *widget)
787 g_return_if_fail (widget != NULL);
788 g_return_if_fail (GTK_IS_RANGE (widget));
790 range = GTK_RANGE (widget);
794 gdk_window_set_user_data (range->slider, NULL);
795 gdk_window_destroy (range->slider);
796 range->slider = NULL;
800 gdk_window_set_user_data (range->trough, NULL);
801 gdk_window_destroy (range->trough);
802 range->trough = NULL;
804 if (range->step_forw)
806 gdk_window_set_user_data (range->step_forw, NULL);
807 gdk_window_destroy (range->step_forw);
808 range->step_forw = NULL;
810 if (range->step_back)
812 gdk_window_set_user_data (range->step_back, NULL);
813 gdk_window_destroy (range->step_back);
814 range->step_back = NULL;
817 if (GTK_WIDGET_CLASS (parent_class)->unrealize)
818 (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
822 gtk_range_expose (GtkWidget *widget,
823 GdkEventExpose *event)
827 g_return_val_if_fail (widget != NULL, FALSE);
828 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
829 g_return_val_if_fail (event != NULL, FALSE);
831 range = GTK_RANGE (widget);
833 /* We should really pass another argument -
834 *the redrawn area - to all the drawing functions)
836 if (event->window == range->trough)
838 gtk_range_draw_trough (range);
840 else if (event->window == widget->window)
842 gtk_range_draw_background (range);
844 else if (event->window == range->slider)
846 gtk_range_draw_slider (range);
848 else if (event->window == range->step_forw)
850 gtk_range_draw_step_forw (range);
852 else if (event->window == range->step_back)
854 gtk_range_draw_step_back (range);
860 gtk_range_button_press (GtkWidget *widget,
861 GdkEventButton *event)
867 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
868 g_return_val_if_fail (event != NULL, FALSE);
870 if (!GTK_WIDGET_HAS_FOCUS (widget))
871 gtk_widget_grab_focus (widget);
874 range = GTK_RANGE (widget);
875 if (range->button == 0)
877 gtk_grab_add (widget);
879 range->button = event->button;
880 range->x_click_point = event->x;
881 range->y_click_point = event->y;
883 if (event->window == range->trough)
885 range->click_child = RANGE_CLASS (range)->trough;
887 if (range->button == 2)
888 trough_part = gtk_range_trough_click (range, event->x, event->y, &jump_perc);
890 trough_part = gtk_range_trough_click (range, event->x, event->y, NULL);
892 range->scroll_type = GTK_SCROLL_NONE;
893 if (trough_part == GTK_TROUGH_START)
894 range->scroll_type = GTK_SCROLL_PAGE_BACKWARD;
895 else if (trough_part == GTK_TROUGH_END)
896 range->scroll_type = GTK_SCROLL_PAGE_FORWARD;
897 else if (trough_part == GTK_TROUGH_JUMP &&
898 jump_perc >= 0 && jump_perc <= 1)
899 range->scroll_type = GTK_SCROLL_JUMP;
901 if (range->scroll_type != GTK_SCROLL_NONE)
903 gtk_range_scroll (range, jump_perc);
904 gtk_range_add_timer (range);
907 else if (event->window == range->slider)
909 range->click_child = RANGE_CLASS (range)->slider;
910 range->scroll_type = GTK_SCROLL_NONE;
912 else if (event->window == range->step_forw)
914 range->click_child = RANGE_CLASS (range)->step_forw;
915 range->scroll_type = GTK_SCROLL_STEP_FORWARD;
917 gtk_range_scroll (range, -1);
918 gtk_range_add_timer (range);
919 gtk_range_draw_step_forw (range);
921 else if (event->window == range->step_back)
923 range->click_child = RANGE_CLASS (range)->step_back;
924 range->scroll_type = GTK_SCROLL_STEP_BACKWARD;
926 gtk_range_scroll (range, -1);
927 gtk_range_add_timer (range);
928 gtk_range_draw_step_back (range);
936 gtk_range_button_release (GtkWidget *widget,
937 GdkEventButton *event)
941 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
942 g_return_val_if_fail (event != NULL, FALSE);
944 range = GTK_RANGE (widget);
946 if (range->button == event->button)
948 gtk_grab_remove (widget);
951 range->x_click_point = -1;
952 range->y_click_point = -1;
954 if (range->click_child == RANGE_CLASS (range)->slider)
956 if (range->policy == GTK_UPDATE_DELAYED)
957 gtk_range_remove_timer (range);
959 if ((range->policy != GTK_UPDATE_CONTINUOUS) &&
960 (range->old_value != range->adjustment->value))
961 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
963 else if ((range->click_child == RANGE_CLASS (range)->trough) ||
964 (range->click_child == RANGE_CLASS (range)->step_forw) ||
965 (range->click_child == RANGE_CLASS (range)->step_back))
967 gtk_range_remove_timer (range);
969 if ((range->policy != GTK_UPDATE_CONTINUOUS) &&
970 (range->old_value != range->adjustment->value))
971 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
973 if (range->click_child == RANGE_CLASS (range)->step_forw)
975 range->click_child = 0;
976 gtk_range_draw_step_forw (range);
978 else if (range->click_child == RANGE_CLASS (range)->step_back)
980 range->click_child = 0;
981 gtk_range_draw_step_back (range);
985 range->click_child = 0;
992 gtk_range_scroll_event (GtkWidget *widget,
993 GdkEventScroll *event)
997 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
998 g_return_val_if_fail (event != NULL, FALSE);
1000 range = GTK_RANGE (widget);
1002 if (GTK_WIDGET_REALIZED (range))
1004 GtkAdjustment *adj = GTK_RANGE (range)->adjustment;
1005 gfloat new_value = adj->value + ((event->direction == GDK_SCROLL_UP) ?
1006 -adj->page_increment / 2:
1007 adj->page_increment / 2);
1008 new_value = CLAMP (new_value, adj->lower, adj->upper - adj->page_size);
1009 gtk_adjustment_set_value (adj, new_value);
1016 gtk_range_motion_notify (GtkWidget *widget,
1017 GdkEventMotion *event)
1021 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1022 g_return_val_if_fail (event != NULL, FALSE);
1024 range = GTK_RANGE (widget);
1026 if (range->click_child == RANGE_CLASS (range)->slider)
1028 GdkModifierType mods;
1029 gint x, y, mask, x2, y2;
1031 gdk_window_get_pointer (range->trough, &x, &y, &mods);
1032 gdk_window_get_position (range->slider, &x2, &y2);
1037 switch (range->button)
1040 mask = GDK_BUTTON1_MASK;
1043 mask = GDK_BUTTON2_MASK;
1046 mask = GDK_BUTTON3_MASK;
1055 if (RANGE_CLASS (range)->motion)
1056 (* RANGE_CLASS (range)->motion) (range, x - range->x_click_point, y - range->y_click_point);
1064 gtk_range_key_press (GtkWidget *widget,
1069 GtkScrollType scroll = GTK_SCROLL_NONE;
1070 GtkTroughType pos = GTK_TROUGH_NONE;
1072 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1073 g_return_val_if_fail (event != NULL, FALSE);
1075 range = GTK_RANGE (widget);
1078 if (RANGE_CLASS (range)->trough_keys)
1079 return_val = (* RANGE_CLASS (range)->trough_keys) (range, event, &scroll, &pos);
1083 if (scroll != GTK_SCROLL_NONE)
1085 range->scroll_type = scroll;
1086 gtk_range_scroll (range, -1);
1087 if (range->old_value != range->adjustment->value)
1089 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
1090 switch (range->scroll_type)
1092 case GTK_SCROLL_STEP_BACKWARD:
1093 gtk_range_draw_step_back (range);
1095 case GTK_SCROLL_STEP_FORWARD:
1096 gtk_range_draw_step_forw (range);
1101 if (pos != GTK_TROUGH_NONE)
1103 if (pos == GTK_TROUGH_START)
1104 range->adjustment->value = range->adjustment->lower;
1105 else if (pos == GTK_TROUGH_END)
1106 range->adjustment->value =
1107 range->adjustment->upper - range->adjustment->page_size;
1109 if (range->old_value != range->adjustment->value)
1111 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment),
1114 gtk_range_slider_update (range);
1115 gtk_range_clear_background (range);
1123 gtk_range_enter_notify (GtkWidget *widget,
1124 GdkEventCrossing *event)
1128 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1129 g_return_val_if_fail (event != NULL, FALSE);
1131 range = GTK_RANGE (widget);
1133 if (event->window == range->trough)
1135 range->in_child = RANGE_CLASS (range)->trough;
1137 else if (event->window == range->slider)
1139 range->in_child = RANGE_CLASS (range)->slider;
1141 if ((range->click_child == 0) ||
1142 (range->click_child == RANGE_CLASS (range)->trough))
1143 gtk_range_draw_slider (range);
1145 else if (event->window == range->step_forw)
1147 range->in_child = RANGE_CLASS (range)->step_forw;
1149 if ((range->click_child == 0) ||
1150 (range->click_child == RANGE_CLASS (range)->trough))
1151 gtk_range_draw_step_forw (range);
1153 else if (event->window == range->step_back)
1155 range->in_child = RANGE_CLASS (range)->step_back;
1157 if ((range->click_child == 0) ||
1158 (range->click_child == RANGE_CLASS (range)->trough))
1159 gtk_range_draw_step_back (range);
1166 gtk_range_leave_notify (GtkWidget *widget,
1167 GdkEventCrossing *event)
1171 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1172 g_return_val_if_fail (event != NULL, FALSE);
1174 range = GTK_RANGE (widget);
1176 range->in_child = 0;
1178 if (event->window == range->trough)
1181 else if (event->window == range->slider)
1183 if ((range->click_child == 0) ||
1184 (range->click_child == RANGE_CLASS (range)->trough))
1185 gtk_range_draw_slider (range);
1187 else if (event->window == range->step_forw)
1189 if ((range->click_child == 0) ||
1190 (range->click_child == RANGE_CLASS (range)->trough))
1191 gtk_range_draw_step_forw (range);
1193 else if (event->window == range->step_back)
1195 if ((range->click_child == 0) ||
1196 (range->click_child == RANGE_CLASS (range)->trough))
1197 gtk_range_draw_step_back (range);
1204 gtk_range_focus_in (GtkWidget *widget,
1205 GdkEventFocus *event)
1207 g_return_val_if_fail (GTK_IS_RANGE (widget), FALSE);
1208 g_return_val_if_fail (event != NULL, FALSE);
1210 GTK_WIDGET_SET_FLAGS (widget, GTK_HAS_FOCUS);
1211 gtk_widget_draw_focus (widget);
1217 gtk_range_focus_out (GtkWidget *widget,
1218 GdkEventFocus *event)
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 (GTK_IS_RANGE (range));
1236 gtk_paint_box (GTK_WIDGET (range)->style, range->trough,
1237 GTK_STATE_ACTIVE, GTK_SHADOW_IN,
1238 NULL, GTK_WIDGET(range), "trough",
1240 if (GTK_WIDGET_HAS_FOCUS (range))
1241 gtk_paint_focus (GTK_WIDGET (range)->style,
1243 NULL, GTK_WIDGET(range), "trough",
1249 gtk_real_range_draw_slider (GtkRange *range)
1251 GtkStateType state_type;
1253 g_return_if_fail (GTK_IS_RANGE (range));
1257 if ((range->in_child == RANGE_CLASS (range)->slider) ||
1258 (range->click_child == RANGE_CLASS (range)->slider))
1259 state_type = GTK_STATE_PRELIGHT;
1261 state_type = GTK_STATE_NORMAL;
1262 gtk_paint_box (GTK_WIDGET (range)->style, range->slider,
1263 state_type, GTK_SHADOW_OUT,
1264 NULL, GTK_WIDGET (range), "slider",
1270 gtk_real_range_timer (GtkRange *range)
1274 GDK_THREADS_ENTER ();
1277 if (range->click_child == RANGE_CLASS (range)->slider)
1279 if (range->policy == GTK_UPDATE_DELAYED)
1280 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
1285 GdkModifierType mods, mask;
1290 if (range->need_timer)
1291 range->timer = gtk_timeout_add (SCROLL_TIMER_LENGTH,
1292 (GtkFunction) RANGE_CLASS (range)->timer,
1296 GDK_THREADS_LEAVE ();
1299 range->need_timer = FALSE;
1302 switch (range->button)
1305 mask = GDK_BUTTON1_MASK;
1308 mask = GDK_BUTTON2_MASK;
1311 mask = GDK_BUTTON3_MASK;
1318 gdk_window_get_pointer (range->slider, NULL, NULL, &mods);
1321 return_val = gtk_range_scroll (range, -1);
1324 GDK_THREADS_LEAVE ();
1330 gtk_range_scroll (GtkRange *range,
1336 g_return_val_if_fail (GTK_IS_RANGE (range), FALSE);
1338 new_value = range->adjustment->value;
1341 switch (range->scroll_type)
1343 case GTK_SCROLL_NONE:
1346 case GTK_SCROLL_JUMP:
1347 if (jump_perc >= 0 && jump_perc <= 1)
1349 new_value = (range->adjustment->lower +
1350 (range->adjustment->upper - range->adjustment->page_size -
1351 range->adjustment->lower) * jump_perc);
1355 case GTK_SCROLL_STEP_BACKWARD:
1356 new_value -= range->adjustment->step_increment;
1357 if (new_value <= range->adjustment->lower)
1359 new_value = range->adjustment->lower;
1365 case GTK_SCROLL_STEP_FORWARD:
1366 new_value += range->adjustment->step_increment;
1367 if (new_value >= (range->adjustment->upper - range->adjustment->page_size))
1369 new_value = range->adjustment->upper - range->adjustment->page_size;
1375 case GTK_SCROLL_PAGE_BACKWARD:
1376 new_value -= range->adjustment->page_increment;
1377 if (new_value <= range->adjustment->lower)
1379 new_value = range->adjustment->lower;
1385 case GTK_SCROLL_PAGE_FORWARD:
1386 new_value += range->adjustment->page_increment;
1387 if (new_value >= (range->adjustment->upper - range->adjustment->page_size))
1389 new_value = range->adjustment->upper - range->adjustment->page_size;
1396 if (new_value != range->adjustment->value)
1398 range->adjustment->value = new_value;
1400 if ((range->policy == GTK_UPDATE_CONTINUOUS) ||
1401 (!return_val && (range->policy == GTK_UPDATE_DELAYED)))
1403 gtk_signal_emit_by_name (GTK_OBJECT (range->adjustment), "value_changed");
1407 gtk_range_slider_update (range);
1408 gtk_range_clear_background (range);
1417 gtk_range_add_timer (GtkRange *range)
1419 g_return_if_fail (GTK_IS_RANGE (range));
1423 range->need_timer = TRUE;
1424 range->timer = gtk_timeout_add (SCROLL_INITIAL_DELAY,
1425 (GtkFunction) RANGE_CLASS (range)->timer,
1431 gtk_range_remove_timer (GtkRange *range)
1433 g_return_if_fail (GTK_IS_RANGE (range));
1437 gtk_timeout_remove (range->timer);
1440 range->need_timer = FALSE;
1444 gtk_range_adjustment_changed (GtkAdjustment *adjustment,
1449 g_return_if_fail (adjustment != NULL);
1450 g_return_if_fail (data != NULL);
1452 range = GTK_RANGE (data);
1454 if (((range->old_lower != adjustment->lower) ||
1455 (range->old_upper != adjustment->upper) ||
1456 (range->old_page_size != adjustment->page_size)) &&
1457 (range->old_value == adjustment->value))
1459 if ((adjustment->lower == adjustment->upper) ||
1460 (range->old_lower == (range->old_upper - range->old_page_size)))
1462 adjustment->value = adjustment->lower;
1463 gtk_signal_emit_by_name (GTK_OBJECT (adjustment), "value_changed");
1467 if ((range->old_value != adjustment->value) ||
1468 (range->old_lower != adjustment->lower) ||
1469 (range->old_upper != adjustment->upper) ||
1470 (range->old_page_size != adjustment->page_size))
1472 gtk_range_slider_update (range);
1473 gtk_range_clear_background (range);
1475 range->old_value = adjustment->value;
1476 range->old_lower = adjustment->lower;
1477 range->old_upper = adjustment->upper;
1478 range->old_page_size = adjustment->page_size;
1483 gtk_range_adjustment_value_changed (GtkAdjustment *adjustment,
1488 g_return_if_fail (adjustment != NULL);
1489 g_return_if_fail (data != NULL);
1491 range = GTK_RANGE (data);
1493 if (range->old_value != adjustment->value)
1495 gtk_range_slider_update (range);
1496 gtk_range_clear_background (range);
1498 range->old_value = adjustment->value;
1504 gtk_range_trough_hdims (GtkRange *range,
1514 g_return_if_fail (range != NULL);
1516 gdk_window_get_size (range->trough, &trough_width, NULL);
1517 gdk_window_get_size (range->slider, &slider_length, NULL);
1519 tleft = GTK_WIDGET (range)->style->xthickness;
1520 tright = trough_width - slider_length - GTK_WIDGET (range)->style->xthickness;
1522 if (range->step_back)
1524 gdk_window_get_size (range->step_back, &tmp_width, NULL);
1525 tleft += (tmp_width + RANGE_CLASS (range)->stepper_slider_spacing);
1528 if (range->step_forw)
1530 gdk_window_get_size (range->step_forw, &tmp_width, NULL);
1531 tright -= (tmp_width + RANGE_CLASS (range)->stepper_slider_spacing);
1541 gtk_range_trough_vdims (GtkRange *range,
1551 g_return_if_fail (range != NULL);
1553 gdk_window_get_size (range->trough, NULL, &trough_height);
1554 gdk_window_get_size (range->slider, NULL, &slider_length);
1556 ttop = GTK_WIDGET (range)->style->ythickness;
1557 tbottom = trough_height - slider_length - GTK_WIDGET (range)->style->ythickness;
1559 if (range->step_back)
1561 gdk_window_get_size (range->step_back, NULL, &tmp_height);
1562 ttop += (tmp_height + RANGE_CLASS (range)->stepper_slider_spacing);
1565 if (range->step_forw)
1567 gdk_window_get_size (range->step_forw, NULL, &tmp_height);
1568 tbottom -= (tmp_height + RANGE_CLASS (range)->stepper_slider_spacing);
1578 gtk_range_style_set (GtkWidget *widget,
1579 GtkStyle *previous_style)
1583 g_return_if_fail (widget != NULL);
1584 g_return_if_fail (GTK_IS_RANGE (widget));
1586 range = GTK_RANGE (widget);
1588 if (GTK_WIDGET_REALIZED (widget))
1591 gtk_style_set_background (widget->style, range->trough, GTK_STATE_ACTIVE);
1594 gtk_style_set_background (widget->style, range->slider, GTK_STATE_NORMAL);
1596 /* The backgrounds of the step_forw and step_back never actually
1597 * get drawn in draw calls, so we call gdk_window_clear() here
1598 * so they get the correct colors. This is a hack. OWT.
1601 if (range->step_forw)
1603 gtk_style_set_background (widget->style, range->step_forw, GTK_STATE_ACTIVE);
1604 gdk_window_clear (range->step_forw);
1607 if (range->step_back)
1609 gtk_style_set_background (widget->style, range->step_back, GTK_STATE_ACTIVE);
1610 gdk_window_clear (range->step_back);