GtkCellRendererSpin

GtkCellRendererSpin — Renders a spin button in a cell

Synopsis

#include <gtk/gtk.h>

struct              GtkCellRendererSpin;
GtkCellRenderer *   gtk_cell_renderer_spin_new          (void);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkCellRenderer
               +----GtkCellRendererText
                     +----GtkCellRendererSpin

Properties

  "adjustment"               GtkAdjustment*        : Read / Write
  "climb-rate"               gdouble               : Read / Write
  "digits"                   guint                 : Read / Write

Description

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 "climb-rate" and the number of "digits" to display. Other GtkSpinButton properties can be set in a handler for the "editing-started" signal.

The GtkCellRendererSpin cell renderer was added in GTK+ 2.10.

Details

struct GtkCellRendererSpin

struct GtkCellRendererSpin;

gtk_cell_renderer_spin_new ()

GtkCellRenderer *   gtk_cell_renderer_spin_new          (void);

Creates a new GtkCellRendererSpin.

Returns :

a new GtkCellRendererSpin

Since 2.10

Property Details

The "adjustment" property

  "adjustment"               GtkAdjustment*        : Read / Write

The adjustment that holds the value of the spinbutton. This must be non-NULL for the cell renderer to be editable.

Since 2.10


The "climb-rate" property

  "climb-rate"               gdouble               : Read / Write

The acceleration rate when you hold down a button.

Allowed values: >= 0

Default value: 0

Since 2.10


The "digits" property

  "digits"                   guint                 : Read / Write

The number of decimal places to display.

Allowed values: <= 20

Default value: 0

Since 2.10

See Also

GtkCellRendererText, GtkSpinButton