/* GtkCellRendererSpin * Copyright (C) 2004 Lorenzo Gil Sanchez * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library. If not, see . * * Authors: Lorenzo Gil Sanchez * Carlos Garnacho Parro */ #include "config.h" #include "gtkcellrendererspin.h" #include "gtkadjustment.h" #include "gtkintl.h" #include "gtkprivate.h" #include "gtkspinbutton.h" #include "gtkentry.h" #include "gtkeventcontrollerkey.h" /** * SECTION:gtkcellrendererspin * @Short_description: Renders a spin button in a cell * @Title: GtkCellRendererSpin * @See_also: #GtkCellRendererText, #GtkSpinButton * * #GtkCellRendererSpin renders text in a cell like #GtkCellRendererText from * which it is derived. But while #GtkCellRendererText offers a simple entry to * edit the text, #GtkCellRendererSpin offers a #GtkSpinButton widget. Of course, * that means that the text has to be parseable as a floating point number. * * The range of the spinbutton is taken from the adjustment property of the * cell renderer, which can be set explicitly or mapped to a column in the * tree model, like all properties of cell renders. #GtkCellRendererSpin * also has properties for the #GtkCellRendererSpin:climb-rate and the number * of #GtkCellRendererSpin:digits to display. Other #GtkSpinButton properties * can be set in a handler for the #GtkCellRenderer::editing-started signal. * * The #GtkCellRendererSpin cell renderer was added in GTK 2.10. */ struct _GtkCellRendererSpinPrivate { GtkAdjustment *adjustment; gdouble climb_rate; guint digits; }; static void gtk_cell_renderer_spin_finalize (GObject *object); static void gtk_cell_renderer_spin_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *spec); static void gtk_cell_renderer_spin_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *spec); static gboolean gtk_cell_renderer_spin_key_pressed (GtkEventControllerKey *controller, guint keyval, guint keycode, GdkModifierType state, GtkWidget *widget); static GtkCellEditable * gtk_cell_renderer_spin_start_editing (GtkCellRenderer *cell, GdkEvent *event, GtkWidget *widget, const gchar *path, const GdkRectangle *background_area, const GdkRectangle *cell_area, GtkCellRendererState flags); enum { PROP_0, PROP_ADJUSTMENT, PROP_CLIMB_RATE, PROP_DIGITS }; #define GTK_CELL_RENDERER_SPIN_PATH "gtk-cell-renderer-spin-path" G_DEFINE_TYPE_WITH_PRIVATE (GtkCellRendererSpin, gtk_cell_renderer_spin, GTK_TYPE_CELL_RENDERER_TEXT) static void gtk_cell_renderer_spin_class_init (GtkCellRendererSpinClass *klass) { GObjectClass *object_class = G_OBJECT_CLASS (klass); GtkCellRendererClass *cell_class = GTK_CELL_RENDERER_CLASS (klass); object_class->finalize = gtk_cell_renderer_spin_finalize; object_class->get_property = gtk_cell_renderer_spin_get_property; object_class->set_property = gtk_cell_renderer_spin_set_property; cell_class->start_editing = gtk_cell_renderer_spin_start_editing; /** * GtkCellRendererSpin:adjustment: * * The adjustment that holds the value of the spinbutton. * This must be non-%NULL for the cell renderer to be editable. */ g_object_class_install_property (object_class, PROP_ADJUSTMENT, g_param_spec_object ("adjustment", P_("Adjustment"), P_("The adjustment that holds the value of the spin button"), GTK_TYPE_ADJUSTMENT, GTK_PARAM_READWRITE)); /** * GtkCellRendererSpin:climb-rate: * * The acceleration rate when you hold down a button. */ g_object_class_install_property (object_class, PROP_CLIMB_RATE, g_param_spec_double ("climb-rate", P_("Climb rate"), P_("The acceleration rate when you hold down a button"), 0.0, G_MAXDOUBLE, 0.0, GTK_PARAM_READWRITE)); /** * GtkCellRendererSpin:digits: * * The number of decimal places to display. */ g_object_class_install_property (object_class, PROP_DIGITS, g_param_spec_uint ("digits", P_("Digits"), P_("The number of decimal places to display"), 0, 20, 0, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); } static void gtk_cell_renderer_spin_init (GtkCellRendererSpin *self) { GtkCellRendererSpinPrivate *priv; self->priv = gtk_cell_renderer_spin_get_instance_private (self); priv = self->priv; priv->adjustment = NULL; priv->climb_rate = 0.0; priv->digits = 0; } static void gtk_cell_renderer_spin_finalize (GObject *object) { GtkCellRendererSpinPrivate *priv; priv = GTK_CELL_RENDERER_SPIN (object)->priv; if (priv && priv->adjustment) g_object_unref (priv->adjustment); G_OBJECT_CLASS (gtk_cell_renderer_spin_parent_class)->finalize (object); } static void gtk_cell_renderer_spin_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec) { GtkCellRendererSpin *renderer; GtkCellRendererSpinPrivate *priv; renderer = GTK_CELL_RENDERER_SPIN (object); priv = renderer->priv; switch (prop_id) { case PROP_ADJUSTMENT: g_value_set_object (value, priv->adjustment); break; case PROP_CLIMB_RATE: g_value_set_double (value, priv->climb_rate); break; case PROP_DIGITS: g_value_set_uint (value, priv->digits); break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void gtk_cell_renderer_spin_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec) { GtkCellRendererSpin *renderer; GtkCellRendererSpinPrivate *priv; GObject *obj; renderer = GTK_CELL_RENDERER_SPIN (object); priv = renderer->priv; switch (prop_id) { case PROP_ADJUSTMENT: obj = g_value_get_object (value); if (priv->adjustment) { g_object_unref (priv->adjustment); priv->adjustment = NULL; } if (obj) priv->adjustment = GTK_ADJUSTMENT (g_object_ref_sink (obj)); break; case PROP_CLIMB_RATE: priv->climb_rate = g_value_get_double (value); break; case PROP_DIGITS: if (priv->digits != g_value_get_uint (value)) { priv->digits = g_value_get_uint (value); g_object_notify_by_pspec (object, pspec); } break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec); break; } } static void gtk_cell_renderer_spin_focus_changed (GtkWidget *widget, GParamSpec *pspec, gpointer data) { const gchar *path; const gchar *new_text; gboolean canceled; if (gtk_widget_has_focus (widget)) return; g_object_get (widget, "editing-canceled", &canceled, NULL); g_signal_handlers_disconnect_by_func (widget, gtk_cell_renderer_spin_focus_changed, data); gtk_cell_renderer_stop_editing (GTK_CELL_RENDERER (data), canceled); if (!canceled) { path = g_object_get_data (G_OBJECT (widget), GTK_CELL_RENDERER_SPIN_PATH); new_text = gtk_editable_get_text (GTK_EDITABLE (widget)); g_signal_emit_by_name (data, "edited", path, new_text); } } static gboolean gtk_cell_renderer_spin_key_pressed (GtkEventControllerKey *controller, guint keyval, guint keycode, GdkModifierType state, GtkWidget *widget) { if (state == 0) { if (keyval == GDK_KEY_Up) { gtk_spin_button_spin (GTK_SPIN_BUTTON (widget), GTK_SPIN_STEP_FORWARD, 1); return TRUE; } else if (keyval == GDK_KEY_Down) { gtk_spin_button_spin (GTK_SPIN_BUTTON (widget), GTK_SPIN_STEP_BACKWARD, 1); return TRUE; } } return FALSE; } static GtkCellEditable * gtk_cell_renderer_spin_start_editing (GtkCellRenderer *cell, GdkEvent *event, GtkWidget *widget, const gchar *path, const GdkRectangle *background_area, const GdkRectangle *cell_area, GtkCellRendererState flags) { GtkCellRendererSpinPrivate *priv; GtkCellRendererText *cell_text; GtkEventController *key_controller; GtkWidget *spin; gboolean editable; gchar *text; cell_text = GTK_CELL_RENDERER_TEXT (cell); priv = GTK_CELL_RENDERER_SPIN (cell)->priv; g_object_get (cell_text, "editable", &editable, NULL); if (!editable) return NULL; if (!priv->adjustment) return NULL; spin = gtk_spin_button_new (priv->adjustment, priv->climb_rate, priv->digits); g_object_get (cell_text, "text", &text, NULL); if (text) { gtk_spin_button_set_value (GTK_SPIN_BUTTON (spin), g_strtod (text, NULL)); g_free (text); } key_controller = gtk_event_controller_key_new (); g_signal_connect (key_controller, "key-pressed", G_CALLBACK (gtk_cell_renderer_spin_key_pressed), spin); gtk_widget_add_controller (spin, key_controller); g_object_set_data_full (G_OBJECT (spin), GTK_CELL_RENDERER_SPIN_PATH, g_strdup (path), g_free); g_signal_connect (G_OBJECT (spin), "notify::has-focus", G_CALLBACK (gtk_cell_renderer_spin_focus_changed), cell); gtk_widget_show (spin); return GTK_CELL_EDITABLE (spin); } /** * gtk_cell_renderer_spin_new: * * Creates a new #GtkCellRendererSpin. * * Returns: a new #GtkCellRendererSpin */ GtkCellRenderer * gtk_cell_renderer_spin_new (void) { return g_object_new (GTK_TYPE_CELL_RENDERER_SPIN, NULL); }