<refentry id="GnomeNumberEntry"> <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 <gnome.h> 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> :</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> :</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> :</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> :</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> :</entry> <entry> Pointer to GnomeNumberEntry widget </entry></row> <row><entry align="right"><parameter>calc_dialog_title</parameter> :</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> :</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>