<refentry id="GnomeNumberEntry" revision="20 Jun 2000">
<refmeta>
<refentrytitle>GnomeNumberEntry</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GNOMEUI Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GnomeNumberEntry</refname><refpurpose>An entry line for number input.</refpurpose>
</refnamediv>

<refsynopsisdiv><title>Synopsis</title>
<synopsis>

#include &lt;gnome.h&gt;


struct      <link linkend="GnomeNumberEntry-struct">GnomeNumberEntry</link>;
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-number-entry-new">gnome_number_entry_new</link>          (char *history_id,
                                             char *calc_dialog_title);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-number-entry-gnome-entry">gnome_number_entry_gnome_entry</link>  (<link linkend="GnomeNumberEntry">GnomeNumberEntry</link> *nentry);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-number-entry-gtk-entry">gnome_number_entry_gtk_entry</link>    (<link linkend="GnomeNumberEntry">GnomeNumberEntry</link> *nentry);
void        <link linkend="gnome-number-entry-set-title">gnome_number_entry_set_title</link>    (<link linkend="GnomeNumberEntry">GnomeNumberEntry</link> *nentry,
                                             char *calc_dialog_title);
<link linkend="gdouble">gdouble</link>     <link linkend="gnome-number-entry-get-number">gnome_number_entry_get_number</link>   (<link linkend="GnomeNumberEntry">GnomeNumberEntry</link> *nentry);

</synopsis>
</refsynopsisdiv>

<refsect1>
<title>Object Hierarchy</title>
<synopsis>

  <link linkend="GtkObject">GtkObject</link>
   +----<link linkend="GtkWidget">GtkWidget</link>
         +----<link linkend="GtkContainer">GtkContainer</link>
               +----<link linkend="GtkBox">GtkBox</link>
                     +----<link linkend="GtkHBox">GtkHBox</link>
                           +----GnomeNumberEntry
</synopsis>

</refsect1>




<refsect1>
<title>Description</title>
  <para>
    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.
  </para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="GnomeNumberEntry-struct">struct GnomeNumberEntry</title>
<programlisting>struct GnomeNumberEntry;</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="gnome-number-entry-new">gnome_number_entry_new ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_number_entry_new          (char *history_id,
                                             char *calc_dialog_title);</programlisting>
<para>
Creates a new number entry widget, with a history id
and title for the calculator dialog.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>history_id</parameter>&nbsp;:</entry>
<entry> The history id given to <link linkend="gnome-entry-new">gnome_entry_new</link>
</entry></row>
<row><entry align="right"><parameter>calc_dialog_title</parameter>&nbsp;:</entry>
<entry> Title of the calculator dialog
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> New widget
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-number-entry-gnome-entry">gnome_number_entry_gnome_entry ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_number_entry_gnome_entry  (<link linkend="GnomeNumberEntry">GnomeNumberEntry</link> *nentry);</programlisting>
<para>
Get the GnomeEntry component of the
GnomeNumberEntry for lower-level manipulation.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>nentry</parameter>&nbsp;:</entry>
<entry> Pointer to GnomeNumberEntry widget
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> GnomeEntry widget
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-number-entry-gtk-entry">gnome_number_entry_gtk_entry ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_number_entry_gtk_entry    (<link linkend="GnomeNumberEntry">GnomeNumberEntry</link> *nentry);</programlisting>
<para>
Get the GtkEntry component of the
GnomeNumberEntry for Gtk+-level manipulation.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>nentry</parameter>&nbsp;:</entry>
<entry> Pointer to GnomeNumberEntry widget
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> GtkEntry widget
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-number-entry-set-title">gnome_number_entry_set_title ()</title>
<programlisting>void        gnome_number_entry_set_title    (<link linkend="GnomeNumberEntry">GnomeNumberEntry</link> *nentry,
                                             char *calc_dialog_title);</programlisting>
<para>
Set the title of the calculator dialog to <parameter>calc_dialog_title</parameter>.
Takes effect the next time the calculator button is pressed.</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>nentry</parameter>&nbsp;:</entry>
<entry> Pointer to GnomeNumberEntry widget
</entry></row>
<row><entry align="right"><parameter>calc_dialog_title</parameter>&nbsp;:</entry>
<entry> New title
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-number-entry-get-number">gnome_number_entry_get_number ()</title>
<programlisting><link linkend="gdouble">gdouble</link>     gnome_number_entry_get_number   (<link linkend="GnomeNumberEntry">GnomeNumberEntry</link> *nentry);</programlisting>
<para>
Get the current number from the entry</para>
<para>

</para><informaltable pgwide=1 frame="none" role="params">
<tgroup cols="2">
<colspec colwidth="2*">
<colspec colwidth="8*">
<tbody>
<row><entry align="right"><parameter>nentry</parameter>&nbsp;:</entry>
<entry> Pointer to GnomeNumberEntry widget
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry> Value currently in the entry.
</entry></row>
</tbody></tgroup></informaltable></refsect2>

</refsect1>



<refsect1>
<title>See Also</title>
<para>
    <link linkend="GnomeCalculator">GnomeCalculator</link>, <link linkend="GnomeEntry">GnomeEntry</link>
</para>
</refsect1>

</refentry>
