* Modified by the GTK+ Team and others 1997-2000. 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/.
+ * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
+#include "config.h"
+
#include <math.h>
-#include "gtkintl.h"
-#include "gtkscale.h"
-#include "gtkmarshal.h"
+#include <stdlib.h>
+
#include "gdk/gdkkeysyms.h"
+#include "gtkscale.h"
+#include "gtkmarshalers.h"
#include "gtkbindings.h"
+#include "gtkprivate.h"
+#include "gtkintl.h"
+#include "gtkalias.h"
+
+
+#define MAX_DIGITS (64) /* don't change this,
+ * a) you don't need to and
+ * b) you might cause buffer owerflows in
+ * unrelated code portions otherwise
+ */
+
+#define GTK_SCALE_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_SCALE, GtkScalePrivate))
+
+typedef struct _GtkScalePrivate GtkScalePrivate;
+
+struct _GtkScalePrivate
+{
+ PangoLayout *layout;
+};
enum {
PROP_0,
};
static guint signals[LAST_SIGNAL];
-static GtkRangeClass *parent_class = NULL;
-
-static void gtk_scale_class_init (GtkScaleClass *klass);
-static void gtk_scale_init (GtkScale *scale);
-static void gtk_scale_set_property (GObject *object,
- guint prop_id,
- const GValue *value,
- GParamSpec *pspec);
-static void gtk_scale_get_property (GObject *object,
- guint prop_id,
- GValue *value,
- GParamSpec *pspec);
-static void gtk_scale_style_set (GtkWidget *widget,
- GtkStyle *previous);
-static void gtk_scale_get_range_border (GtkRange *range,
- GtkBorder *border);
-
-GtkType
-gtk_scale_get_type (void)
-{
- static GtkType scale_type = 0;
-
- if (!scale_type)
- {
- static const GtkTypeInfo scale_info =
- {
- "GtkScale",
- sizeof (GtkScale),
- sizeof (GtkScaleClass),
- (GtkClassInitFunc) gtk_scale_class_init,
- (GtkObjectInitFunc) gtk_scale_init,
- /* reserved_1 */ NULL,
- /* reserved_2 */ NULL,
- (GtkClassInitFunc) NULL,
- };
-
- scale_type = gtk_type_unique (GTK_TYPE_RANGE, &scale_info);
- }
-
- return scale_type;
-}
-gboolean
+static void gtk_scale_set_property (GObject *object,
+ guint prop_id,
+ const GValue *value,
+ GParamSpec *pspec);
+static void gtk_scale_get_property (GObject *object,
+ guint prop_id,
+ GValue *value,
+ GParamSpec *pspec);
+static void gtk_scale_style_set (GtkWidget *widget,
+ GtkStyle *previous);
+static void gtk_scale_get_range_border (GtkRange *range,
+ GtkBorder *border);
+static void gtk_scale_finalize (GObject *object);
+static void gtk_scale_screen_changed (GtkWidget *widget,
+ GdkScreen *old_screen);
+static gboolean gtk_scale_expose (GtkWidget *widget,
+ GdkEventExpose *event);
+static void gtk_scale_real_get_layout_offsets (GtkScale *scale,
+ gint *x,
+ gint *y);
+
+G_DEFINE_TYPE (GtkScale, gtk_scale, GTK_TYPE_RANGE)
+
+static gboolean
single_string_accumulator (GSignalInvocationHint *ihint,
GValue *return_accu,
const GValue *handler_return,
gpointer dummy)
{
gboolean continue_emission;
- gchar *str;
+ const gchar *str;
str = g_value_get_string (handler_return);
g_value_set_string (return_accu, str);
}
-#define add_slider_binding(binding_set, keyval, mask, scroll) \
- gtk_binding_entry_add_signal (binding_set, keyval, mask, \
- "move_slider", 1, \
+#define add_slider_binding(binding_set, keyval, mask, scroll) \
+ gtk_binding_entry_add_signal (binding_set, keyval, mask, \
+ I_("move-slider"), 1, \
GTK_TYPE_SCROLL_TYPE, scroll)
static void
gtk_scale_class_init (GtkScaleClass *class)
{
GObjectClass *gobject_class;
- GtkObjectClass *object_class;
GtkWidgetClass *widget_class;
- GtkRangeClass *range_class;
- GtkBindingSet *binding_set;
+ GtkRangeClass *range_class;
+ GtkBindingSet *binding_set;
gobject_class = G_OBJECT_CLASS (class);
- object_class = (GtkObjectClass*) class;
range_class = (GtkRangeClass*) class;
widget_class = (GtkWidgetClass*) class;
- parent_class = gtk_type_class (GTK_TYPE_RANGE);
-
gobject_class->set_property = gtk_scale_set_property;
gobject_class->get_property = gtk_scale_get_property;
+ gobject_class->finalize = gtk_scale_finalize;
widget_class->style_set = gtk_scale_style_set;
+ widget_class->screen_changed = gtk_scale_screen_changed;
+ widget_class->expose_event = gtk_scale_expose;
+ range_class->slider_detail = "Xscale";
range_class->get_range_border = gtk_scale_get_range_border;
-
+
+ class->get_layout_offsets = gtk_scale_real_get_layout_offsets;
+
+ /**
+ * GtkScale::format-value:
+ * @scale: the object which received the signal
+ * @value: the value to format
+ *
+ * Signal which allows you to change how the scale value is displayed.
+ * Connect a signal handler which returns an allocated string representing
+ * @value. That string will then be used to display the scale's value.
+ *
+ * Here's an example signal handler which displays a value 1.0 as
+ * with "-->1.0<--".
+ * |[
+ * static gchar*
+ * format_value_callback (GtkScale *scale,
+ * gdouble value)
+ * {
+ * return g_strdup_printf ("-->%0.*g<--",
+ * gtk_scale_get_digits (scale), value);
+ * }
+ * ]|
+ *
+ * Return value: allocated string representing @value
+ */
signals[FORMAT_VALUE] =
- g_signal_newc ("format_value",
- G_TYPE_FROM_CLASS (object_class),
- G_SIGNAL_RUN_LAST,
- G_STRUCT_OFFSET (GtkScaleClass, format_value),
- single_string_accumulator, NULL,
- gtk_marshal_STRING__DOUBLE,
- G_TYPE_STRING, 1,
- G_TYPE_DOUBLE);
+ g_signal_new (I_("format-value"),
+ G_TYPE_FROM_CLASS (gobject_class),
+ G_SIGNAL_RUN_LAST,
+ G_STRUCT_OFFSET (GtkScaleClass, format_value),
+ single_string_accumulator, NULL,
+ _gtk_marshal_STRING__DOUBLE,
+ G_TYPE_STRING, 1,
+ G_TYPE_DOUBLE);
g_object_class_install_property (gobject_class,
PROP_DIGITS,
g_param_spec_int ("digits",
- _("Digits"),
- _("The number of decimal places that are displayed in the value"),
- 0,
- G_MAXINT,
- 0,
- G_PARAM_READWRITE));
+ P_("Digits"),
+ P_("The number of decimal places that are displayed in the value"),
+ -1,
+ MAX_DIGITS,
+ 1,
+ GTK_PARAM_READWRITE));
g_object_class_install_property (gobject_class,
PROP_DRAW_VALUE,
- g_param_spec_boolean ("draw_value",
- _("Draw Value"),
- _("Whether the current value is displayed as a string next to the slider"),
- FALSE,
- G_PARAM_READWRITE));
+ g_param_spec_boolean ("draw-value",
+ P_("Draw Value"),
+ P_("Whether the current value is displayed as a string next to the slider"),
+ TRUE,
+ GTK_PARAM_READWRITE));
g_object_class_install_property (gobject_class,
PROP_VALUE_POS,
- g_param_spec_enum ("value_pos",
- _("Value Position"),
- _("The position in which the current value is displayed"),
+ g_param_spec_enum ("value-pos",
+ P_("Value Position"),
+ P_("The position in which the current value is displayed"),
GTK_TYPE_POSITION_TYPE,
- GTK_POS_LEFT,
- G_PARAM_READWRITE));
+ GTK_POS_TOP,
+ GTK_PARAM_READWRITE));
gtk_widget_class_install_style_property (widget_class,
- g_param_spec_int ("slider_length",
- _("Slider Length"),
- _("Length of scale's slider"),
+ g_param_spec_int ("slider-length",
+ P_("Slider Length"),
+ P_("Length of scale's slider"),
0,
G_MAXINT,
31,
- G_PARAM_READABLE));
+ GTK_PARAM_READABLE));
gtk_widget_class_install_style_property (widget_class,
- g_param_spec_int ("value_spacing",
- _("Value spacing"),
- _("Space between value text and the slider/trough area"),
+ g_param_spec_int ("value-spacing",
+ P_("Value spacing"),
+ P_("Space between value text and the slider/trough area"),
0,
G_MAXINT,
2,
- G_PARAM_READABLE));
+ GTK_PARAM_READABLE));
/* All bindings (even arrow keys) are on both h/v scale, because
* blind users etc. don't care about scale orientation.
add_slider_binding (binding_set, GDK_KP_Left, GDK_CONTROL_MASK,
GTK_SCROLL_PAGE_LEFT);
-
add_slider_binding (binding_set, GDK_Right, 0,
GTK_SCROLL_STEP_RIGHT);
add_slider_binding (binding_set, GDK_KP_Up, GDK_CONTROL_MASK,
GTK_SCROLL_PAGE_UP);
-
add_slider_binding (binding_set, GDK_Down, 0,
GTK_SCROLL_STEP_DOWN);
add_slider_binding (binding_set, GDK_KP_Down, GDK_CONTROL_MASK,
GTK_SCROLL_PAGE_DOWN);
-
- /* I think most users will find it strange that these move
- * logically instead of visually...
- */
+ add_slider_binding (binding_set, GDK_Page_Up, GDK_CONTROL_MASK,
+ GTK_SCROLL_PAGE_LEFT);
+
+ add_slider_binding (binding_set, GDK_KP_Page_Up, GDK_CONTROL_MASK,
+ GTK_SCROLL_PAGE_LEFT);
+
add_slider_binding (binding_set, GDK_Page_Up, 0,
- GTK_SCROLL_PAGE_BACKWARD);
+ GTK_SCROLL_PAGE_UP);
add_slider_binding (binding_set, GDK_KP_Page_Up, 0,
- GTK_SCROLL_PAGE_BACKWARD);
+ GTK_SCROLL_PAGE_UP);
+
+ add_slider_binding (binding_set, GDK_Page_Down, GDK_CONTROL_MASK,
+ GTK_SCROLL_PAGE_RIGHT);
+
+ add_slider_binding (binding_set, GDK_KP_Page_Down, GDK_CONTROL_MASK,
+ GTK_SCROLL_PAGE_RIGHT);
add_slider_binding (binding_set, GDK_Page_Down, 0,
- GTK_SCROLL_PAGE_FORWARD);
+ GTK_SCROLL_PAGE_DOWN);
add_slider_binding (binding_set, GDK_KP_Page_Down, 0,
- GTK_SCROLL_PAGE_FORWARD);
+ GTK_SCROLL_PAGE_DOWN);
+
+ /* Logical bindings (vs. visual bindings above) */
+
+ add_slider_binding (binding_set, GDK_plus, 0,
+ GTK_SCROLL_STEP_FORWARD);
+
+ add_slider_binding (binding_set, GDK_minus, 0,
+ GTK_SCROLL_STEP_BACKWARD);
+
+ add_slider_binding (binding_set, GDK_plus, GDK_CONTROL_MASK,
+ GTK_SCROLL_PAGE_FORWARD);
+
+ add_slider_binding (binding_set, GDK_minus, GDK_CONTROL_MASK,
+ GTK_SCROLL_PAGE_BACKWARD);
+
+
+ add_slider_binding (binding_set, GDK_KP_Add, 0,
+ GTK_SCROLL_STEP_FORWARD);
+ add_slider_binding (binding_set, GDK_KP_Subtract, 0,
+ GTK_SCROLL_STEP_BACKWARD);
+
+ add_slider_binding (binding_set, GDK_KP_Add, GDK_CONTROL_MASK,
+ GTK_SCROLL_PAGE_FORWARD);
+
+ add_slider_binding (binding_set, GDK_KP_Subtract, GDK_CONTROL_MASK,
+ GTK_SCROLL_PAGE_BACKWARD);
+
+
add_slider_binding (binding_set, GDK_Home, 0,
GTK_SCROLL_START);
add_slider_binding (binding_set, GDK_KP_End, 0,
GTK_SCROLL_END);
+
+ g_type_class_add_private (gobject_class, sizeof (GtkScalePrivate));
+}
+
+static void
+gtk_scale_orientation_notify (GtkRange *range,
+ const GParamSpec *pspec)
+{
+ range->flippable = (range->orientation == GTK_ORIENTATION_HORIZONTAL);
+}
+
+static void
+gtk_scale_init (GtkScale *scale)
+{
+ GtkRange *range = GTK_RANGE (scale);
+
+ GTK_WIDGET_SET_FLAGS (scale, GTK_CAN_FOCUS);
+
+ range->slider_size_fixed = TRUE;
+ range->has_stepper_a = FALSE;
+ range->has_stepper_b = FALSE;
+ range->has_stepper_c = FALSE;
+ range->has_stepper_d = FALSE;
+
+ scale->draw_value = TRUE;
+ scale->value_pos = GTK_POS_TOP;
+ scale->digits = 1;
+ range->round_digits = scale->digits;
+
+ gtk_scale_orientation_notify (range, NULL);
+ g_signal_connect (scale, "notify::orientation",
+ G_CALLBACK (gtk_scale_orientation_notify),
+ NULL);
}
static void
}
}
-static void
-gtk_scale_init (GtkScale *scale)
+/**
+ * gtk_scale_new:
+ * @orientation: the scale's orientation.
+ * @adjustment: the #GtkAdjustment which sets the range of the scale, or
+ * %NULL to create a new adjustment.
+ *
+ * Creates a new #GtkScale.
+ *
+ * Return value: a new #GtkScale
+ *
+ * Since: 2.16
+ **/
+GtkWidget *
+gtk_scale_new (GtkOrientation orientation,
+ GtkAdjustment *adjustment)
{
- GtkRange *range;
+ g_return_val_if_fail (adjustment == NULL || GTK_IS_ADJUSTMENT (adjustment),
+ NULL);
- range = GTK_RANGE (scale);
-
- GTK_WIDGET_SET_FLAGS (scale, GTK_CAN_FOCUS);
+ return g_object_new (GTK_TYPE_SCALE,
+ "orientation", orientation,
+ "adjustment", adjustment,
+ NULL);
+}
- range->slider_size_fixed = TRUE;
- range->has_stepper_a = FALSE;
- range->has_stepper_b = FALSE;
- range->has_stepper_c = FALSE;
- range->has_stepper_d = FALSE;
-
- scale->draw_value = TRUE;
- scale->value_pos = GTK_POS_TOP;
- scale->digits = 1;
- range->round_digits = scale->digits;
+/**
+ * gtk_scale_new_with_range:
+ * @orientation: the scale's orientation.
+ * @min: minimum value
+ * @max: maximum value
+ * @step: step increment (tick size) used with keyboard shortcuts
+ *
+ * Creates a new scale widget with the given orientation that lets the
+ * user input a number between @min and @max (including @min and @max)
+ * with the increment @step. @step must be nonzero; it's the distance
+ * the slider moves when using the arrow keys to adjust the scale
+ * value.
+ *
+ * Note that the way in which the precision is derived works best if @step
+ * is a power of ten. If the resulting precision is not suitable for your
+ * needs, use gtk_scale_set_digits() to correct it.
+ *
+ * Return value: a new #GtkScale
+ *
+ * Since: 2.16
+ **/
+GtkWidget *
+gtk_scale_new_with_range (GtkOrientation orientation,
+ gdouble min,
+ gdouble max,
+ gdouble step)
+{
+ GtkObject *adj;
+ gint digits;
+
+ g_return_val_if_fail (min < max, NULL);
+ g_return_val_if_fail (step != 0.0, NULL);
+
+ adj = gtk_adjustment_new (min, min, max, step, 10 * step, 0);
+
+ if (fabs (step) >= 1.0 || step == 0.0)
+ {
+ digits = 0;
+ }
+ else
+ {
+ digits = abs ((gint) floor (log10 (fabs (step))));
+ if (digits > 5)
+ digits = 5;
+ }
+
+ return g_object_new (GTK_TYPE_SCALE,
+ "orientation", orientation,
+ "adjustment", adj,
+ "digits", digits,
+ NULL);
}
+/**
+ * gtk_scale_set_digits:
+ * @scale: a #GtkScale
+ * @digits: the number of decimal places to display,
+ * e.g. use 1 to display 1.0, 2 to display 1.00, etc
+ *
+ * Sets the number of decimal places that are displayed in the value.
+ * Also causes the value of the adjustment to be rounded off to this
+ * number of digits, so the retrieved value matches the value the user saw.
+ */
void
gtk_scale_set_digits (GtkScale *scale,
gint digits)
range = GTK_RANGE (scale);
- digits = CLAMP (digits, -1, 16);
+ digits = CLAMP (digits, -1, MAX_DIGITS);
if (scale->digits != digits)
{
scale->digits = digits;
- range->round_digits = digits;
+ if (scale->draw_value)
+ range->round_digits = digits;
+ _gtk_scale_clear_layout (scale);
gtk_widget_queue_resize (GTK_WIDGET (scale));
g_object_notify (G_OBJECT (scale), "digits");
}
}
+/**
+ * gtk_scale_get_digits:
+ * @scale: a #GtkScale
+ *
+ * Gets the number of decimal places that are displayed in the value.
+ *
+ * Returns: the number of decimal places that are displayed
+ */
gint
gtk_scale_get_digits (GtkScale *scale)
{
return scale->digits;
}
+/**
+ * gtk_scale_set_draw_value:
+ * @scale: a #GtkScale
+ * @draw_value: %TRUE to draw the value
+ *
+ * Specifies whether the current value is displayed as a string next
+ * to the slider.
+ */
void
gtk_scale_set_draw_value (GtkScale *scale,
gboolean draw_value)
{
- g_return_if_fail (scale != NULL);
g_return_if_fail (GTK_IS_SCALE (scale));
draw_value = draw_value != FALSE;
if (scale->draw_value != draw_value)
{
scale->draw_value = draw_value;
+ if (draw_value)
+ GTK_RANGE (scale)->round_digits = scale->digits;
+ else
+ GTK_RANGE (scale)->round_digits = -1;
+
+ _gtk_scale_clear_layout (scale);
gtk_widget_queue_resize (GTK_WIDGET (scale));
- g_object_notify (G_OBJECT (scale), "draw_value");
+ g_object_notify (G_OBJECT (scale), "draw-value");
}
}
+/**
+ * gtk_scale_get_draw_value:
+ * @scale: a #GtkScale
+ *
+ * Returns whether the current value is displayed as a string
+ * next to the slider.
+ *
+ * Returns: whether the current value is displayed as a string
+ */
gboolean
gtk_scale_get_draw_value (GtkScale *scale)
{
return scale->draw_value;
}
+/**
+ * gtk_scale_set_value_pos:
+ * @scale: a #GtkScale
+ * @pos: the position in which the current value is displayed
+ *
+ * Sets the position in which the current value is displayed.
+ */
void
gtk_scale_set_value_pos (GtkScale *scale,
GtkPositionType pos)
{
scale->value_pos = pos;
+ _gtk_scale_clear_layout (scale);
if (GTK_WIDGET_VISIBLE (scale) && GTK_WIDGET_MAPPED (scale))
gtk_widget_queue_resize (GTK_WIDGET (scale));
- g_object_notify (G_OBJECT (scale), "value_pos");
+ g_object_notify (G_OBJECT (scale), "value-pos");
}
}
+/**
+ * gtk_scale_get_value_pos:
+ * @scale: a #GtkScale
+ *
+ * Gets the position in which the current value is displayed.
+ *
+ * Returns: the position in which the current value is displayed
+ */
GtkPositionType
gtk_scale_get_value_pos (GtkScale *scale)
{
if (scale->draw_value)
{
gint value_spacing;
- gtk_widget_style_get (widget, "value_spacing", &value_spacing, NULL);
+ gtk_widget_style_get (widget, "value-spacing", &value_spacing, NULL);
switch (scale->value_pos)
{
{
GtkRange *range;
- g_return_if_fail (scale != NULL);
g_return_if_fail (GTK_IS_SCALE (scale));
if (scale->draw_value)
if (height)
*height = MAX (*height, logical_rect.height);
- g_object_unref (G_OBJECT (layout));
+ g_object_unref (layout);
}
else
{
range = GTK_RANGE (widget);
gtk_widget_style_get (widget,
- "slider_length", &slider_length,
+ "slider-length", &slider_length,
NULL);
range->min_slider_size = slider_length;
- (* GTK_WIDGET_CLASS (parent_class)->style_set) (widget, previous);
+ _gtk_scale_clear_layout (GTK_SCALE (widget));
+
+ GTK_WIDGET_CLASS (gtk_scale_parent_class)->style_set (widget, previous);
+}
+
+static void
+gtk_scale_screen_changed (GtkWidget *widget,
+ GdkScreen *old_screen)
+{
+ _gtk_scale_clear_layout (GTK_SCALE (widget));
+}
+
+static gboolean
+gtk_scale_expose (GtkWidget *widget,
+ GdkEventExpose *event)
+{
+ GtkScale *scale = GTK_SCALE (widget);
+
+ /* We need to chain up _first_ so the various geometry members of
+ * GtkRange struct are updated.
+ */
+ GTK_WIDGET_CLASS (gtk_scale_parent_class)->expose_event (widget, event);
+
+ if (scale->draw_value)
+ {
+ GtkRange *range = GTK_RANGE (scale);
+ PangoLayout *layout;
+ gint x, y;
+ GtkStateType state_type;
+
+ layout = gtk_scale_get_layout (scale);
+ gtk_scale_get_layout_offsets (scale, &x, &y);
+
+ state_type = GTK_STATE_NORMAL;
+ if (!GTK_WIDGET_IS_SENSITIVE (scale))
+ state_type = GTK_STATE_INSENSITIVE;
+
+ gtk_paint_layout (widget->style,
+ widget->window,
+ state_type,
+ FALSE,
+ NULL,
+ widget,
+ range->orientation == GTK_ORIENTATION_HORIZONTAL ?
+ "hscale" : "vscale",
+ x, y,
+ layout);
+
+ }
+
+ return FALSE;
}
+static void
+gtk_scale_real_get_layout_offsets (GtkScale *scale,
+ gint *x,
+ gint *y)
+{
+ GtkWidget *widget = GTK_WIDGET (scale);
+ GtkRange *range = GTK_RANGE (widget);
+ PangoLayout *layout = gtk_scale_get_layout (scale);
+ PangoRectangle logical_rect;
+ gint value_spacing;
+
+ if (!layout)
+ {
+ *x = 0;
+ *y = 0;
+
+ return;
+ }
+
+ gtk_widget_style_get (widget, "value-spacing", &value_spacing, NULL);
+
+ pango_layout_get_pixel_extents (layout, NULL, &logical_rect);
+
+ if (range->orientation == GTK_ORIENTATION_HORIZONTAL)
+ {
+ switch (scale->value_pos)
+ {
+ case GTK_POS_LEFT:
+ *x = range->range_rect.x - value_spacing - logical_rect.width;
+ *y = range->range_rect.y + (range->range_rect.height - logical_rect.height) / 2;
+ break;
+
+ case GTK_POS_RIGHT:
+ *x = range->range_rect.x + range->range_rect.width + value_spacing;
+ *y = range->range_rect.y + (range->range_rect.height - logical_rect.height) / 2;
+ break;
+
+ case GTK_POS_TOP:
+ *x = range->slider_start +
+ (range->slider_end - range->slider_start - logical_rect.width) / 2;
+ *x = CLAMP (*x, 0, widget->allocation.width - logical_rect.width);
+ *y = range->range_rect.y - logical_rect.height - value_spacing;
+ break;
+
+ case GTK_POS_BOTTOM:
+ *x = range->slider_start +
+ (range->slider_end - range->slider_start - logical_rect.width) / 2;
+ *x = CLAMP (*x, 0, widget->allocation.width - logical_rect.width);
+ *y = range->range_rect.y + range->range_rect.height + value_spacing;
+ break;
+
+ default:
+ g_return_if_reached ();
+ break;
+ }
+ }
+ else
+ {
+ switch (scale->value_pos)
+ {
+ case GTK_POS_LEFT:
+ *x = range->range_rect.x - logical_rect.width - value_spacing;
+ *y = range->slider_start + (range->slider_end - range->slider_start - logical_rect.height) / 2;
+ *y = CLAMP (*y, 0, widget->allocation.height - logical_rect.height);
+ break;
+
+ case GTK_POS_RIGHT:
+ *x = range->range_rect.x + range->range_rect.width + value_spacing;
+ *y = range->slider_start + (range->slider_end - range->slider_start - logical_rect.height) / 2;
+ *y = CLAMP (*y, 0, widget->allocation.height - logical_rect.height);
+ break;
+
+ case GTK_POS_TOP:
+ *x = range->range_rect.x + (range->range_rect.width - logical_rect.width) / 2;
+ *y = range->range_rect.y - logical_rect.height - value_spacing;
+ break;
+
+ case GTK_POS_BOTTOM:
+ *x = range->range_rect.x + (range->range_rect.width - logical_rect.width) / 2;
+ *y = range->range_rect.y + range->range_rect.height + value_spacing;
+ break;
+
+ default:
+ g_return_if_reached ();
+ }
+ }
+
+ *x += widget->allocation.x;
+ *y += widget->allocation.y;
+}
/**
* _gtk_scale_format_value:
* @scale: a #GtkScale
* @value: adjustment value
*
- * Emits "format_value" signal to format the value, if no user
- * signal handlers, falls back to a default format.
+ * Emits #GtkScale::format-value signal to format the value,
+ * if no user signal handlers, falls back to a default format.
*
* Return value: formatted value
- **/
+ */
gchar*
_gtk_scale_format_value (GtkScale *scale,
gdouble value)
{
gchar *fmt = NULL;
- g_signal_emit (G_OBJECT (scale),
+ g_signal_emit (scale,
signals[FORMAT_VALUE],
0,
value,
if (fmt)
return fmt;
else
- return g_strdup_printf ("%0.*f", scale->digits,
- value);
+ /* insert a LRM, to prevent -20 to come out as 20- in RTL locales */
+ return g_strdup_printf ("\342\200\216%0.*f", scale->digits, value);
+}
+
+static void
+gtk_scale_finalize (GObject *object)
+{
+ GtkScale *scale = GTK_SCALE (object);
+
+ _gtk_scale_clear_layout (scale);
+
+ G_OBJECT_CLASS (gtk_scale_parent_class)->finalize (object);
+}
+
+/**
+ * gtk_scale_get_layout:
+ * @scale: A #GtkScale
+ *
+ * Gets the #PangoLayout used to display the scale.
+ * The returned object is owned by the scale so does
+ * not need to be freed by the caller.
+ *
+ * Return value: the #PangoLayout for this scale, or %NULL
+ * if the #GtkScale:draw-value property is %FALSE.
+ *
+ * Since: 2.4
+ */
+PangoLayout *
+gtk_scale_get_layout (GtkScale *scale)
+{
+ GtkScalePrivate *priv = GTK_SCALE_GET_PRIVATE (scale);
+ gchar *txt;
+
+ g_return_val_if_fail (GTK_IS_SCALE (scale), NULL);
+
+ if (!priv->layout)
+ {
+ if (scale->draw_value)
+ priv->layout = gtk_widget_create_pango_layout (GTK_WIDGET (scale), NULL);
+ }
+
+ if (scale->draw_value)
+ {
+ txt = _gtk_scale_format_value (scale,
+ GTK_RANGE (scale)->adjustment->value);
+ pango_layout_set_text (priv->layout, txt, -1);
+ g_free (txt);
+ }
+
+ return priv->layout;
+}
+
+/**
+ * gtk_scale_get_layout_offsets:
+ * @scale: a #GtkScale
+ * @x: location to store X offset of layout, or %NULL
+ * @y: location to store Y offset of layout, or %NULL
+ *
+ * Obtains the coordinates where the scale will draw the
+ * #PangoLayout representing the text in the scale. Remember
+ * when using the #PangoLayout function you need to convert to
+ * and from pixels using PANGO_PIXELS() or #PANGO_SCALE.
+ *
+ * If the #GtkScale:draw-value property is %FALSE, the return
+ * values are undefined.
+ *
+ * Since: 2.4
+ */
+void
+gtk_scale_get_layout_offsets (GtkScale *scale,
+ gint *x,
+ gint *y)
+{
+ gint local_x = 0;
+ gint local_y = 0;
+
+ g_return_if_fail (GTK_IS_SCALE (scale));
+
+ if (GTK_SCALE_GET_CLASS (scale)->get_layout_offsets)
+ (GTK_SCALE_GET_CLASS (scale)->get_layout_offsets) (scale, &local_x, &local_y);
+
+ if (x)
+ *x = local_x;
+
+ if (y)
+ *y = local_y;
+}
+
+void
+_gtk_scale_clear_layout (GtkScale *scale)
+{
+ GtkScalePrivate *priv = GTK_SCALE_GET_PRIVATE (scale);
+
+ g_return_if_fail (GTK_IS_SCALE (scale));
+
+ if (priv->layout)
+ {
+ g_object_unref (priv->layout);
+ priv->layout = NULL;
+ }
}
+
+#define __GTK_SCALE_C__
+#include "gtkaliasdef.c"