Gnome User Interface Library Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# GnomeNumberEntry

## Name

GnomeNumberEntry -- An entry line for number input.

## Synopsis

    #include <gnome.h>

    struct      GnomeNumberEntry;
    GtkWidget*  gnome_number_entry_new          (char *history_id,
                                                 char *calc_dialog_title);
    GtkWidget*  gnome_number_entry_gnome_entry  (GnomeNumberEntry *nentry);
    GtkWidget*  gnome_number_entry_gtk_entry    (GnomeNumberEntry *nentry);
    void        gnome_number_entry_set_title    (GnomeNumberEntry *nentry,
                                                 char *calc_dialog_title);
    gdouble     gnome_number_entry_get_number   (GnomeNumberEntry *nentry);

## Object Hierarchy

      GtkObject
       +----GtkWidget
             +----GtkContainer
                   +----GtkBox
                         +----GtkHBox
                               +----GnomeNumberEntry

## Description

Provides an entry line for numbers. This routine does not attempt to do any validation on the valid number ranges, but provides a button that will let the user bring up a calculator to fill in the value of the entry widget.

## Details

### struct GnomeNumberEntry

    struct GnomeNumberEntry;

### gnome_number_entry_new ()

    GtkWidget*  gnome_number_entry_new          (char *history_id,
                                                 char *calc_dialog_title);

Creates a new number entry widget, with a history id and title for the calculator dialog.

`history_id` : | The history id given to gnome_entry_new
`calc_dialog_title` : | Title of the calculator dialog
Returns : | New widget

### gnome_number_entry_gnome_entry ()

    GtkWidget*  gnome_number_entry_gnome_entry  (GnomeNumberEntry *nentry);

Get the GnomeEntry component of the GnomeNumberEntry for lower-level manipulation.

`nentry` : | Pointer to GnomeNumberEntry widget
Returns : | GnomeEntry widget

### gnome_number_entry_gtk_entry ()

    GtkWidget*  gnome_number_entry_gtk_entry    (GnomeNumberEntry *nentry);

Get the GtkEntry component of the GnomeNumberEntry for Gtk+-level manipulation.

`nentry` : | Pointer to GnomeNumberEntry widget
Returns : | GtkEntry widget

### gnome_number_entry_set_title ()

    void        gnome_number_entry_set_title    (GnomeNumberEntry *nentry,
                                                 char *calc_dialog_title);

Set the title of the calculator dialog to `calc_dialog_title`. Takes effect the next time the calculator button is pressed.

`nentry` : | Pointer to GnomeNumberEntry widget
`calc_dialog_title` : | New title

### gnome_number_entry_get_number ()

    gdouble     gnome_number_entry_get_number   (GnomeNumberEntry *nentry);

Get the current number from the entry

`nentry` : | Pointer to GnomeNumberEntry widget
Returns : | Value currently in the entry.

## See Also

GnomeCalculator, GnomeEntry

<<< Previous Page | Home | Up | Next Page >>>
GnomeMessageBox | GnomePaperSelector