NumericalEntry

NumericalEntry — Defines a widget to enter numerical values without any boundary or precision constrains.

Synopsis




            NumericalEntry;
GtkWidget*  numericalEntry_new              (double value);
double      numericalEntryGet_value         (NumericalEntry *numericalEntry);
void        numericalEntrySet_value         (NumericalEntry *numericalEntry,
                                             double value);


Object Hierarchy


  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkEntry
                           +----NumericalEntry

Implemented Interfaces

NumericalEntry implements AtkImplementorIface, GtkCellEditable and GtkEditable.

Signals


"value-changed"
            void        user_function      (NumericalEntry *entry,
                                            gdouble         oldValue,
                                            gpointer        user_data)      : Run first / Action

Description

This widget is based on the GtkEntry widget but behaves more like a GtkSpinButton is fact. It is designed to enter numerical values, but without any boundary or precision constrains. One can use either plain or scientific notations.

Details

NumericalEntry

typedef struct _NumericalEntry NumericalEntry;

Short form for a NumericalEntry_struct structure.


numericalEntry_new ()

GtkWidget*  numericalEntry_new              (double value);

A NumericalEntry widget is like a GtkEntry widget, but it only accepts double precision values (written in plain format, e.g. 1.23456, or scientific notation, e.g. 1.2345e6). The widget can't be blank and there is always a value printed in it. If the user erase the current value or enter something that is not a recognised double precision value, the widget returns to its previous valid value.

value : the initial value.
Returns : a newly created NumericalEntry widget.

numericalEntryGet_value ()

double      numericalEntryGet_value         (NumericalEntry *numericalEntry);

You can get the value contained in the given numericalEntry using this method.

numericalEntry : a NumericalEntry widget.
Returns : the double precision value printed in the NumericalEntry.

numericalEntrySet_value ()

void        numericalEntrySet_value         (NumericalEntry *numericalEntry,
                                             double value);

Use this method to set the value for the given numericalEntry widget.

numericalEntry : a NumericalEntry widget ;
value : a double precision value.

Signal Details

The "value-changed" signal

void        user_function                  (NumericalEntry *entry,
                                            gdouble         oldValue,
                                            gpointer        user_data)      : Run first / Action

This signal is emitted when a new valid numerical value is entered.

entry : the NumericalEntry that emits the signal ;
oldValue : the previous value.
user_data : user data set when the signal handler was connected.

Since 3.1