Pileus Git - ~andy/gtk/blob - gtk/gtkspinbutton.c

   1 /* GTK - The GIMP Toolkit
   2  * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
   3  *
   4  * GtkSpinButton widget for GTK+
   5  * Copyright (C) 1998 Lars Hamann and Stefan Jeske
   6  *
   7  * This library is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU Lesser General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 2 of the License, or (at your option) any later version.
  11  *
  12  * This library is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Lesser General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Lesser General Public
  18  * License along with this library; if not, write to the
  19  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  20  * Boston, MA 02111-1307, USA.
  21  */
  22
  23 /*
  24  * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
  25  * file for a list of people on the GTK+ Team.  See the ChangeLog
  26  * files for a list of changes.  These files are distributed with
  27  * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
  28  */
  29
  30 #include <stdio.h>
  31 #include <stdlib.h>
  32 #include <math.h>
  33 #include <string.h>
  34 #include <locale.h>
  35 #include "gdk/gdkkeysyms.h"
  36 #include "gtkspinbutton.h"
  37 #include "gtkmain.h"
  38 #include "gtksignal.h"
  39 #include "gtksettings.h"
  40 #include "gtkintl.h"
  41
  42 #define MIN_SPIN_BUTTON_WIDTH              30
  43 #define ARROW_SIZE                         11
  44 #define SPIN_BUTTON_INITIAL_TIMER_DELAY    200
  45 #define SPIN_BUTTON_TIMER_DELAY            20
  46 #define MAX_TIMER_CALLS                    5
  47 #define EPSILON                            1e-5
  48 #define MAX_DIGITS                         20
  49
  50 enum {
  51   PROP_0,
  52   PROP_ADJUSTMENT,
  53   PROP_CLIMB_RATE,
  54   PROP_DIGITS,
  55   PROP_SNAP_TO_TICKS,
  56   PROP_NUMERIC,
  57   PROP_WRAP,
  58   PROP_UPDATE_POLICY,
  59   PROP_VALUE
  60 };
  61
  62 /* Signals */
  63 enum
  64 {
  65   INPUT,
  66   OUTPUT,
  67   VALUE_CHANGED,
  68   LAST_SIGNAL
  69 };
  70
  71 static void gtk_spin_button_class_init     (GtkSpinButtonClass *klass);
  72 static void gtk_spin_button_init           (GtkSpinButton      *spin_button);
  73 static void gtk_spin_button_finalize       (GObject            *object);
  74 static void gtk_spin_button_set_property   (GObject         *object,
  75                                             guint            prop_id,
  76                                             const GValue    *value,
  77                                             GParamSpec      *pspec);
  78 static void gtk_spin_button_get_property   (GObject         *object,
  79                                             guint            prop_id,
  80                                             GValue          *value,
  81                                             GParamSpec      *pspec);
  82 static void gtk_spin_button_map            (GtkWidget          *widget);
  83 static void gtk_spin_button_unmap          (GtkWidget          *widget);
  84 static void gtk_spin_button_realize        (GtkWidget          *widget);
  85 static void gtk_spin_button_unrealize      (GtkWidget          *widget);
  86 static void gtk_spin_button_size_request   (GtkWidget          *widget,
  87                                             GtkRequisition     *requisition);
  88 static void gtk_spin_button_size_allocate  (GtkWidget          *widget,
  89                                             GtkAllocation      *allocation);
  90 static gint gtk_spin_button_expose         (GtkWidget          *widget,
  91                                             GdkEventExpose     *event);
  92 static gint gtk_spin_button_button_press   (GtkWidget          *widget,
  93                                             GdkEventButton     *event);
  94 static gint gtk_spin_button_button_release (GtkWidget          *widget,
  95                                             GdkEventButton     *event);
  96 static gint gtk_spin_button_motion_notify  (GtkWidget          *widget,
  97                                             GdkEventMotion     *event);
  98 static gint gtk_spin_button_enter_notify   (GtkWidget          *widget,
  99                                             GdkEventCrossing   *event);
 100 static gint gtk_spin_button_leave_notify   (GtkWidget          *widget,
 101                                             GdkEventCrossing   *event);
 102 static gint gtk_spin_button_focus_out      (GtkWidget          *widget,
 103                                             GdkEventFocus      *event);
 104 static void gtk_spin_button_draw_arrow     (GtkSpinButton      *spin_button,
 105                                             guint               arrow);
 106 static gint gtk_spin_button_timer          (GtkSpinButton      *spin_button);
 107 static void gtk_spin_button_value_changed  (GtkAdjustment      *adjustment,
 108                                             GtkSpinButton      *spin_button);
 109 static gint gtk_spin_button_key_press      (GtkWidget          *widget,
 110                                             GdkEventKey        *event);
 111 static gint gtk_spin_button_key_release    (GtkWidget          *widget,
 112                                             GdkEventKey        *event);
 113 static gint gtk_spin_button_scroll         (GtkWidget          *widget,
 114                                             GdkEventScroll     *event);
 115 static void gtk_spin_button_activate       (GtkEntry           *entry);
 116 static void gtk_spin_button_snap           (GtkSpinButton      *spin_button,
 117                                             gdouble             val);
 118 static void gtk_spin_button_insert_text    (GtkEntry           *entry,
 119                                             const gchar        *new_text,
 120                                             gint                new_text_length,
 121                                             gint               *position);
 122 static void gtk_spin_button_real_spin      (GtkSpinButton      *spin_button,
 123                                             gdouble             step);
 124 static gint gtk_spin_button_default_input  (GtkSpinButton      *spin_button,
 125                                             gdouble            *new_val);
 126 static gint gtk_spin_button_default_output (GtkSpinButton      *spin_button);
 127 static gint spin_button_get_shadow_type    (GtkSpinButton      *spin_button);
 128
 129
 130 static GtkEntryClass *parent_class = NULL;
 131 static guint spinbutton_signals[LAST_SIGNAL] = {0};
 132
 133
 134 GtkType
 135 gtk_spin_button_get_type (void)
 136 {
 137   static guint spin_button_type = 0;
 138
 139   if (!spin_button_type)
 140     {
 141       static const GtkTypeInfo spin_button_info =
 142       {
 143         "GtkSpinButton",
 144         sizeof (GtkSpinButton),
 145         sizeof (GtkSpinButtonClass),
 146         (GtkClassInitFunc) gtk_spin_button_class_init,
 147         (GtkObjectInitFunc) gtk_spin_button_init,
 148         /* reserved_1 */ NULL,
 149         /* reserved_2 */ NULL,
 150         (GtkClassInitFunc) NULL,
 151       };
 152
 153       spin_button_type = gtk_type_unique (GTK_TYPE_ENTRY, &spin_button_info);
 154     }
 155   return spin_button_type;
 156 }
 157
 158 static void
 159 gtk_spin_button_class_init (GtkSpinButtonClass *class)
 160 {
 161   GObjectClass     *gobject_class = G_OBJECT_CLASS (class);
 162   GtkObjectClass   *object_class;
 163   GtkWidgetClass   *widget_class;
 164   GtkEntryClass    *entry_class;
 165
 166   object_class   = (GtkObjectClass*)   class;
 167   widget_class   = (GtkWidgetClass*)   class;
 168   entry_class    = (GtkEntryClass*)    class;
 169
 170   parent_class = gtk_type_class (GTK_TYPE_ENTRY);
 171
 172   gobject_class->finalize = gtk_spin_button_finalize;
 173
 174   gobject_class->set_property = gtk_spin_button_set_property;
 175   gobject_class->get_property = gtk_spin_button_get_property;
 176
 177   widget_class->map = gtk_spin_button_map;
 178   widget_class->unmap = gtk_spin_button_unmap;
 179   widget_class->realize = gtk_spin_button_realize;
 180   widget_class->unrealize = gtk_spin_button_unrealize;
 181   widget_class->size_request = gtk_spin_button_size_request;
 182   widget_class->size_allocate = gtk_spin_button_size_allocate;
 183   widget_class->expose_event = gtk_spin_button_expose;
 184   widget_class->scroll_event = gtk_spin_button_scroll;
 185   widget_class->button_press_event = gtk_spin_button_button_press;
 186   widget_class->button_release_event = gtk_spin_button_button_release;
 187   widget_class->motion_notify_event = gtk_spin_button_motion_notify;
 188   widget_class->key_press_event = gtk_spin_button_key_press;
 189   widget_class->key_release_event = gtk_spin_button_key_release;
 190   widget_class->enter_notify_event = gtk_spin_button_enter_notify;
 191   widget_class->leave_notify_event = gtk_spin_button_leave_notify;
 192   widget_class->focus_out_event = gtk_spin_button_focus_out;
 193
 194   entry_class->insert_text = gtk_spin_button_insert_text;
 195   entry_class->activate = gtk_spin_button_activate;
 196
 197   class->input = NULL;
 198   class->output = NULL;
 199
 200   g_object_class_install_property (gobject_class,
 201                                    PROP_ADJUSTMENT,
 202                                    g_param_spec_object ("adjustment",
 203                                                         _("Adjustment"),
 204                                                         _("The adjustment that holds the value of the spinbutton"),
 205                                                         GTK_TYPE_ADJUSTMENT,
 206                                                         G_PARAM_READWRITE));
 207
 208   g_object_class_install_property (gobject_class,
 209                                    PROP_CLIMB_RATE,
 210                                    g_param_spec_double ("climb_rate",
 211                                                         _("Climb Rate"),
 212                                                         _("The acceleration rate when you hold down a button"),
 213                                                         0.0,
 214                                                         G_MAXDOUBLE,
 215                                                         0.0,
 216                                                         G_PARAM_READWRITE));
 217
 218   g_object_class_install_property (gobject_class,
 219                                    PROP_DIGITS,
 220                                    g_param_spec_uint ("digits",
 221                                                       _("Digits"),
 222                                                       _("The number of decimal places to display"),
 223                                                       0,
 224                                                       MAX_DIGITS,
 225                                                       0,
 226                                                       G_PARAM_READWRITE));
 227
 228   g_object_class_install_property (gobject_class,
 229                                    PROP_SNAP_TO_TICKS,
 230                                    g_param_spec_boolean ("snap_to_ticks",
 231                                                          _("Snap to Ticks"),
 232                                                          _("Whether erroneous values are automatically changed to a spin button's nearest step increment"),
 233                                                          FALSE,
 234                                                          G_PARAM_READWRITE));
 235
 236   g_object_class_install_property (gobject_class,
 237                                    PROP_NUMERIC,
 238                                    g_param_spec_boolean ("numeric",
 239                                                          _("Numeric"),
 240                                                          _("Whether non-numeric characters should be ignored"),
 241                                                          FALSE,
 242                                                          G_PARAM_READWRITE));
 243
 244   g_object_class_install_property (gobject_class,
 245                                    PROP_WRAP,
 246                                    g_param_spec_boolean ("wrap",
 247                                                          _("Wrap"),
 248                                                          _("Whether a spin button should wrap upon reaching its limits"),
 249                                                          FALSE,
 250                                                          G_PARAM_READWRITE));
 251
 252   g_object_class_install_property (gobject_class,
 253                                    PROP_UPDATE_POLICY,
 254                                    g_param_spec_enum ("update_policy",
 255                                                       _("Update Policy"),
 256                                                       _("Whether the spin button should update always, or only when the value is legal"),
 257                                                       GTK_TYPE_SPIN_BUTTON_UPDATE_POLICY,
 258                                                       GTK_UPDATE_ALWAYS,
 259                                                       G_PARAM_READWRITE));
 260
 261   g_object_class_install_property (gobject_class,
 262                                    PROP_VALUE,
 263                                    g_param_spec_double ("value",
 264                                                         _("Value"),
 265                                                         _("Reads the current value, or sets a new value"),
 266                                                         -G_MAXDOUBLE,
 267                                                         G_MAXDOUBLE,
 268                                                         0.0,
 269                                                         G_PARAM_READWRITE));
 270
 271   gtk_widget_class_install_style_property_parser (widget_class,
 272                                                   g_param_spec_enum ("shadow_type", "Shadow Type", NULL,
 273                                                                      GTK_TYPE_SHADOW_TYPE,
 274                                                                      GTK_SHADOW_IN,
 275                                                                      G_PARAM_READABLE),
 276                                                   gtk_rc_property_parse_enum);
 277   spinbutton_signals[INPUT] =
 278     gtk_signal_new ("input",
 279                     GTK_RUN_LAST,
 280                     GTK_CLASS_TYPE (object_class),
 281                     GTK_SIGNAL_OFFSET (GtkSpinButtonClass, input),
 282                     gtk_marshal_INT__POINTER,
 283                     GTK_TYPE_INT, 1, GTK_TYPE_POINTER);
 284
 285   spinbutton_signals[OUTPUT] =
 286     g_signal_new ("output",
 287                   G_TYPE_FROM_CLASS(object_class),
 288                   G_SIGNAL_RUN_LAST,
 289                   G_STRUCT_OFFSET(GtkSpinButtonClass, output),
 290                   _gtk_boolean_handled_accumulator, NULL,
 291                   gtk_marshal_BOOLEAN__VOID,
 292                   G_TYPE_BOOLEAN, 0);
 293
 294   spinbutton_signals[VALUE_CHANGED] =
 295     gtk_signal_new ("value_changed",
 296                     GTK_RUN_LAST,
 297                     GTK_CLASS_TYPE (object_class),
 298                     GTK_SIGNAL_OFFSET (GtkSpinButtonClass, value_changed),
 299                     gtk_marshal_VOID__VOID,
 300                     GTK_TYPE_NONE, 0);
 301 }
 302
 303 static void
 304 gtk_spin_button_set_property (GObject      *object,
 305                               guint         prop_id,
 306                               const GValue *value,
 307                               GParamSpec   *pspec)
 308 {
 309   GtkSpinButton *spin_button;
 310
 311   spin_button = GTK_SPIN_BUTTON (object);
 312
 313   switch (prop_id)
 314     {
 315       GtkAdjustment *adjustment;
 316
 317     case PROP_ADJUSTMENT:
 318       adjustment = GTK_ADJUSTMENT (g_value_get_object (value));
 319       if (!adjustment)
 320         adjustment = (GtkAdjustment*) gtk_adjustment_new (0.0, 0.0, 0.0, 0.0, 0.0, 0.0);
 321       gtk_spin_button_set_adjustment (spin_button, adjustment);
 322       break;
 323     case PROP_CLIMB_RATE:
 324       gtk_spin_button_configure (spin_button,
 325                                  spin_button->adjustment,
 326                                  g_value_get_double (value),
 327                                  spin_button->digits);
 328       break;
 329     case PROP_DIGITS:
 330       gtk_spin_button_configure (spin_button,
 331                                  spin_button->adjustment,
 332                                  spin_button->climb_rate,
 333                                  g_value_get_uint (value));
 334       break;
 335     case PROP_SNAP_TO_TICKS:
 336       gtk_spin_button_set_snap_to_ticks (spin_button, g_value_get_boolean (value));
 337       break;
 338     case PROP_NUMERIC:
 339       gtk_spin_button_set_numeric (spin_button, g_value_get_boolean (value));
 340       break;
 341     case PROP_WRAP:
 342       gtk_spin_button_set_wrap (spin_button, g_value_get_boolean (value));
 343       break;
 344     case PROP_UPDATE_POLICY:
 345       gtk_spin_button_set_update_policy (spin_button, g_value_get_enum (value));
 346       break;
 347     case PROP_VALUE:
 348       gtk_spin_button_set_value (spin_button, g_value_get_double (value));
 349       break;
 350     default:
 351       break;
 352     }
 353 }
 354
 355 static void
 356 gtk_spin_button_get_property (GObject      *object,
 357                               guint         prop_id,
 358                               GValue       *value,
 359                               GParamSpec   *pspec)
 360 {
 361   GtkSpinButton *spin_button;
 362
 363   spin_button = GTK_SPIN_BUTTON (object);
 364
 365   switch (prop_id)
 366     {
 367     case PROP_ADJUSTMENT:
 368       g_value_set_object (value, G_OBJECT (spin_button->adjustment));
 369       break;
 370     case PROP_CLIMB_RATE:
 371       g_value_set_double (value, spin_button->climb_rate);
 372       break;
 373     case PROP_DIGITS:
 374       g_value_set_uint (value, spin_button->digits);
 375       break;
 376     case PROP_SNAP_TO_TICKS:
 377       g_value_set_boolean (value, spin_button->snap_to_ticks);
 378       break;
 379     case PROP_NUMERIC:
 380       g_value_set_boolean (value, spin_button->numeric);
 381       break;
 382     case PROP_WRAP:
 383       g_value_set_boolean (value, spin_button->wrap);
 384       break;
 385     case PROP_UPDATE_POLICY:
 386       g_value_set_enum (value, spin_button->update_policy);
 387       break;
 388      case PROP_VALUE:
 389        g_value_set_double (value, spin_button->adjustment->value);
 390       break;
 391     default:
 392       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
 393       break;
 394     }
 395 }
 396
 397 static void
 398 gtk_spin_button_init (GtkSpinButton *spin_button)
 399 {
 400   spin_button->adjustment = NULL;
 401   spin_button->panel = NULL;
 402   spin_button->timer = 0;
 403   spin_button->ev_time = 0;
 404   spin_button->climb_rate = 0.0;
 405   spin_button->timer_step = 0.0;
 406   spin_button->update_policy = GTK_UPDATE_ALWAYS;
 407   spin_button->in_child = 2;
 408   spin_button->click_child = 2;
 409   spin_button->button = 0;
 410   spin_button->need_timer = FALSE;
 411   spin_button->timer_calls = 0;
 412   spin_button->digits = 0;
 413   spin_button->numeric = FALSE;
 414   spin_button->wrap = FALSE;
 415   spin_button->snap_to_ticks = FALSE;
 416   gtk_spin_button_set_adjustment (spin_button,
 417           (GtkAdjustment*) gtk_adjustment_new (0, 0, 0, 0, 0, 0));
 418 }
 419
 420 static void
 421 gtk_spin_button_finalize (GObject *object)
 422 {
 423   g_return_if_fail (GTK_IS_SPIN_BUTTON (object));
 424
 425   gtk_object_unref (GTK_OBJECT (GTK_SPIN_BUTTON (object)->adjustment));
 426
 427   G_OBJECT_CLASS (parent_class)->finalize (object);
 428 }
 429
 430 static void
 431 gtk_spin_button_map (GtkWidget *widget)
 432 {
 433   g_return_if_fail (widget != NULL);
 434   g_return_if_fail (GTK_IS_SPIN_BUTTON (widget));
 435
 436   if (GTK_WIDGET_REALIZED (widget) && !GTK_WIDGET_MAPPED (widget))
 437     {
 438       GTK_WIDGET_CLASS (parent_class)->map (widget);
 439       gdk_window_show (GTK_SPIN_BUTTON (widget)->panel);
 440     }
 441 }
 442
 443 static void
 444 gtk_spin_button_unmap (GtkWidget *widget)
 445 {
 446   g_return_if_fail (widget != NULL);
 447   g_return_if_fail (GTK_IS_SPIN_BUTTON (widget));
 448
 449   if (GTK_WIDGET_MAPPED (widget))
 450     {
 451       gdk_window_hide (GTK_SPIN_BUTTON (widget)->panel);
 452       GTK_WIDGET_CLASS (parent_class)->unmap (widget);
 453     }
 454 }
 455
 456 static void
 457 gtk_spin_button_realize (GtkWidget *widget)
 458 {
 459   GtkSpinButton *spin_button;
 460   GdkWindowAttr attributes;
 461   gint attributes_mask;
 462   guint real_width;
 463   gint return_val;
 464
 465   g_return_if_fail (widget != NULL);
 466   g_return_if_fail (GTK_IS_SPIN_BUTTON (widget));
 467
 468   spin_button = GTK_SPIN_BUTTON (widget);
 469
 470   real_width = widget->allocation.width;
 471   widget->allocation.width -= ARROW_SIZE + 2 * widget->style->xthickness;
 472   gtk_widget_set_events (widget, gtk_widget_get_events (widget) |
 473                          GDK_KEY_RELEASE_MASK);
 474   GTK_WIDGET_CLASS (parent_class)->realize (widget);
 475
 476   widget->allocation.width = real_width;
 477
 478   attributes.window_type = GDK_WINDOW_CHILD;
 479   attributes.wclass = GDK_INPUT_OUTPUT;
 480   attributes.visual = gtk_widget_get_visual (widget);
 481   attributes.colormap = gtk_widget_get_colormap (widget);
 482   attributes.event_mask = gtk_widget_get_events (widget);
 483   attributes.event_mask |= GDK_EXPOSURE_MASK | GDK_BUTTON_PRESS_MASK
 484     | GDK_BUTTON_RELEASE_MASK | GDK_LEAVE_NOTIFY_MASK | GDK_ENTER_NOTIFY_MASK
 485     | GDK_POINTER_MOTION_MASK | GDK_POINTER_MOTION_HINT_MASK;
 486
 487   attributes_mask = GDK_WA_X | GDK_WA_Y | GDK_WA_VISUAL | GDK_WA_COLORMAP;
 488
 489   attributes.x = (widget->allocation.x + widget->allocation.width - ARROW_SIZE -
 490                   2 * widget->style->xthickness);
 491   attributes.y = widget->allocation.y + (widget->allocation.height -
 492                                          widget->requisition.height) / 2;
 493   attributes.width = ARROW_SIZE + 2 * widget->style->xthickness;
 494   attributes.height = widget->requisition.height;
 495
 496   spin_button->panel = gdk_window_new (gtk_widget_get_parent_window (widget),
 497                                        &attributes, attributes_mask);
 498   gdk_window_set_user_data (spin_button->panel, widget);
 499
 500   gtk_style_set_background (widget->style, spin_button->panel, GTK_STATE_NORMAL);
 501
 502   return_val = FALSE;
 503   gtk_signal_emit (GTK_OBJECT (spin_button), spinbutton_signals[OUTPUT],
 504                    &return_val);
 505   if (return_val == FALSE)
 506     gtk_spin_button_default_output (spin_button);
 507 }
 508
 509 static void
 510 gtk_spin_button_unrealize (GtkWidget *widget)
 511 {
 512   GtkSpinButton *spin;
 513
 514   g_return_if_fail (widget != NULL);
 515   g_return_if_fail (GTK_IS_SPIN_BUTTON (widget));
 516
 517   spin = GTK_SPIN_BUTTON (widget);
 518
 519   GTK_WIDGET_CLASS (parent_class)->unrealize (widget);
 520
 521   if (spin->panel)
 522     {
 523       gdk_window_set_user_data (spin->panel, NULL);
 524       gdk_window_destroy (spin->panel);
 525       spin->panel = NULL;
 526     }
 527 }
 528
 529 static int
 530 compute_double_length (double val, int digits)
 531 {
 532   int a;
 533   int extra;
 534
 535   a = 1;
 536   if (fabs (val) > 1.0)
 537     a = floor (log10 (fabs (val))) + 1;
 538
 539   extra = 0;
 540
 541   /* The dot: */
 542   if (digits > 0)
 543     extra++;
 544
 545   /* The sign: */
 546   if (val < 0)
 547     extra++;
 548
 549   return a + digits + extra;
 550 }
 551
 552 static void
 553 gtk_spin_button_size_request (GtkWidget      *widget,
 554                               GtkRequisition *requisition)
 555 {
 556   GtkEntry *entry;
 557   GtkSpinButton *spin_button;
 558
 559   g_return_if_fail (widget != NULL);
 560   g_return_if_fail (requisition != NULL);
 561   g_return_if_fail (GTK_IS_SPIN_BUTTON (widget));
 562
 563   entry = GTK_ENTRY (widget);
 564   spin_button = GTK_SPIN_BUTTON (widget);
 565
 566   GTK_WIDGET_CLASS (parent_class)->size_request (widget, requisition);
 567
 568   if (entry->width_chars < 0)
 569     {
 570       PangoContext *context;
 571       PangoFontMetrics metrics;
 572       gint width;
 573       gint w;
 574       int string_len;
 575
 576       context = gtk_widget_get_pango_context (widget);
 577       pango_context_get_metrics (context,
 578                                  widget->style->font_desc,
 579                                  pango_context_get_language (context),
 580                                  &metrics);
 581
 582       /* Get max of MIN_SPIN_BUTTON_WIDTH, size of upper, size of lower */
 583
 584       width = MIN_SPIN_BUTTON_WIDTH;
 585
 586       string_len = compute_double_length (spin_button->adjustment->upper,
 587                                           spin_button->digits);
 588       w = MIN (string_len, 10) * PANGO_PIXELS (metrics.approximate_digit_width);
 589       width = MAX (width, w);
 590       string_len = compute_double_length (spin_button->adjustment->lower,
 591                                           spin_button->adjustment->step_increment);
 592       w = MIN (string_len, 10) * PANGO_PIXELS (metrics.approximate_digit_width);
 593       width = MAX (width, w);
 594
 595       requisition->width = width + ARROW_SIZE + 2 * widget->style->xthickness;
 596     }
 597   else
 598     requisition->width += ARROW_SIZE + 2 * widget->style->xthickness;
 599 }
 600
 601 static void
 602 gtk_spin_button_size_allocate (GtkWidget     *widget,
 603                                GtkAllocation *allocation)
 604 {
 605   GtkAllocation child_allocation;
 606
 607   g_return_if_fail (widget != NULL);
 608   g_return_if_fail (GTK_IS_SPIN_BUTTON (widget));
 609   g_return_if_fail (allocation != NULL);
 610
 611   child_allocation = *allocation;
 612   if (child_allocation.width > ARROW_SIZE + 2 * widget->style->xthickness)
 613     child_allocation.width -= ARROW_SIZE + 2 * widget->style->xthickness;
 614
 615   if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_RTL)
 616     child_allocation.x += ARROW_SIZE + 2 * widget->style->xthickness;
 617
 618   GTK_WIDGET_CLASS (parent_class)->size_allocate (widget, &child_allocation);
 619
 620   widget->allocation = *allocation;
 621
 622   if (GTK_WIDGET_REALIZED (widget))
 623     {
 624       child_allocation.width = ARROW_SIZE + 2 * widget->style->xthickness;
 625       child_allocation.height = widget->requisition.height;
 626
 627       if (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_LTR)
 628         child_allocation.x = (allocation->x + allocation->width - ARROW_SIZE -
 629                               2 * widget->style->xthickness);
 630       else
 631         child_allocation.x = allocation->x;
 632
 633       child_allocation.y = allocation->y + (allocation->height - widget->requisition.height) / 2;
 634
 635       gdk_window_move_resize (GTK_SPIN_BUTTON (widget)->panel,
 636                               child_allocation.x,
 637                               child_allocation.y,
 638                               child_allocation.width,
 639                               child_allocation.height);
 640     }
 641 }
 642
 643 static gint
 644 gtk_spin_button_expose (GtkWidget      *widget,
 645                         GdkEventExpose *event)
 646 {
 647   GtkSpinButton *spin;
 648
 649   g_return_val_if_fail (widget != NULL, FALSE);
 650   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (widget), FALSE);
 651   g_return_val_if_fail (event != NULL, FALSE);
 652
 653   spin = GTK_SPIN_BUTTON (widget);
 654
 655   if (GTK_WIDGET_DRAWABLE (widget))
 656     {
 657       GtkShadowType shadow_type;
 658
 659       /* FIXME this seems like really broken code -
 660        * why aren't we looking at event->window
 661        * and acting accordingly?
 662        */
 663
 664       shadow_type = spin_button_get_shadow_type (spin);
 665       if (shadow_type != GTK_SHADOW_NONE)
 666         gtk_paint_box (widget->style, spin->panel,
 667                        GTK_STATE_NORMAL, shadow_type,
 668                        &event->area, widget, "spinbutton",
 669                        0, 0,
 670                        ARROW_SIZE + 2 * widget->style->xthickness,
 671                        widget->requisition.height);
 672       else
 673          {
 674             gdk_window_set_back_pixmap (spin->panel, NULL, TRUE);
 675             gdk_window_clear_area (spin->panel,
 676                                    event->area.x, event->area.y,
 677                                    event->area.width, event->area.height);
 678          }
 679        gtk_spin_button_draw_arrow (spin, GTK_ARROW_UP);
 680        gtk_spin_button_draw_arrow (spin, GTK_ARROW_DOWN);
 681
 682        GTK_WIDGET_CLASS (parent_class)->expose_event (widget, event);
 683     }
 684
 685   return FALSE;
 686 }
 687
 688 static void
 689 gtk_spin_button_draw_arrow (GtkSpinButton *spin_button,
 690                             guint          arrow)
 691 {
 692   GtkShadowType spin_shadow_type;
 693   GtkStateType state_type;
 694   GtkShadowType shadow_type;
 695   GtkWidget *widget;
 696   gint x;
 697   gint y;
 698
 699   g_return_if_fail (spin_button != NULL);
 700   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
 701
 702   widget = GTK_WIDGET (spin_button);
 703   spin_shadow_type = spin_button_get_shadow_type (spin_button);
 704
 705   if (GTK_WIDGET_DRAWABLE (spin_button))
 706     {
 707       if (!spin_button->wrap &&
 708           (((arrow == GTK_ARROW_UP &&
 709           (spin_button->adjustment->upper - spin_button->adjustment->value
 710            <= EPSILON))) ||
 711           ((arrow == GTK_ARROW_DOWN &&
 712           (spin_button->adjustment->value - spin_button->adjustment->lower
 713            <= EPSILON)))))
 714         {
 715           shadow_type = GTK_SHADOW_ETCHED_IN;
 716           state_type = GTK_STATE_NORMAL;
 717         }
 718       else
 719         {
 720           if (spin_button->in_child == arrow)
 721             {
 722               if (spin_button->click_child == arrow)
 723                 state_type = GTK_STATE_ACTIVE;
 724               else
 725                 state_type = GTK_STATE_PRELIGHT;
 726             }
 727           else
 728             state_type = GTK_STATE_NORMAL;
 729
 730           if (spin_button->click_child == arrow)
 731             shadow_type = GTK_SHADOW_IN;
 732           else
 733             shadow_type = GTK_SHADOW_OUT;
 734         }
 735       if (arrow == GTK_ARROW_UP)
 736         {
 737           if (spin_shadow_type != GTK_SHADOW_NONE)
 738             {
 739               x = widget->style->xthickness;
 740               y = widget->style->ythickness;
 741             }
 742           else
 743             {
 744               x = widget->style->xthickness - 1;
 745               y = widget->style->ythickness - 1;
 746             }
 747           gtk_paint_arrow (widget->style, spin_button->panel,
 748                            state_type, shadow_type,
 749                            NULL, widget, "spinbutton",
 750                            arrow, TRUE,
 751                            x, y, ARROW_SIZE, widget->requisition.height / 2
 752                            - widget->style->ythickness);
 753         }
 754       else
 755         {
 756           if (spin_shadow_type != GTK_SHADOW_NONE)
 757             {
 758               x = widget->style->xthickness;
 759               y = widget->requisition.height / 2;
 760             }
 761           else
 762             {
 763               x = widget->style->xthickness - 1;
 764               y = widget->requisition.height / 2 + 1;
 765             }
 766           gtk_paint_arrow (widget->style, spin_button->panel,
 767                            state_type, shadow_type,
 768                            NULL, widget, "spinbutton",
 769                            arrow, TRUE,
 770                            x, y, ARROW_SIZE, widget->requisition.height / 2
 771                            - widget->style->ythickness);
 772         }
 773     }
 774 }
 775
 776 static gint
 777 gtk_spin_button_enter_notify (GtkWidget        *widget,
 778                               GdkEventCrossing *event)
 779 {
 780   GtkSpinButton *spin;
 781
 782   g_return_val_if_fail (widget != NULL, FALSE);
 783   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (widget), FALSE);
 784   g_return_val_if_fail (event != NULL, FALSE);
 785
 786   spin = GTK_SPIN_BUTTON (widget);
 787
 788   if (event->window == spin->panel)
 789     {
 790       gint x;
 791       gint y;
 792
 793       gdk_window_get_pointer (spin->panel, &x, &y, NULL);
 794
 795       if (y <= widget->requisition.height / 2)
 796         {
 797           spin->in_child = GTK_ARROW_UP;
 798           if (spin->click_child == 2)
 799             gtk_spin_button_draw_arrow (spin, GTK_ARROW_UP);
 800         }
 801       else
 802         {
 803           spin->in_child = GTK_ARROW_DOWN;
 804           if (spin->click_child == 2)
 805             gtk_spin_button_draw_arrow (spin, GTK_ARROW_DOWN);
 806         }
 807     }
 808   return FALSE;
 809 }
 810
 811 static gint
 812 gtk_spin_button_leave_notify (GtkWidget        *widget,
 813                               GdkEventCrossing *event)
 814 {
 815   GtkSpinButton *spin;
 816
 817   g_return_val_if_fail (widget != NULL, FALSE);
 818   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (widget), FALSE);
 819   g_return_val_if_fail (event != NULL, FALSE);
 820
 821   spin = GTK_SPIN_BUTTON (widget);
 822
 823   if (event->window == spin->panel && spin->click_child == 2)
 824     {
 825       if (spin->in_child == GTK_ARROW_UP)
 826         {
 827           spin->in_child = 2;
 828           gtk_spin_button_draw_arrow (spin, GTK_ARROW_UP);
 829         }
 830       else
 831         {
 832           spin->in_child = 2;
 833           gtk_spin_button_draw_arrow (spin, GTK_ARROW_DOWN);
 834         }
 835     }
 836   return FALSE;
 837 }
 838
 839 static gint
 840 gtk_spin_button_focus_out (GtkWidget     *widget,
 841                            GdkEventFocus *event)
 842 {
 843   g_return_val_if_fail (widget != NULL, FALSE);
 844   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (widget), FALSE);
 845   g_return_val_if_fail (event != NULL, FALSE);
 846
 847   if (GTK_ENTRY (widget)->editable)
 848     gtk_spin_button_update (GTK_SPIN_BUTTON (widget));
 849
 850   return GTK_WIDGET_CLASS (parent_class)->focus_out_event (widget, event);
 851 }
 852
 853 static gint
 854 gtk_spin_button_scroll (GtkWidget      *widget,
 855                         GdkEventScroll *event)
 856 {
 857   GtkSpinButton *spin;
 858
 859   g_return_val_if_fail (widget != NULL, FALSE);
 860   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (widget), FALSE);
 861   g_return_val_if_fail (event != NULL, FALSE);
 862
 863   spin = GTK_SPIN_BUTTON (widget);
 864
 865   if (event->direction == GDK_SCROLL_UP)
 866     {
 867       if (!GTK_WIDGET_HAS_FOCUS (widget))
 868         gtk_widget_grab_focus (widget);
 869       gtk_spin_button_real_spin (spin, spin->adjustment->step_increment);
 870     }
 871   else if (event->direction == GDK_SCROLL_DOWN)
 872     {
 873       if (!GTK_WIDGET_HAS_FOCUS (widget))
 874         gtk_widget_grab_focus (widget);
 875       gtk_spin_button_real_spin (spin, -spin->adjustment->step_increment);
 876     }
 877   else
 878     return FALSE;
 879
 880   return TRUE;
 881 }
 882
 883 static gint
 884 gtk_spin_button_button_press (GtkWidget      *widget,
 885                               GdkEventButton *event)
 886 {
 887   GtkSpinButton *spin;
 888
 889   g_return_val_if_fail (widget != NULL, FALSE);
 890   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (widget), FALSE);
 891   g_return_val_if_fail (event != NULL, FALSE);
 892
 893   spin = GTK_SPIN_BUTTON (widget);
 894
 895   if (!spin->button)
 896     {
 897       if (event->window == spin->panel)
 898         {
 899           if (!GTK_WIDGET_HAS_FOCUS (widget))
 900             gtk_widget_grab_focus (widget);
 901           gtk_grab_add (widget);
 902           spin->button = event->button;
 903
 904           if (GTK_ENTRY (widget)->editable)
 905             gtk_spin_button_update (spin);
 906
 907           if (event->y <= widget->requisition.height / 2)
 908             {
 909               spin->click_child = GTK_ARROW_UP;
 910               if (event->button == 1)
 911                 {
 912                  gtk_spin_button_real_spin (spin,
 913                                             spin->adjustment->step_increment);
 914                   if (!spin->timer)
 915                     {
 916                       spin->timer_step = spin->adjustment->step_increment;
 917                       spin->need_timer = TRUE;
 918                       spin->timer = gtk_timeout_add
 919                         (SPIN_BUTTON_INITIAL_TIMER_DELAY,
 920                          (GtkFunction) gtk_spin_button_timer, (gpointer) spin);
 921                     }
 922                 }
 923               else if (event->button == 2)
 924                 {
 925                  gtk_spin_button_real_spin (spin,
 926                                             spin->adjustment->page_increment);
 927                   if (!spin->timer)
 928                     {
 929                       spin->timer_step = spin->adjustment->page_increment;
 930                       spin->need_timer = TRUE;
 931                       spin->timer = gtk_timeout_add
 932                         (SPIN_BUTTON_INITIAL_TIMER_DELAY,
 933                          (GtkFunction) gtk_spin_button_timer, (gpointer) spin);
 934                     }
 935                 }
 936               gtk_spin_button_draw_arrow (spin, GTK_ARROW_UP);
 937             }
 938           else
 939             {
 940               spin->click_child = GTK_ARROW_DOWN;
 941               if (event->button == 1)
 942                 {
 943                   gtk_spin_button_real_spin (spin,
 944                                              -spin->adjustment->step_increment);
 945                   if (!spin->timer)
 946                     {
 947                       spin->timer_step = spin->adjustment->step_increment;
 948                       spin->need_timer = TRUE;
 949                       spin->timer = gtk_timeout_add
 950                         (SPIN_BUTTON_INITIAL_TIMER_DELAY,
 951                          (GtkFunction) gtk_spin_button_timer, (gpointer) spin);
 952                     }
 953                 }
 954               else if (event->button == 2)
 955                 {
 956                   gtk_spin_button_real_spin (spin,
 957                                              -spin->adjustment->page_increment);
 958                   if (!spin->timer)
 959                     {
 960                       spin->timer_step = spin->adjustment->page_increment;
 961                       spin->need_timer = TRUE;
 962                       spin->timer = gtk_timeout_add
 963                         (SPIN_BUTTON_INITIAL_TIMER_DELAY,
 964                          (GtkFunction) gtk_spin_button_timer, (gpointer) spin);
 965                     }
 966                 }
 967               gtk_spin_button_draw_arrow (spin, GTK_ARROW_DOWN);
 968             }
 969           return TRUE;
 970         }
 971       else
 972         return GTK_WIDGET_CLASS (parent_class)->button_press_event (widget, event);
 973     }
 974   return FALSE;
 975 }
 976
 977 static gint
 978 gtk_spin_button_button_release (GtkWidget      *widget,
 979                                 GdkEventButton *event)
 980 {
 981   GtkSpinButton *spin;
 982
 983   g_return_val_if_fail (widget != NULL, FALSE);
 984   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (widget), FALSE);
 985   g_return_val_if_fail (event != NULL, FALSE);
 986
 987   spin = GTK_SPIN_BUTTON (widget);
 988
 989   if (event->button == spin->button)
 990     {
 991       guint click_child;
 992
 993       if (spin->timer)
 994         {
 995           gtk_timeout_remove (spin->timer);
 996           spin->timer = 0;
 997           spin->timer_calls = 0;
 998           spin->need_timer = FALSE;
 999         }
1000
1001       if (event->button == 3)
1002         {
1003           if (event->y >= 0 && event->x >= 0 &&
1004               event->y <= widget->requisition.height &&
1005               event->x <= ARROW_SIZE + 2 * widget->style->xthickness)
1006             {
1007               if (spin->click_child == GTK_ARROW_UP &&
1008                   event->y <= widget->requisition.height / 2)
1009                 {
1010                   gdouble diff;
1011
1012                   diff = spin->adjustment->upper - spin->adjustment->value;
1013                   if (diff > EPSILON)
1014                     gtk_spin_button_real_spin (spin, diff);
1015                 }
1016               else if (spin->click_child == GTK_ARROW_DOWN &&
1017                        event->y > widget->requisition.height / 2)
1018                 {
1019                   gdouble diff;
1020
1021                   diff = spin->adjustment->value - spin->adjustment->lower;
1022                   if (diff > EPSILON)
1023                     gtk_spin_button_real_spin (spin, -diff);
1024                 }
1025             }
1026         }
1027       gtk_grab_remove (widget);
1028       click_child = spin->click_child;
1029       spin->click_child = 2;
1030       spin->button = 0;
1031       gtk_spin_button_draw_arrow (spin, click_child);
1032       return TRUE;
1033     }
1034   else
1035     return GTK_WIDGET_CLASS (parent_class)->button_release_event (widget, event);
1036
1037   return FALSE;
1038 }
1039
1040 static gint
1041 gtk_spin_button_motion_notify (GtkWidget      *widget,
1042                                GdkEventMotion *event)
1043 {
1044   GtkSpinButton *spin;
1045
1046   g_return_val_if_fail (widget != NULL, FALSE);
1047   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (widget), FALSE);
1048   g_return_val_if_fail (event != NULL, FALSE);
1049
1050   spin = GTK_SPIN_BUTTON (widget);
1051
1052   if (spin->button)
1053     return FALSE;
1054
1055   if (event->window == spin->panel)
1056     {
1057       gint y;
1058
1059       y = event->y;
1060       if (event->is_hint)
1061         gdk_window_get_pointer (spin->panel, NULL, &y, NULL);
1062
1063       if (y <= widget->requisition.height / 2 &&
1064           spin->in_child == GTK_ARROW_DOWN)
1065         {
1066           spin->in_child = GTK_ARROW_UP;
1067           gtk_spin_button_draw_arrow (spin, GTK_ARROW_UP);
1068           gtk_spin_button_draw_arrow (spin, GTK_ARROW_DOWN);
1069         }
1070       else if (y > widget->requisition.height / 2 &&
1071           spin->in_child == GTK_ARROW_UP)
1072         {
1073           spin->in_child = GTK_ARROW_DOWN;
1074           gtk_spin_button_draw_arrow (spin, GTK_ARROW_UP);
1075           gtk_spin_button_draw_arrow (spin, GTK_ARROW_DOWN);
1076         }
1077       return FALSE;
1078     }
1079
1080   return GTK_WIDGET_CLASS (parent_class)->motion_notify_event (widget, event);
1081 }
1082
1083 static gint
1084 gtk_spin_button_timer (GtkSpinButton *spin_button)
1085 {
1086   gboolean retval = FALSE;
1087
1088   GDK_THREADS_ENTER ();
1089
1090   if (spin_button->timer)
1091     {
1092       if (spin_button->click_child == GTK_ARROW_UP)
1093         gtk_spin_button_real_spin (spin_button, spin_button->timer_step);
1094       else
1095         gtk_spin_button_real_spin (spin_button, -spin_button->timer_step);
1096
1097       if (spin_button->need_timer)
1098         {
1099           spin_button->need_timer = FALSE;
1100           spin_button->timer = gtk_timeout_add
1101             (SPIN_BUTTON_TIMER_DELAY, (GtkFunction) gtk_spin_button_timer,
1102              (gpointer) spin_button);
1103         }
1104       else
1105         {
1106           if (spin_button->climb_rate > 0.0 && spin_button->timer_step
1107               < spin_button->adjustment->page_increment)
1108             {
1109               if (spin_button->timer_calls < MAX_TIMER_CALLS)
1110                 spin_button->timer_calls++;
1111               else
1112                 {
1113                   spin_button->timer_calls = 0;
1114                   spin_button->timer_step += spin_button->climb_rate;
1115                 }
1116             }
1117           retval = TRUE;
1118         }
1119     }
1120
1121   GDK_THREADS_LEAVE ();
1122
1123   return retval;
1124 }
1125
1126 static void
1127 gtk_spin_button_value_changed (GtkAdjustment *adjustment,
1128                                GtkSpinButton *spin_button)
1129 {
1130   gint return_val;
1131
1132   g_return_if_fail (adjustment != NULL);
1133   g_return_if_fail (GTK_IS_ADJUSTMENT (adjustment));
1134
1135   return_val = FALSE;
1136   gtk_signal_emit (GTK_OBJECT (spin_button), spinbutton_signals[OUTPUT],
1137                    &return_val);
1138   if (return_val == FALSE)
1139     gtk_spin_button_default_output (spin_button);
1140
1141   gtk_signal_emit (GTK_OBJECT (spin_button),
1142                    spinbutton_signals[VALUE_CHANGED]);
1143
1144   gtk_spin_button_draw_arrow (spin_button, GTK_ARROW_UP);
1145   gtk_spin_button_draw_arrow (spin_button, GTK_ARROW_DOWN);
1146
1147   g_object_notify (G_OBJECT (spin_button), "value");
1148 }
1149
1150 static gint
1151 gtk_spin_button_key_press (GtkWidget     *widget,
1152                            GdkEventKey   *event)
1153 {
1154   GtkSpinButton *spin;
1155   gint key;
1156   gboolean key_repeat = FALSE;
1157   gboolean retval = FALSE;
1158
1159   g_return_val_if_fail (widget != NULL, FALSE);
1160   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (widget), FALSE);
1161   g_return_val_if_fail (event != NULL, FALSE);
1162
1163   spin = GTK_SPIN_BUTTON (widget);
1164   key = event->keyval;
1165
1166   key_repeat = (event->time == spin->ev_time);
1167
1168   if (GTK_ENTRY (widget)->editable)
1169     {
1170       switch (key)
1171         {
1172         case GDK_KP_Up:
1173         case GDK_Up:
1174
1175           if (GTK_WIDGET_HAS_FOCUS (widget))
1176             {
1177               gtk_signal_emit_stop_by_name (GTK_OBJECT (widget),
1178                                             "key_press_event");
1179               if (!key_repeat)
1180                 spin->timer_step = spin->adjustment->step_increment;
1181
1182               gtk_spin_button_real_spin (spin, spin->timer_step);
1183
1184               if (key_repeat)
1185                 {
1186                   if (spin->climb_rate > 0.0 && spin->timer_step
1187                       < spin->adjustment->page_increment)
1188                     {
1189                       if (spin->timer_calls < MAX_TIMER_CALLS)
1190                         spin->timer_calls++;
1191                       else
1192                         {
1193                           spin->timer_calls = 0;
1194                           spin->timer_step += spin->climb_rate;
1195                         }
1196                     }
1197                 }
1198               retval = TRUE;
1199             }
1200           break;
1201
1202         case GDK_KP_Down:
1203         case GDK_Down:
1204
1205           if (GTK_WIDGET_HAS_FOCUS (widget))
1206             {
1207               gtk_signal_emit_stop_by_name (GTK_OBJECT (widget),
1208                                             "key_press_event");
1209               if (!key_repeat)
1210                 spin->timer_step = spin->adjustment->step_increment;
1211
1212               gtk_spin_button_real_spin (spin, -spin->timer_step);
1213
1214               if (key_repeat)
1215                 {
1216                   if (spin->climb_rate > 0.0 && spin->timer_step
1217                       < spin->adjustment->page_increment)
1218                     {
1219                       if (spin->timer_calls < MAX_TIMER_CALLS)
1220                         spin->timer_calls++;
1221                       else
1222                         {
1223                           spin->timer_calls = 0;
1224                           spin->timer_step += spin->climb_rate;
1225                         }
1226                     }
1227                 }
1228               retval = TRUE;
1229             }
1230           break;
1231
1232         case GDK_KP_Page_Up:
1233         case GDK_Page_Up:
1234
1235           if (event->state & GDK_CONTROL_MASK)
1236             {
1237               gdouble diff = spin->adjustment->upper - spin->adjustment->value;
1238               if (diff > EPSILON)
1239                 gtk_spin_button_real_spin (spin, diff);
1240             }
1241           else
1242             gtk_spin_button_real_spin (spin, spin->adjustment->page_increment);
1243
1244           retval = TRUE;
1245           break;
1246
1247         case GDK_KP_Page_Down:
1248         case GDK_Page_Down:
1249
1250           if (event->state & GDK_CONTROL_MASK)
1251             {
1252               gdouble diff = spin->adjustment->value - spin->adjustment->lower;
1253               if (diff > EPSILON)
1254                 gtk_spin_button_real_spin (spin, -diff);
1255             }
1256           else
1257             gtk_spin_button_real_spin (spin, -spin->adjustment->page_increment);
1258
1259           retval = TRUE;
1260           break;
1261
1262         default:
1263           break;
1264         }
1265     }
1266
1267   if (retval)
1268     {
1269       gtk_spin_button_update (spin);
1270       return TRUE;
1271     }
1272   else
1273     return GTK_WIDGET_CLASS (parent_class)->key_press_event (widget, event);
1274 }
1275
1276 static gint
1277 gtk_spin_button_key_release (GtkWidget   *widget,
1278                              GdkEventKey *event)
1279 {
1280   GtkSpinButton *spin;
1281
1282   g_return_val_if_fail (widget != NULL, FALSE);
1283   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (widget), FALSE);
1284
1285   spin = GTK_SPIN_BUTTON (widget);
1286
1287   spin->ev_time = event->time;
1288   return TRUE;
1289 }
1290
1291 static void
1292 gtk_spin_button_snap (GtkSpinButton *spin_button,
1293                       gdouble        val)
1294 {
1295   gdouble inc;
1296   gdouble tmp;
1297
1298   inc = spin_button->adjustment->step_increment;
1299   tmp = (val - spin_button->adjustment->lower) / inc;
1300   if (tmp - floor (tmp) < ceil (tmp) - tmp)
1301     val = spin_button->adjustment->lower + floor (tmp) * inc;
1302   else
1303     val = spin_button->adjustment->lower + ceil (tmp) * inc;
1304
1305   if (fabs (val - spin_button->adjustment->value) > EPSILON)
1306     gtk_adjustment_set_value (spin_button->adjustment, val);
1307   else
1308     {
1309       gint return_val = FALSE;
1310       gtk_signal_emit (GTK_OBJECT (spin_button), spinbutton_signals[OUTPUT],
1311                        &return_val);
1312       if (return_val == FALSE)
1313         gtk_spin_button_default_output (spin_button);
1314     }
1315 }
1316
1317 static void
1318 gtk_spin_button_activate (GtkEntry *entry)
1319 {
1320   if (entry->editable)
1321     gtk_spin_button_update (GTK_SPIN_BUTTON (entry));
1322 }
1323
1324 static void
1325 gtk_spin_button_insert_text (GtkEntry    *entry,
1326                              const gchar *new_text,
1327                              gint         new_text_length,
1328                              gint        *position)
1329 {
1330   GtkEditable *editable = GTK_EDITABLE (entry);
1331   GtkSpinButton *spin = GTK_SPIN_BUTTON (editable);
1332
1333   if (spin->numeric)
1334     {
1335       struct lconv *lc;
1336       gboolean sign;
1337       gint dotpos = -1;
1338       gint i;
1339       GdkWChar pos_sign;
1340       GdkWChar neg_sign;
1341       gint entry_length;
1342
1343       entry_length = entry->text_length;
1344
1345       lc = localeconv ();
1346
1347       if (*(lc->negative_sign))
1348         neg_sign = *(lc->negative_sign);
1349       else
1350         neg_sign = '-';
1351
1352       if (*(lc->positive_sign))
1353         pos_sign = *(lc->positive_sign);
1354       else
1355         pos_sign = '+';
1356
1357       for (sign=0, i=0; i<entry_length; i++)
1358         if ((entry->text[i] == neg_sign) ||
1359             (entry->text[i] == pos_sign))
1360           {
1361             sign = 1;
1362             break;
1363           }
1364
1365       if (sign && !(*position))
1366         return;
1367
1368       for (dotpos=-1, i=0; i<entry_length; i++)
1369         if (entry->text[i] == *(lc->decimal_point))
1370           {
1371             dotpos = i;
1372             break;
1373           }
1374
1375       if (dotpos > -1 && *position > dotpos &&
1376           (gint)spin->digits - entry_length
1377             + dotpos - new_text_length + 1 < 0)
1378         return;
1379
1380       for (i = 0; i < new_text_length; i++)
1381         {
1382           if (new_text[i] == neg_sign || new_text[i] == pos_sign)
1383             {
1384               if (sign || (*position) || i)
1385                 return;
1386               sign = TRUE;
1387             }
1388           else if (new_text[i] == *(lc->decimal_point))
1389             {
1390               if (!spin->digits || dotpos > -1 ||
1391                   (new_text_length - 1 - i + entry_length
1392                     - *position > (gint)spin->digits))
1393                 return;
1394               dotpos = *position + i;
1395             }
1396           else if (new_text[i] < 0x30 || new_text[i] > 0x39)
1397             return;
1398         }
1399     }
1400
1401   GTK_ENTRY_CLASS (parent_class)->insert_text (entry, new_text,
1402                                                new_text_length, position);
1403 }
1404
1405 static void
1406 gtk_spin_button_real_spin (GtkSpinButton *spin_button,
1407                            gdouble        increment)
1408 {
1409   GtkAdjustment *adj;
1410   gdouble new_value = 0.0;
1411
1412   g_return_if_fail (spin_button != NULL);
1413   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
1414
1415   adj = spin_button->adjustment;
1416
1417   new_value = adj->value + increment;
1418
1419   if (increment > 0)
1420     {
1421       if (spin_button->wrap)
1422         {
1423           if (fabs (adj->value - adj->upper) < EPSILON)
1424             new_value = adj->lower;
1425           else if (new_value > adj->upper)
1426             new_value = adj->upper;
1427         }
1428       else
1429         new_value = MIN (new_value, adj->upper);
1430     }
1431   else if (increment < 0)
1432     {
1433       if (spin_button->wrap)
1434         {
1435           if (fabs (adj->value - adj->lower) < EPSILON)
1436             new_value = adj->upper;
1437           else if (new_value < adj->lower)
1438             new_value = adj->lower;
1439         }
1440       else
1441         new_value = MAX (new_value, adj->lower);
1442     }
1443
1444   if (fabs (new_value - adj->value) > EPSILON)
1445     gtk_adjustment_set_value (adj, new_value);
1446 }
1447
1448 static gint
1449 gtk_spin_button_default_input (GtkSpinButton *spin_button,
1450                                gdouble       *new_val)
1451 {
1452   gchar *err = NULL;
1453
1454   *new_val = strtod (gtk_entry_get_text (GTK_ENTRY (spin_button)), &err);
1455   if (*err)
1456     return GTK_INPUT_ERROR;
1457   else
1458     return FALSE;
1459 }
1460
1461 static gint
1462 gtk_spin_button_default_output (GtkSpinButton *spin_button)
1463 {
1464   gchar *buf = g_strdup_printf ("%0.*f", spin_button->digits, spin_button->adjustment->value);
1465
1466   if (strcmp (buf, gtk_entry_get_text (GTK_ENTRY (spin_button))))
1467     gtk_entry_set_text (GTK_ENTRY (spin_button), buf);
1468   g_free (buf);
1469   return FALSE;
1470 }
1471
1472
1473 /***********************************************************
1474  ***********************************************************
1475  ***                  Public interface                   ***
1476  ***********************************************************
1477  ***********************************************************/
1478
1479
1480 void
1481 gtk_spin_button_configure (GtkSpinButton  *spin_button,
1482                            GtkAdjustment  *adjustment,
1483                            gdouble         climb_rate,
1484                            guint           digits)
1485 {
1486   g_return_if_fail (spin_button != NULL);
1487   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
1488
1489   if (adjustment)
1490     gtk_spin_button_set_adjustment (spin_button, adjustment);
1491   else
1492     adjustment = spin_button->adjustment;
1493
1494   if (spin_button->digits != digits)
1495     {
1496       spin_button->digits = digits;
1497       g_object_notify (G_OBJECT (spin_button), "digits");
1498     }
1499
1500   if (spin_button->climb_rate != climb_rate)
1501     {
1502       spin_button->climb_rate = climb_rate;
1503       g_object_notify (G_OBJECT (spin_button), "climb_rate");
1504     }
1505
1506   gtk_adjustment_value_changed (adjustment);
1507 }
1508
1509 GtkWidget *
1510 gtk_spin_button_new (GtkAdjustment *adjustment,
1511                      gdouble        climb_rate,
1512                      guint          digits)
1513 {
1514   GtkSpinButton *spin;
1515
1516   if (adjustment)
1517     g_return_val_if_fail (GTK_IS_ADJUSTMENT (adjustment), NULL);
1518
1519   spin = gtk_type_new (GTK_TYPE_SPIN_BUTTON);
1520
1521   gtk_spin_button_configure (spin, adjustment, climb_rate, digits);
1522
1523   return GTK_WIDGET (spin);
1524 }
1525
1526 /**
1527  * gtk_spin_button_new_with_range:
1528  * @min: Minimum allowable value
1529  * @max: Maximum allowable value
1530  * @step: Increment added or subtracted by spinning the widget
1531  *
1532  * This is a convenience constructor that allows creation of a numeric
1533  * #GtkSpinButton without manually creating an adjustment. The value is
1534  * initially set to the minimum value and a page increment of 10 * @step
1535  * is the default. The precision of the spin button is equivalent to the
1536  * precision of @step.
1537  *
1538  * Return value: the newly instantiated spin button
1539  **/
1540 GtkWidget *
1541 gtk_spin_button_new_with_range (gdouble min,
1542                                 gdouble max,
1543                                 gdouble step)
1544 {
1545   GtkObject *adj;
1546   GtkSpinButton *spin;
1547   gint digits;
1548
1549   g_return_val_if_fail (min < max, NULL);
1550   g_return_val_if_fail (step != 0.0, NULL);
1551
1552   spin = gtk_type_new (GTK_TYPE_SPIN_BUTTON);
1553
1554   adj = gtk_adjustment_new (min, min, max, step, 10 * step, step);
1555
1556   if (fabs (step) >= 1.0 || step == 0.0)
1557     digits = 0;
1558   else {
1559     digits = abs ((gint) floor (log10 (fabs (step))));
1560     if (digits > MAX_DIGITS)
1561       digits = MAX_DIGITS;
1562   }
1563
1564   gtk_spin_button_configure (spin, GTK_ADJUSTMENT (adj), step, digits);
1565
1566   gtk_spin_button_set_numeric (spin, TRUE);
1567
1568   return GTK_WIDGET (spin);
1569 }
1570
1571 /* Callback used when the spin button's adjustment changes.  We need to redraw
1572  * the arrows when the adjustment's range changes, and reevaluate our size request.
1573  */
1574 static void
1575 adjustment_changed_cb (GtkAdjustment *adjustment, gpointer data)
1576 {
1577   GtkSpinButton *spin_button;
1578
1579   spin_button = GTK_SPIN_BUTTON (data);
1580
1581   gtk_widget_queue_resize (GTK_WIDGET (spin_button));
1582 }
1583
1584 /**
1585  * gtk_spin_button_set_adjustment:
1586  * @spin_button: a #GtkSpinButton
1587  * @adjustment: a #GtkAdjustment to replace the existing adjustment
1588  *
1589  * Replaces the #GtkAdjustment associated with @spin_button.
1590  **/
1591 void
1592 gtk_spin_button_set_adjustment (GtkSpinButton *spin_button,
1593                                 GtkAdjustment *adjustment)
1594 {
1595   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
1596
1597   if (spin_button->adjustment != adjustment)
1598     {
1599       if (spin_button->adjustment)
1600         {
1601           gtk_signal_disconnect_by_data (GTK_OBJECT (spin_button->adjustment),
1602                                          (gpointer) spin_button);
1603           gtk_object_unref (GTK_OBJECT (spin_button->adjustment));
1604         }
1605       spin_button->adjustment = adjustment;
1606       if (adjustment)
1607         {
1608           gtk_object_ref (GTK_OBJECT (adjustment));
1609           gtk_object_sink (GTK_OBJECT (adjustment));
1610           gtk_signal_connect (GTK_OBJECT (adjustment), "value_changed",
1611                               (GtkSignalFunc) gtk_spin_button_value_changed,
1612                               (gpointer) spin_button);
1613           gtk_signal_connect (GTK_OBJECT (adjustment), "changed",
1614                               (GtkSignalFunc) adjustment_changed_cb,
1615                               (gpointer) spin_button);
1616         }
1617
1618       gtk_widget_queue_resize (GTK_WIDGET (spin_button));
1619     }
1620
1621   g_object_notify (G_OBJECT (spin_button), "adjustment");
1622 }
1623
1624 /**
1625  * gtk_spin_button_get_adjustment:
1626  * @spin_button:
1627  *
1628  * Get the adjustment associated with a #GtkSpinButton
1629  *
1630  * Return value: the #GtkAdjustment of @spin_button
1631  **/
1632 GtkAdjustment *
1633 gtk_spin_button_get_adjustment (GtkSpinButton *spin_button)
1634 {
1635   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (spin_button), NULL);
1636
1637   return spin_button->adjustment;
1638 }
1639
1640 /**
1641  * gtk_spin_button_set_digits:
1642  * @spin_button: a #GtkSpinButton
1643  * @digits: the number of digits to be displayed for the spin button's value
1644  *
1645  * Set the precision to be displayed by @spin_button. Up to 20 digit precision
1646  * is allowed.
1647  **/
1648 void
1649 gtk_spin_button_set_digits (GtkSpinButton *spin_button,
1650                             guint          digits)
1651 {
1652   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
1653
1654   if (spin_button->digits != digits)
1655     {
1656       spin_button->digits = digits;
1657       gtk_spin_button_value_changed (spin_button->adjustment, spin_button);
1658       g_object_notify (G_OBJECT (spin_button), "digits");
1659
1660       /* since lower/upper may have changed */
1661       gtk_widget_queue_resize (GTK_WIDGET (spin_button));
1662     }
1663 }
1664
1665 /**
1666  * gtk_spin_button_get_digits:
1667  * @spin_button: a #GtkSpinButton
1668  *
1669  * Fetches the precision of @spin_button. See gtk_spin_button_set_digits().
1670  *
1671  * Returns: the current precision
1672  **/
1673 guint
1674 gtk_spin_button_get_digits (GtkSpinButton *spin_button)
1675 {
1676   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (spin_button), 0);
1677
1678   return spin_button->digits;
1679 }
1680
1681 /**
1682  * gtk_spin_button_set_increments:
1683  * @spin_button: a #GtkSpinButton
1684  * @step: increment applied for a button 1 press.
1685  * @page: increment applied for a button 2 press.
1686  *
1687  * Sets the step and page increments for spin_button.  This affects how
1688  * quickly the value changes when the spin button's arrows are activated.
1689  **/
1690 void
1691 gtk_spin_button_set_increments (GtkSpinButton *spin_button,
1692                                 gdouble        step,
1693                                 gdouble        page)
1694 {
1695   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
1696
1697   spin_button->adjustment->step_increment = step;
1698   spin_button->adjustment->page_increment = page;
1699 }
1700
1701 /**
1702  * gtk_spin_button_get_increments:
1703  * @psin_button: a #GtkSpinButton
1704  * @step: location to store step increment, or %NULL
1705  * @page: location to store page increment, or %NULL
1706  *
1707  * Gets the current step and page the increments used by @spin_button. See
1708  * gtk_spin_button_set_increments().
1709  **/
1710 void
1711 gtk_spin_button_get_increments (GtkSpinButton *spin_button,
1712                                 gdouble       *step,
1713                                 gdouble       *page)
1714 {
1715   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
1716
1717   if (step)
1718     *step = spin_button->adjustment->step_increment;
1719   if (page)
1720     *page = spin_button->adjustment->page_increment;
1721 }
1722
1723 /**
1724  * gtk_spin_button_set_range:
1725  * @spin_button: a #GtkSpinButton
1726  * @min: minimum allowable value
1727  * @max: maximum allowable value
1728  *
1729  * Sets the minimum and maximum allowable values for @spin_button
1730  **/
1731 void
1732 gtk_spin_button_set_range (GtkSpinButton *spin_button,
1733                            gdouble        min,
1734                            gdouble        max)
1735 {
1736   gdouble value;
1737
1738   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
1739
1740   spin_button->adjustment->lower = min;
1741   spin_button->adjustment->upper = max;
1742
1743   value = CLAMP (spin_button->adjustment->value,
1744                  spin_button->adjustment->lower,
1745                  (spin_button->adjustment->upper - spin_button->adjustment->page_size));
1746
1747   if (value != spin_button->adjustment->value)
1748     gtk_spin_button_set_value (spin_button, value);
1749
1750   gtk_adjustment_changed (spin_button->adjustment);
1751 }
1752
1753 /**
1754  * gtk_spin_button_get_range:
1755  * @spin_button: a #GtkSpinButton
1756  * @min: location to store minimum allowed value, or %NULL
1757  * @max: location to store maximum allowed value, or %NULL
1758  *
1759  * Gets the range allowed for @spin_button. See
1760  * gtk_spin_button_set_range().
1761  **/
1762 void
1763 gtk_spin_button_get_range (GtkSpinButton *spin_button,
1764                            gdouble       *min,
1765                            gdouble       *max)
1766 {
1767   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
1768
1769   if (min)
1770     *min = spin_button->adjustment->lower;
1771   if (max)
1772     *max = spin_button->adjustment->upper;
1773 }
1774
1775 /**
1776  * gtk_spin_button_get_value:
1777  * @spin_button: a #GtkSpinButton
1778  *
1779  * Get the value in the @spin_button.
1780  *
1781  * Return value: the value of @spin_button
1782  **/
1783 gdouble
1784 gtk_spin_button_get_value (GtkSpinButton *spin_button)
1785 {
1786   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (spin_button), 0.0);
1787
1788   return spin_button->adjustment->value;
1789 }
1790
1791 /**
1792  * gtk_spin_button_get_value_as_int:
1793  * @spin_button: a #GtkSpinButton
1794  *
1795  * Get the value @spin_button represented as an integer.
1796  *
1797  * Return value: the value of @spin_button
1798  **/
1799 gint
1800 gtk_spin_button_get_value_as_int (GtkSpinButton *spin_button)
1801 {
1802   gdouble val;
1803
1804   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (spin_button), 0);
1805
1806   val = spin_button->adjustment->value;
1807   if (val - floor (val) < ceil (val) - val)
1808     return floor (val);
1809   else
1810     return ceil (val);
1811 }
1812
1813 /**
1814  * gtk_spin_button_set_value:
1815  * @spin_button: a #GtkSpinButton
1816  * @value: the new value
1817  *
1818  * Set the value of @spin_button.
1819  **/
1820 void
1821 gtk_spin_button_set_value (GtkSpinButton *spin_button,
1822                            gdouble        value)
1823 {
1824   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
1825
1826   if (fabs (value - spin_button->adjustment->value) > EPSILON)
1827     gtk_adjustment_set_value (spin_button->adjustment, value);
1828   else
1829     {
1830       gint return_val = FALSE;
1831       gtk_signal_emit (GTK_OBJECT (spin_button), spinbutton_signals[OUTPUT],
1832                        &return_val);
1833       if (return_val == FALSE)
1834         gtk_spin_button_default_output (spin_button);
1835     }
1836 }
1837
1838 /**
1839  * gtk_spin_button_set_update_policy:
1840  * @spin_button: a #GtkSpinButton
1841  * @policy: a #GtkSpinButtonUpdatePolicy value
1842  *
1843  * Sets the update behavior of a spin button. This determines whether the
1844  * spin button is always updated or only when a valid value is set.
1845  **/
1846 void
1847 gtk_spin_button_set_update_policy (GtkSpinButton             *spin_button,
1848                                    GtkSpinButtonUpdatePolicy  policy)
1849 {
1850   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
1851
1852   if (spin_button->update_policy != policy)
1853     {
1854       spin_button->update_policy = policy;
1855       g_object_notify (G_OBJECT (spin_button), "update_policy");
1856     }
1857 }
1858
1859 /**
1860  * gtk_spin_button_get_update_policy:
1861  * @spin_button: a #GtkSpinButton
1862  *
1863  * Gets the update behavior of a spin button. See
1864  * gtk_spin_button_set_update_policy().
1865  *
1866  * Return value: the current update policy
1867  **/
1868 GtkSpinButtonUpdatePolicy
1869 gtk_spin_button_get_update_policy (GtkSpinButton *spin_button)
1870 {
1871   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (spin_button), GTK_UPDATE_ALWAYS);
1872
1873   return spin_button->update_policy;
1874 }
1875
1876 /**
1877  * gtk_spin_button_set_numeric:
1878  * @spin_button: a #GtkSpinButton
1879  * @numeric: flag indicating if only numeric entry is allowed.
1880  *
1881  * Sets the flag that determines if non-numeric text can be typed into
1882  * the spin button.
1883  **/
1884 void
1885 gtk_spin_button_set_numeric (GtkSpinButton  *spin_button,
1886                              gboolean        numeric)
1887 {
1888   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
1889
1890   spin_button->numeric = (numeric != 0);
1891
1892   g_object_notify (G_OBJECT (spin_button), "numeric");
1893 }
1894
1895 /**
1896  * gtk_spin_button_get_numeric:
1897  * @spin_button: a #GtkSpinButton
1898  *
1899  * Returns whether non-numeric text can be typed into the spin button.
1900  * See gtk_spin_button_set_numeric().
1901  *
1902  * Return value: %TRUE if only numeric text can be entered
1903  **/
1904 gboolean
1905 gtk_spin_button_get_numeric (GtkSpinButton *spin_button)
1906 {
1907   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (spin_button), FALSE);
1908
1909   return spin_button->numeric;
1910 }
1911
1912 /**
1913  * gtk_spin_button_set_wrap:
1914  * @spin_button: a #GtkSpinButton
1915  * @wrap: a flag indicating if wrapping behavior is performed.
1916  *
1917  * Sets the flag that determines if a spin button value wraps around to the
1918  * opposite limit when the upper or lower limit of the range is exceeded.
1919  **/
1920 void
1921 gtk_spin_button_set_wrap (GtkSpinButton  *spin_button,
1922                           gboolean        wrap)
1923 {
1924   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
1925
1926   spin_button->wrap = (wrap != 0);
1927
1928   g_object_notify (G_OBJECT (spin_button), "wrap");
1929 }
1930
1931 /**
1932  * gtk_spin_button_get_wrap:
1933  * @spin_button: a #GtkSpinButton
1934  *
1935  * Returns whether the spin button's value wraps around to the
1936  * opposite limit when the upper or lower limit of the range is
1937  * exceeded. See gtk_spin_button_set_wrap().
1938  *
1939  * Return value: %TRUE if the spin button wraps around
1940  **/
1941 gboolean
1942 gtk_spin_button_get_wrap (GtkSpinButton *spin_button)
1943 {
1944   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (spin_button), FALSE);
1945
1946   return spin_button->wrap;
1947 }
1948
1949 /**
1950  * spin_button_get_shadow_type:
1951  * @spin_button: a #GtkSpinButton
1952  *
1953  * Convenience function to Get the shadow type from the underlying widget's
1954  * style.
1955  *
1956  * Return value: the #GtkShadowType
1957  **/
1958 static gint
1959 spin_button_get_shadow_type (GtkSpinButton *spin_button)
1960 {
1961   GtkShadowType rc_shadow_type;
1962
1963   gtk_widget_style_get (GTK_WIDGET (spin_button), "shadow_type", &rc_shadow_type, NULL);
1964
1965   return rc_shadow_type;
1966 }
1967
1968 /**
1969  * gtk_spin_button_set_snap_to_ticks:
1970  * @spin_button: a #GtkSpinButton
1971  * @snap_to_ticks: a flag indicating if invalid values should be corrected.
1972  *
1973  * Sets the policy as to whether values are corrected to the nearest step
1974  * increment when a spin button is activated after providing an invalid value.
1975  **/
1976 void
1977 gtk_spin_button_set_snap_to_ticks (GtkSpinButton *spin_button,
1978                                    gboolean       snap_to_ticks)
1979 {
1980   guint new_val;
1981
1982   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
1983
1984   new_val = (snap_to_ticks != 0);
1985
1986   if (new_val != spin_button->snap_to_ticks)
1987     {
1988       spin_button->snap_to_ticks = new_val;
1989       if (new_val && GTK_ENTRY (spin_button)->editable)
1990         gtk_spin_button_update (spin_button);
1991
1992       g_object_notify (G_OBJECT (spin_button), "snap_to_ticks");
1993     }
1994 }
1995
1996 /**
1997  * gtk_spin_button_get_snap_to_ticks:
1998  * @spin_button: a #GtkSpinButton
1999  *
2000  * Returns whether the values are corrected to the nearest step. See
2001  * gtk_spin_button_set_snap_to_ticks().
2002  *
2003  * Return value: %TRUE if values are snapped to the nearest step.
2004  **/
2005 gboolean
2006 gtk_spin_button_get_snap_to_ticks (GtkSpinButton *spin_button)
2007 {
2008   g_return_val_if_fail (GTK_IS_SPIN_BUTTON (spin_button), FALSE);
2009
2010   return spin_button->snap_to_ticks;
2011 }
2012
2013 /**
2014  * gtk_spin_button_spin:
2015  * @spin_button: a #GtkSpinButton
2016  * @direction: a #GtkSpinType indicating the direction to spin.
2017  * @increment: step increment to apply in the specified direction.
2018  *
2019  * Increment or decrement a spin button's value in a specified direction
2020  * by a specified amount.
2021  **/
2022 void
2023 gtk_spin_button_spin (GtkSpinButton *spin_button,
2024                       GtkSpinType    direction,
2025                       gdouble        increment)
2026 {
2027   GtkAdjustment *adj;
2028   gdouble diff;
2029
2030   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
2031
2032   adj = spin_button->adjustment;
2033
2034   /* for compatibility with the 1.0.x version of this function */
2035   if (increment != 0 && increment != adj->step_increment &&
2036       (direction == GTK_SPIN_STEP_FORWARD ||
2037        direction == GTK_SPIN_STEP_BACKWARD))
2038     {
2039       if (direction == GTK_SPIN_STEP_BACKWARD && increment > 0)
2040         increment = -increment;
2041       direction = GTK_SPIN_USER_DEFINED;
2042     }
2043
2044   switch (direction)
2045     {
2046     case GTK_SPIN_STEP_FORWARD:
2047
2048       gtk_spin_button_real_spin (spin_button, adj->step_increment);
2049       break;
2050
2051     case GTK_SPIN_STEP_BACKWARD:
2052
2053       gtk_spin_button_real_spin (spin_button, -adj->step_increment);
2054       break;
2055
2056     case GTK_SPIN_PAGE_FORWARD:
2057
2058       gtk_spin_button_real_spin (spin_button, adj->page_increment);
2059       break;
2060
2061     case GTK_SPIN_PAGE_BACKWARD:
2062
2063       gtk_spin_button_real_spin (spin_button, -adj->page_increment);
2064       break;
2065
2066     case GTK_SPIN_HOME:
2067
2068       diff = adj->value - adj->lower;
2069       if (diff > EPSILON)
2070         gtk_spin_button_real_spin (spin_button, -diff);
2071       break;
2072
2073     case GTK_SPIN_END:
2074
2075       diff = adj->upper - adj->value;
2076       if (diff > EPSILON)
2077         gtk_spin_button_real_spin (spin_button, diff);
2078       break;
2079
2080     case GTK_SPIN_USER_DEFINED:
2081
2082       if (increment != 0)
2083         gtk_spin_button_real_spin (spin_button, increment);
2084       break;
2085
2086     default:
2087       break;
2088     }
2089 }
2090
2091 /**
2092  * gtk_spin_button_update:
2093  * @spin_button: a #GtkSpinButton
2094  *
2095  * Manually force an update of the spin button.
2096  **/
2097 void
2098 gtk_spin_button_update (GtkSpinButton *spin_button)
2099 {
2100   gdouble val;
2101   gint error = 0;
2102   gint return_val;
2103
2104   g_return_if_fail (GTK_IS_SPIN_BUTTON (spin_button));
2105
2106   return_val = FALSE;
2107   gtk_signal_emit (GTK_OBJECT (spin_button), spinbutton_signals[INPUT],
2108                    &val, &return_val);
2109   if (return_val == FALSE)
2110     {
2111       return_val = gtk_spin_button_default_input (spin_button, &val);
2112       error = (return_val == GTK_INPUT_ERROR);
2113     }
2114   else if (return_val == GTK_INPUT_ERROR)
2115     error = 1;
2116
2117   if (spin_button->update_policy == GTK_UPDATE_ALWAYS)
2118     {
2119       if (val < spin_button->adjustment->lower)
2120         val = spin_button->adjustment->lower;
2121       else if (val > spin_button->adjustment->upper)
2122         val = spin_button->adjustment->upper;
2123     }
2124   else if ((spin_button->update_policy == GTK_UPDATE_IF_VALID) &&
2125            (error ||
2126            val < spin_button->adjustment->lower ||
2127            val > spin_button->adjustment->upper))
2128     {
2129       gtk_spin_button_value_changed (spin_button->adjustment, spin_button);
2130       return;
2131     }
2132
2133   if (spin_button->snap_to_ticks)
2134     gtk_spin_button_snap (spin_button, val);
2135   else
2136     {
2137       if (fabs (val - spin_button->adjustment->value) > EPSILON)
2138         gtk_adjustment_set_value (spin_button->adjustment, val);
2139       else
2140         {
2141           return_val = FALSE;
2142           gtk_signal_emit (GTK_OBJECT (spin_button), spinbutton_signals[OUTPUT],
2143                            &return_val);
2144           if (return_val == FALSE)
2145             gtk_spin_button_default_output (spin_button);
2146         }
2147     }
2148 }
2149