*/
/*
- * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
+ * Modified by the GTK+ Team and others 1997-2004. See the AUTHORS
* file for a list of people on the GTK+ Team. See the ChangeLog
* files for a list of changes. These files are distributed with
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
+#include <config.h>
#include <stdio.h>
+#include <math.h>
+#include "gtkalias.h"
#include "gtkintl.h"
#include "gtkmain.h"
#include "gtkmarshalers.h"
#include "gtkrange.h"
-#include "gtksignal.h"
#include "gtkintl.h"
+#include "gtkscrollbar.h"
#define SCROLL_INITIAL_DELAY 250 /* must hold button this long before ... */
#define SCROLL_LATER_DELAY 100 /* ... it starts repeating at this rate */
VALUE_CHANGED,
ADJUST_BOUNDS,
MOVE_SLIDER,
+ CHANGE_VALUE,
LAST_SIGNAL
};
GdkEventCrossing *event);
static gint gtk_range_leave_notify (GtkWidget *widget,
GdkEventCrossing *event);
+static void gtk_range_grab_notify (GtkWidget *widget,
+ gboolean was_grabbed);
+static void gtk_range_state_changed (GtkWidget *widget,
+ GtkStateType previous_state);
static gint gtk_range_scroll_event (GtkWidget *widget,
GdkEventScroll *event);
static void gtk_range_style_set (GtkWidget *widget,
static void gtk_range_remove_update_timer (GtkRange *range);
static GdkRectangle* get_area (GtkRange *range,
MouseLocation location);
-static void gtk_range_internal_set_value (GtkRange *range,
+static gboolean gtk_range_real_change_value (GtkRange *range,
+ GtkScrollType scroll,
gdouble value);
static void gtk_range_update_value (GtkRange *range);
static guint signals[LAST_SIGNAL];
-GtkType
+GType
gtk_range_get_type (void)
{
- static GtkType range_type = 0;
+ static GType range_type = 0;
if (!range_type)
{
- static const GtkTypeInfo range_info =
+ static const GTypeInfo range_info =
{
- "GtkRange",
- sizeof (GtkRange),
sizeof (GtkRangeClass),
- (GtkClassInitFunc) gtk_range_class_init,
- (GtkObjectInitFunc) gtk_range_init,
- /* reserved_1 */ NULL,
- /* reserved_2 */ NULL,
- (GtkClassInitFunc) NULL,
+ NULL, /* base_init */
+ NULL, /* base_finalize */
+ (GClassInitFunc) gtk_range_class_init,
+ NULL, /* class_finalize */
+ NULL, /* class_data */
+ sizeof (GtkRange),
+ 0, /* n_preallocs */
+ (GInstanceInitFunc) gtk_range_init,
+ NULL, /* value_table */
};
- range_type = gtk_type_unique (GTK_TYPE_WIDGET, &range_info);
+ range_type = g_type_register_static (GTK_TYPE_WIDGET, "GtkRange",
+ &range_info, G_TYPE_FLAG_ABSTRACT);
}
return range_type;
widget_class->scroll_event = gtk_range_scroll_event;
widget_class->enter_notify_event = gtk_range_enter_notify;
widget_class->leave_notify_event = gtk_range_leave_notify;
+ widget_class->grab_notify = gtk_range_grab_notify;
+ widget_class->state_changed = gtk_range_state_changed;
widget_class->style_set = gtk_range_style_set;
class->move_slider = gtk_range_move_slider;
+ class->change_value = gtk_range_real_change_value;
class->slider_detail = "slider";
class->stepper_detail = "stepper";
signals[VALUE_CHANGED] =
g_signal_new ("value_changed",
- G_TYPE_FROM_CLASS (object_class),
+ G_TYPE_FROM_CLASS (gobject_class),
G_SIGNAL_RUN_LAST,
G_STRUCT_OFFSET (GtkRangeClass, value_changed),
NULL, NULL,
signals[ADJUST_BOUNDS] =
g_signal_new ("adjust_bounds",
- G_TYPE_FROM_CLASS (object_class),
+ G_TYPE_FROM_CLASS (gobject_class),
G_SIGNAL_RUN_LAST,
G_STRUCT_OFFSET (GtkRangeClass, adjust_bounds),
NULL, NULL,
signals[MOVE_SLIDER] =
g_signal_new ("move_slider",
- G_TYPE_FROM_CLASS (object_class),
+ G_TYPE_FROM_CLASS (gobject_class),
G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
G_STRUCT_OFFSET (GtkRangeClass, move_slider),
NULL, NULL,
_gtk_marshal_VOID__ENUM,
G_TYPE_NONE, 1,
GTK_TYPE_SCROLL_TYPE);
+
+ /**
+ * GtkRange::change-value:
+ * @range: the range that received the signal.
+ * @scroll: the type of scroll action that was performed.
+ * @value: the new value resulting from the scroll action.
+ * @returns: %TRUE to prevent other handlers from being invoked for the
+ * signal. %FALSE to propagate the signal further.
+ *
+ * The ::change-value signal is emitted when a scroll action is
+ * performed on a range. It allows an application to determine the
+ * type of scroll event that occurred and the resultant new value.
+ * The application can handle the event itself and return %TRUE to
+ * prevent further processing. Or, by returning %FALSE, it can pass
+ * the event to other handlers until the default GTK+ handler is
+ * reached.
+ *
+ * The value parameter is unrounded. An application that overrides
+ * the ::change-value signal is responsible for clamping the value to
+ * the desired number of decimal digits; the default GTK+ handler
+ * clamps the value based on @range->round_digits.
+ *
+ * It is not possible to use delayed update policies in an overridden
+ * ::change-value handler.
+ *
+ * Since: 2.6
+ */
+ signals[CHANGE_VALUE] =
+ g_signal_new ("change_value",
+ G_TYPE_FROM_CLASS (gobject_class),
+ G_SIGNAL_RUN_LAST,
+ G_STRUCT_OFFSET (GtkRangeClass, change_value),
+ _gtk_boolean_handled_accumulator, NULL,
+ _gtk_marshal_BOOLEAN__ENUM_DOUBLE,
+ G_TYPE_BOOLEAN, 2,
+ GTK_TYPE_SCROLL_TYPE,
+ G_TYPE_DOUBLE);
g_object_class_install_property (gobject_class,
PROP_UPDATE_POLICY,
g_param_spec_enum ("update_policy",
- _("Update policy"),
- _("How the range should be updated on the screen"),
+ P_("Update policy"),
+ P_("How the range should be updated on the screen"),
GTK_TYPE_UPDATE_TYPE,
GTK_UPDATE_CONTINUOUS,
G_PARAM_READWRITE));
g_object_class_install_property (gobject_class,
PROP_ADJUSTMENT,
g_param_spec_object ("adjustment",
- _("Adjustment"),
- _("The GtkAdjustment that contains the current value of this range object"),
+ P_("Adjustment"),
+ P_("The GtkAdjustment that contains the current value of this range object"),
GTK_TYPE_ADJUSTMENT,
G_PARAM_READWRITE | G_PARAM_CONSTRUCT));
g_object_class_install_property (gobject_class,
PROP_INVERTED,
g_param_spec_boolean ("inverted",
- _("Inverted"),
- _("Invert direction slider moves to increase range value"),
+ P_("Inverted"),
+ P_("Invert direction slider moves to increase range value"),
FALSE,
G_PARAM_READWRITE));
gtk_widget_class_install_style_property (widget_class,
g_param_spec_int ("slider_width",
- _("Slider Width"),
- _("Width of scrollbar or scale thumb"),
+ P_("Slider Width"),
+ P_("Width of scrollbar or scale thumb"),
0,
G_MAXINT,
14,
G_PARAM_READABLE));
gtk_widget_class_install_style_property (widget_class,
g_param_spec_int ("trough_border",
- _("Trough Border"),
- _("Spacing between thumb/steppers and outer trough bevel"),
+ P_("Trough Border"),
+ P_("Spacing between thumb/steppers and outer trough bevel"),
0,
G_MAXINT,
1,
G_PARAM_READABLE));
gtk_widget_class_install_style_property (widget_class,
g_param_spec_int ("stepper_size",
- _("Stepper Size"),
- _("Length of step buttons at ends"),
+ P_("Stepper Size"),
+ P_("Length of step buttons at ends"),
0,
G_MAXINT,
14,
G_PARAM_READABLE));
gtk_widget_class_install_style_property (widget_class,
g_param_spec_int ("stepper_spacing",
- _("Stepper Spacing"),
- _("Spacing between step buttons and thumb"),
+ P_("Stepper Spacing"),
+ P_("Spacing between step buttons and thumb"),
0,
G_MAXINT,
0,
G_PARAM_READABLE));
gtk_widget_class_install_style_property (widget_class,
g_param_spec_int ("arrow_displacement_x",
- _("Arrow X Displacement"),
- _("How far in the x direction to move the arrow when the button is depressed"),
+ P_("Arrow X Displacement"),
+ P_("How far in the x direction to move the arrow when the button is depressed"),
G_MININT,
G_MAXINT,
0,
G_PARAM_READABLE));
gtk_widget_class_install_style_property (widget_class,
g_param_spec_int ("arrow_displacement_y",
- _("Arrow Y Displacement"),
- _("How far in the y direction to move the arrow when the button is depressed"),
+ P_("Arrow Y Displacement"),
+ P_("How far in the y direction to move the arrow when the button is depressed"),
G_MININT,
G_MAXINT,
0,
{
if (range->adjustment)
{
- gtk_signal_disconnect_by_func (GTK_OBJECT (range->adjustment),
- G_CALLBACK (gtk_range_adjustment_changed),
- range);
- gtk_signal_disconnect_by_func (GTK_OBJECT (range->adjustment),
- G_CALLBACK (gtk_range_adjustment_value_changed),
- range);
- gtk_object_unref (GTK_OBJECT (range->adjustment));
+ g_signal_handlers_disconnect_by_func (range->adjustment,
+ gtk_range_adjustment_changed,
+ range);
+ g_signal_handlers_disconnect_by_func (range->adjustment,
+ gtk_range_adjustment_value_changed,
+ range);
+ g_object_unref (range->adjustment);
}
range->adjustment = adjustment;
- gtk_object_ref (GTK_OBJECT (adjustment));
+ g_object_ref (adjustment);
gtk_object_sink (GTK_OBJECT (adjustment));
- gtk_signal_connect (GTK_OBJECT (adjustment), "changed",
- (GtkSignalFunc) gtk_range_adjustment_changed,
- range);
- gtk_signal_connect (GTK_OBJECT (adjustment), "value_changed",
- (GtkSignalFunc) gtk_range_adjustment_value_changed,
- range);
+ g_signal_connect (adjustment, "changed",
+ G_CALLBACK (gtk_range_adjustment_changed),
+ range);
+ g_signal_connect (adjustment, "value_changed",
+ G_CALLBACK (gtk_range_adjustment_value_changed),
+ range);
gtk_range_adjustment_changed (adjustment, range);
g_object_notify (G_OBJECT (range), "adjustment");
if (range->adjustment)
{
- if (range->adjustment)
- gtk_signal_disconnect_by_data (GTK_OBJECT (range->adjustment),
- (gpointer) range);
- gtk_object_unref (GTK_OBJECT (range->adjustment));
+ g_signal_handlers_disconnect_by_func (range->adjustment,
+ gtk_range_adjustment_changed,
+ range);
+ g_signal_handlers_disconnect_by_func (range->adjustment,
+ gtk_range_adjustment_value_changed,
+ range);
+ g_object_unref (range->adjustment);
range->adjustment = NULL;
}
GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
widget->window = gtk_widget_get_parent_window (widget);
- gdk_window_ref (widget->window);
+ g_object_ref (widget->window);
attributes.window_type = GDK_WINDOW_CHILD;
attributes.x = widget->allocation.x;
attributes.height = widget->allocation.height;
attributes.wclass = GDK_INPUT_ONLY;
attributes.event_mask = gtk_widget_get_events (widget);
- attributes.event_mask |= (GDK_EXPOSURE_MASK |
- GDK_BUTTON_PRESS_MASK |
+ attributes.event_mask |= (GDK_BUTTON_PRESS_MASK |
GDK_BUTTON_RELEASE_MASK |
GDK_ENTER_NOTIFY_MASK |
GDK_LEAVE_NOTIFY_MASK |
{
GtkRange *range = GTK_RANGE (widget);
- g_return_if_fail (GTK_IS_RANGE (widget));
-
gdk_window_show (range->event_window);
GTK_WIDGET_CLASS (parent_class)->map (widget);
{
GtkRange *range = GTK_RANGE (widget);
- g_return_if_fail (GTK_IS_RANGE (widget));
-
gdk_window_hide (range->event_window);
GTK_WIDGET_CLASS (parent_class)->unmap (widget);
static GtkScrollType
range_get_scroll_for_grab (GtkRange *range)
-{
+{
+ gboolean invert;
+
+ invert = should_invert (range);
switch (range->layout->grab_location)
{
/* Backward stepper */
switch (range->layout->grab_button)
{
case 1:
- return GTK_SCROLL_STEP_BACKWARD;
+ return invert ? GTK_SCROLL_STEP_FORWARD : GTK_SCROLL_STEP_BACKWARD;
break;
case 2:
- return GTK_SCROLL_PAGE_BACKWARD;
+ return invert ? GTK_SCROLL_PAGE_FORWARD : GTK_SCROLL_PAGE_BACKWARD;
break;
case 3:
- return GTK_SCROLL_START;
+ return invert ? GTK_SCROLL_END : GTK_SCROLL_START;
break;
}
break;
switch (range->layout->grab_button)
{
case 1:
- return GTK_SCROLL_STEP_FORWARD;
+ return invert ? GTK_SCROLL_STEP_BACKWARD : GTK_SCROLL_STEP_FORWARD;
break;
case 2:
- return GTK_SCROLL_PAGE_FORWARD;
+ return invert ? GTK_SCROLL_PAGE_BACKWARD : GTK_SCROLL_PAGE_FORWARD;
break;
case 3:
- return GTK_SCROLL_END;
+ return invert ? GTK_SCROLL_START : GTK_SCROLL_END;
break;
}
break;
gint delta;
gint c;
gdouble new_value;
-
+ gboolean handled;
+
if (range->orientation == GTK_ORIENTATION_VERTICAL)
delta = mouse_y - range->slide_initial_coordinate;
else
new_value = coord_to_value (range, c);
- gtk_range_internal_set_value (range, new_value);
+ g_signal_emit (range, signals[CHANGE_VALUE], 0, GTK_SCROLL_JUMP, new_value,
+ &handled);
+}
+
+static void stop_scrolling (GtkRange *range)
+{
+ range_grab_remove (range);
+ gtk_range_remove_step_timer (range);
+ /* Flush any pending discontinuous/delayed updates */
+ gtk_range_update_value (range);
+
+ /* Just be lazy about this, if we scrolled it will all redraw anyway,
+ * so no point optimizing the button deactivate case
+ */
+ gtk_widget_queue_draw (GTK_WIDGET (range));
}
static gint
if (range->layout->grab_button == event->button)
{
- MouseLocation grab_location;
-
- grab_location = range->layout->grab_location;
-
- range_grab_remove (range);
- gtk_range_remove_step_timer (range);
-
- if (grab_location == MOUSE_SLIDER)
+ if (range->layout->grab_location == MOUSE_SLIDER)
update_slider_position (range, range->layout->mouse_x, range->layout->mouse_y);
- /* Flush any pending discontinuous/delayed updates */
- gtk_range_update_value (range);
-
- /* Just be lazy about this, if we scrolled it will all redraw anyway,
- * so no point optimizing the button deactivate case
- */
- gtk_widget_queue_draw (widget);
+ stop_scrolling (range);
return TRUE;
}
return FALSE;
}
+/**
+ * _gtk_range_get_wheel_delta:
+ * @range: a #GtkRange
+ * @direction: A #GdkScrollDirection
+ *
+ * Returns a good step value for the mouse wheel.
+ *
+ * Return value: A good step value for the mouse wheel.
+ *
+ * Since: 2.4
+ **/
+gdouble
+_gtk_range_get_wheel_delta (GtkRange *range,
+ GdkScrollDirection direction)
+{
+ GtkAdjustment *adj = range->adjustment;
+ gdouble delta;
+
+ if (GTK_IS_SCROLLBAR (range))
+ delta = pow (adj->page_size, 2.0 / 3.0);
+ else
+ delta = adj->step_increment * 2;
+
+ if (direction == GDK_SCROLL_UP ||
+ direction == GDK_SCROLL_LEFT)
+ delta = - delta;
+
+ if (range->inverted)
+ delta = - delta;
+
+ return delta;
+}
+
static gint
gtk_range_scroll_event (GtkWidget *widget,
GdkEventScroll *event)
if (GTK_WIDGET_REALIZED (range))
{
GtkAdjustment *adj = GTK_RANGE (range)->adjustment;
- gdouble new_value = adj->value + ((event->direction == GDK_SCROLL_UP ||
- event->direction == GDK_SCROLL_LEFT) ?
- -adj->page_increment / 2:
- adj->page_increment / 2);
+ gdouble delta;
+ gboolean handled;
- gtk_range_internal_set_value (range, new_value);
+ delta = _gtk_range_get_wheel_delta (range, event->direction);
+ g_signal_emit (range, signals[CHANGE_VALUE], 0,
+ GTK_SCROLL_JUMP, adj->value + delta,
+ &handled);
+
/* Policy DELAYED makes sense with scroll events,
* but DISCONTINUOUS doesn't, so we update immediately
- * for DISCONTINOUS
+ * for DISCONTINUOUS
*/
if (range->update_policy == GTK_UPDATE_DISCONTINUOUS)
gtk_range_update_value (range);
return TRUE;
}
+static void
+gtk_range_grab_notify (GtkWidget *widget,
+ gboolean was_grabbed)
+{
+ if (!was_grabbed)
+ stop_scrolling (GTK_RANGE (widget));
+}
+
+static void
+gtk_range_state_changed (GtkWidget *widget,
+ GtkStateType previous_state)
+{
+ if (!GTK_WIDGET_IS_SENSITIVE (widget))
+ stop_scrolling (GTK_RANGE (widget));
+}
+
static void
gtk_range_adjustment_changed (GtkAdjustment *adjustment,
gpointer data)
* will enforce on the adjustment.
*/
- g_signal_emit (G_OBJECT (range), signals[VALUE_CHANGED], 0);
+ g_signal_emit (range, signals[VALUE_CHANGED], 0);
}
static void
step_back (GtkRange *range)
{
gdouble newval;
+ gboolean handled;
newval = range->adjustment->value - range->adjustment->step_increment;
- gtk_range_internal_set_value (range, newval);
+ g_signal_emit (range, signals[CHANGE_VALUE], 0,
+ GTK_SCROLL_STEP_BACKWARD, newval, &handled);
}
static void
step_forward (GtkRange *range)
{
gdouble newval;
+ gboolean handled;
newval = range->adjustment->value + range->adjustment->step_increment;
-
- gtk_range_internal_set_value (range, newval);
+ g_signal_emit (range, signals[CHANGE_VALUE], 0,
+ GTK_SCROLL_STEP_FORWARD, newval, &handled);
}
page_back (GtkRange *range)
{
gdouble newval;
+ gboolean handled;
newval = range->adjustment->value - range->adjustment->page_increment;
- gtk_range_internal_set_value (range, newval);
+ g_signal_emit (range, signals[CHANGE_VALUE], 0,
+ GTK_SCROLL_PAGE_BACKWARD, newval, &handled);
}
static void
page_forward (GtkRange *range)
{
gdouble newval;
+ gboolean handled;
newval = range->adjustment->value + range->adjustment->page_increment;
+ g_signal_emit (range, signals[CHANGE_VALUE], 0,
+ GTK_SCROLL_PAGE_FORWARD, newval, &handled);
+}
- gtk_range_internal_set_value (range, newval);
+static void
+scroll_begin (GtkRange *range)
+{
+ gboolean handled;
+ g_signal_emit (range, signals[CHANGE_VALUE], 0,
+ GTK_SCROLL_START, range->adjustment->lower,
+ &handled);
+}
+
+static void
+scroll_end (GtkRange *range)
+{
+ gdouble newval;
+ gboolean handled;
+
+ newval = range->adjustment->upper - range->adjustment->page_size;
+ g_signal_emit (range, signals[CHANGE_VALUE], 0, GTK_SCROLL_END, newval,
+ &handled);
}
static void
break;
case GTK_SCROLL_START:
- gtk_range_internal_set_value (range,
- range->adjustment->lower);
+ scroll_begin (range);
break;
case GTK_SCROLL_END:
- gtk_range_internal_set_value (range,
- range->adjustment->upper - range->adjustment->page_size);
+ scroll_end (range);
break;
case GTK_SCROLL_JUMP:
/* Policy DELAYED makes sense with key events,
* but DISCONTINUOUS doesn't, so we update immediately
- * for DISCONTINOUS
+ * for DISCONTINUOUS
*/
if (range->update_policy == GTK_UPDATE_DISCONTINUOUS)
gtk_range_update_value (range);
return NULL;
}
-static void
-gtk_range_internal_set_value (GtkRange *range,
- gdouble value)
+static gboolean
+gtk_range_real_change_value (GtkRange *range,
+ GtkScrollType scroll,
+ gdouble value)
{
/* potentially adjust the bounds _before we clamp */
- g_signal_emit (G_OBJECT (range), signals[ADJUST_BOUNDS], 0, value);
+ g_signal_emit (range, signals[ADJUST_BOUNDS], 0, value);
value = CLAMP (value, range->adjustment->lower,
(range->adjustment->upper - range->adjustment->page_size));
if (range->round_digits >= 0)
{
- char buffer[128];
+ gdouble power;
+ gint i;
- /* This is just so darn lame. */
- g_snprintf (buffer, 128, "%0.*f",
- range->round_digits, value);
- sscanf (buffer, "%lf", &value);
+ i = range->round_digits;
+ power = 1;
+ while (i--)
+ power *= 10;
+
+ value = floor ((value * power) + 0.5) / power;
}
if (range->adjustment->value != value)
break;
}
}
+ return FALSE;
}
static void
projects / ~andy / gtk / blobdiff