<refentry id="gnomeui-gnome-dialog-util" revision="20 Jun 2000">
<refmeta>
<refentrytitle>gnome-dialog-util</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GNOMEUI Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>gnome-dialog-util</refname><refpurpose>
Convenience functions for making dialogs.</refpurpose>
</refnamediv>

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

#include &lt;gnome.h&gt;


<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-ok-dialog">gnome_ok_dialog</link>                 (const <link linkend="gchar">gchar</link> *message);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-ok-dialog-parented">gnome_ok_dialog_parented</link>        (const <link linkend="gchar">gchar</link> *message,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-error-dialog">gnome_error_dialog</link>              (const <link linkend="gchar">gchar</link> *error);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-error-dialog-parented">gnome_error_dialog_parented</link>     (const <link linkend="gchar">gchar</link> *error,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-warning-dialog">gnome_warning_dialog</link>            (const <link linkend="gchar">gchar</link> *warning);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-warning-dialog-parented">gnome_warning_dialog_parented</link>   (const <link linkend="gchar">gchar</link> *warning,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-question-dialog">gnome_question_dialog</link>           (const <link linkend="gchar">gchar</link> *question,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-question-dialog-parented">gnome_question_dialog_parented</link>  (const <link linkend="gchar">gchar</link> *question,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-question-dialog-modal">gnome_question_dialog_modal</link>     (const <link linkend="gchar">gchar</link> *question,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-question-dialog-modal-parented">gnome_question_dialog_modal_parented</link>
                                            (const <link linkend="gchar">gchar</link> *question,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-ok-cancel-dialog">gnome_ok_cancel_dialog</link>          (const <link linkend="gchar">gchar</link> *message,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-ok-cancel-dialog-parented">gnome_ok_cancel_dialog_parented</link> (const <link linkend="gchar">gchar</link> *message,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-ok-cancel-dialog-modal">gnome_ok_cancel_dialog_modal</link>    (const <link linkend="gchar">gchar</link> *message,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-ok-cancel-dialog-modal-parented">gnome_ok_cancel_dialog_modal_parented</link>
                                            (const <link linkend="gchar">gchar</link> *message,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-request-string-dialog">gnome_request_string_dialog</link>     (const <link linkend="gchar">gchar</link> *prompt,
                                             <link linkend="GnomeStringCallback">GnomeStringCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-request-string-dialog-parented">gnome_request_string_dialog_parented</link>
                                            (const <link linkend="gchar">gchar</link> *prompt,
                                             <link linkend="GnomeStringCallback">GnomeStringCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-request-password-dialog">gnome_request_password_dialog</link>   (const <link linkend="gchar">gchar</link> *prompt,
                                             <link linkend="GnomeStringCallback">GnomeStringCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-request-password-dialog-parented">gnome_request_password_dialog_parented</link>
                                            (const <link linkend="gchar">gchar</link> *prompt,
                                             <link linkend="GnomeStringCallback">GnomeStringCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);
<link linkend="GtkWidget">GtkWidget</link>*  <link linkend="gnome-request-dialog">gnome_request_dialog</link>            (<link linkend="gboolean">gboolean</link> password,
                                             const <link linkend="gchar">gchar</link> *prompt,
                                             const <link linkend="gchar">gchar</link> *default_text,
                                             const <link linkend="guint16">guint16</link> max_length,
                                             <link linkend="GnomeStringCallback">GnomeStringCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);
</synopsis>
</refsynopsisdiv>





<refsect1>
<title>Description</title>
<para>
These functions create common dialogs for you. In all cases, you
should prefer the <link linkend="parented">_parented</link>() variants, because they will properly
call <link linkend="gnome-dialog-set-parent">gnome_dialog_set_parent</link>() prior to showing the dialog. All of
these functions automatically show the dialog before they return.
</para>
</refsect1>

<refsect1>
<title>Details</title>
<refsect2>
<title><anchor id="gnome-ok-dialog">gnome_ok_dialog ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_ok_dialog                 (const <link linkend="gchar">gchar</link> *message);</programlisting>
<para>
Creates and shows a simple message 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>message</parameter>&nbsp;:</entry>
<entry> Message to display
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>  Pointer to new GNOME dialog object.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-ok-dialog-parented">gnome_ok_dialog_parented ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_ok_dialog_parented        (const <link linkend="gchar">gchar</link> *message,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);</programlisting>
<para>
Creates and shows a simple message 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>message</parameter>&nbsp;:</entry>
<entry> Message to display
</entry></row>
<row><entry align="right"><parameter>parent</parameter>&nbsp;:</entry>
<entry> Parent window
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>  Pointer to new GNOME dialog object.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-error-dialog">gnome_error_dialog ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_error_dialog              (const <link linkend="gchar">gchar</link> *error);</programlisting>
<para>
Creates and shows a error dialog.  This is an OK
dialog to display on fatally failed operations.</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>error</parameter>&nbsp;:</entry>
<entry> Message to display
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>  Pointer to new GNOME dialog object.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-error-dialog-parented">gnome_error_dialog_parented ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_error_dialog_parented     (const <link linkend="gchar">gchar</link> *error,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);</programlisting>
<para>
Creates and shows a error dialog.  This is an OK
dialog to display on fatally failed operations.</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>error</parameter>&nbsp;:</entry>
<entry></entry></row>
<row><entry align="right"><parameter>parent</parameter>&nbsp;:</entry>
<entry> Parent window
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>  Pointer to new GNOME dialog object.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-warning-dialog">gnome_warning_dialog ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_warning_dialog            (const <link linkend="gchar">gchar</link> *warning);</programlisting>
<para>
Creates and shows a warning dialog.  For non-fatal
warnings.</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>warning</parameter>&nbsp;:</entry>
<entry> Message to display
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>  Pointer to new GNOME dialog object.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-warning-dialog-parented">gnome_warning_dialog_parented ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_warning_dialog_parented   (const <link linkend="gchar">gchar</link> *warning,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);</programlisting>
<para>
Creates and shows a warning dialog.  For non-fatal
warnings.</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>warning</parameter>&nbsp;:</entry>
<entry> Message to display
</entry></row>
<row><entry align="right"><parameter>parent</parameter>&nbsp;:</entry>
<entry> Parent window
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>  Pointer to new GNOME dialog object.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-question-dialog">gnome_question_dialog ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_question_dialog           (const <link linkend="gchar">gchar</link> *question,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
Creates a question dialog and calls <parameter>callback</parameter>
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'
</para>
<para>
void (* GnomeReplyCallback)(gint reply, gpointer data);</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>question</parameter>&nbsp;:</entry>
<entry> Question to ask
</entry></row>
<row><entry align="right"><parameter>callback</parameter>&nbsp;:</entry>
<entry> Callback function for handling dialog results
</entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry> Data to pass to callback
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>  Pointer to new GNOME dialog object.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-question-dialog-parented">gnome_question_dialog_parented ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_question_dialog_parented  (const <link linkend="gchar">gchar</link> *question,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);</programlisting>
<para>
Creates a question dialog and calls <parameter>callback</parameter>
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'
</para>
<para>
void (* GnomeReplyCallback)(gint reply, gpointer data);</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>question</parameter>&nbsp;:</entry>
<entry> Question to ask
</entry></row>
<row><entry align="right"><parameter>callback</parameter>&nbsp;:</entry>
<entry> Callback function for handling dialog results
</entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry> Data to pass to callback
</entry></row>
<row><entry align="right"><parameter>parent</parameter>&nbsp;:</entry>
<entry> Parent window
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>  Pointer to new GNOME dialog object.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-question-dialog-modal">gnome_question_dialog_modal ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_question_dialog_modal     (const <link linkend="gchar">gchar</link> *question,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
Creates a question dialog and calls <parameter>callback</parameter>
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'.  The dialog is created as a modal
dialog and the user will have to answer this before proceeding.
</para>
<para>
void (* GnomeReplyCallback)(gint reply, gpointer data);</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>question</parameter>&nbsp;:</entry>
<entry> Question to ask
</entry></row>
<row><entry align="right"><parameter>callback</parameter>&nbsp;:</entry>
<entry> Callback function for handling dialog results
</entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry> Data to pass to callback
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>  Pointer to new GNOME dialog object.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-question-dialog-modal-parented">gnome_question_dialog_modal_parented ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_question_dialog_modal_parented
                                            (const <link linkend="gchar">gchar</link> *question,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);</programlisting>
<para>
Creates a question dialog and calls <parameter>callback</parameter>
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'.  The dialog is created as a modal
dialog and the user will have to answer this before proceeding.
</para>
<para>
void (* GnomeReplyCallback)(gint reply, gpointer data);</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>question</parameter>&nbsp;:</entry>
<entry> Question to ask
</entry></row>
<row><entry align="right"><parameter>callback</parameter>&nbsp;:</entry>
<entry> Callback function for handling dialog results
</entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry> Data to pass to callback
</entry></row>
<row><entry align="right"><parameter>parent</parameter>&nbsp;:</entry>
<entry> Parent window
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>  Pointer to new GNOME dialog object.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-ok-cancel-dialog">gnome_ok_cancel_dialog ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_ok_cancel_dialog          (const <link linkend="gchar">gchar</link> *message,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
Creates an OK/Cancel dialog and calls <parameter>callback</parameter>
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.
</para>
<para>
void (* GnomeReplyCallback)(gint reply, gpointer data);</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>message</parameter>&nbsp;:</entry>
<entry> Message to display
</entry></row>
<row><entry align="right"><parameter>callback</parameter>&nbsp;:</entry>
<entry> Callback function for handling dialog results
</entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry> Data to pass to callback
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>  Pointer to new GNOME dialog object.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-ok-cancel-dialog-parented">gnome_ok_cancel_dialog_parented ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_ok_cancel_dialog_parented (const <link linkend="gchar">gchar</link> *message,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);</programlisting>
<para>
Creates an OK/Cancel dialog and calls <parameter>callback</parameter>
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.
</para>
<para>
void (* GnomeReplyCallback)(gint reply, gpointer data);</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>message</parameter>&nbsp;:</entry>
<entry> Message to display
</entry></row>
<row><entry align="right"><parameter>callback</parameter>&nbsp;:</entry>
<entry> Callback function for handling dialog results
</entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry> Data to pass to callback
</entry></row>
<row><entry align="right"><parameter>parent</parameter>&nbsp;:</entry>
<entry> Parent window
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>  Pointer to new GNOME dialog object.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-ok-cancel-dialog-modal">gnome_ok_cancel_dialog_modal ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_ok_cancel_dialog_modal    (const <link linkend="gchar">gchar</link> *message,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
Creates an OK/Cancel dialog and calls <parameter>callback</parameter>
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.  The dialog is created as a modal
dialog and the user will have to answer this before proceeding.
</para>
<para>
void (* GnomeReplyCallback)(gint reply, gpointer data);</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>message</parameter>&nbsp;:</entry>
<entry> Message to display
</entry></row>
<row><entry align="right"><parameter>callback</parameter>&nbsp;:</entry>
<entry> Callback function for handling dialog results
</entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry> Data to pass to callback
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>  Pointer to new GNOME dialog object.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-ok-cancel-dialog-modal-parented">gnome_ok_cancel_dialog_modal_parented ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_ok_cancel_dialog_modal_parented
                                            (const <link linkend="gchar">gchar</link> *message,
                                             <link linkend="GnomeReplyCallback">GnomeReplyCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);</programlisting>
<para>
Creates and shows an OK/Cancel dialog and calls <parameter>callback</parameter>
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.  The dialog is created as a modal
dialog and the user will have to answer this before proceeding.
</para>
<para>
void (* GnomeReplyCallback)(gint reply, gpointer data);</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>message</parameter>&nbsp;:</entry>
<entry> Message to display
</entry></row>
<row><entry align="right"><parameter>callback</parameter>&nbsp;:</entry>
<entry> Callback function for handling dialog results
</entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry> Data to pass to callback
</entry></row>
<row><entry align="right"><parameter>parent</parameter>&nbsp;:</entry>
<entry> Parent window
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>  Pointer to new GNOME dialog object.
</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-request-string-dialog">gnome_request_string_dialog ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_request_string_dialog     (const <link linkend="gchar">gchar</link> *prompt,
                                             <link linkend="GnomeStringCallback">GnomeStringCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
Deprecated, use <link linkend="gnome-request-dialog">gnome_request_dialog</link></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>prompt</parameter>&nbsp;:</entry>
<entry></entry></row>
<row><entry align="right"><parameter>callback</parameter>&nbsp;:</entry>
<entry></entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry></entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>

</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-request-string-dialog-parented">gnome_request_string_dialog_parented ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_request_string_dialog_parented
                                            (const <link linkend="gchar">gchar</link> *prompt,
                                             <link linkend="GnomeStringCallback">GnomeStringCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);</programlisting>
<para>
Deprecated, use <link linkend="gnome-request-dialog">gnome_request_dialog</link></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>prompt</parameter>&nbsp;:</entry>
<entry></entry></row>
<row><entry align="right"><parameter>callback</parameter>&nbsp;:</entry>
<entry></entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry></entry></row>
<row><entry align="right"><parameter>parent</parameter>&nbsp;:</entry>
<entry></entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>

</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-request-password-dialog">gnome_request_password_dialog ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_request_password_dialog   (const <link linkend="gchar">gchar</link> *prompt,
                                             <link linkend="GnomeStringCallback">GnomeStringCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data);</programlisting>
<para>
Deprecated, use <link linkend="gnome-request-dialog">gnome_request_dialog</link></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>prompt</parameter>&nbsp;:</entry>
<entry></entry></row>
<row><entry align="right"><parameter>callback</parameter>&nbsp;:</entry>
<entry></entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry></entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>

</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-request-password-dialog-parented">gnome_request_password_dialog_parented ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_request_password_dialog_parented
                                            (const <link linkend="gchar">gchar</link> *prompt,
                                             <link linkend="GnomeStringCallback">GnomeStringCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);</programlisting>
<para>
Deprecated, use <link linkend="gnome-request-dialog">gnome_request_dialog</link></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>prompt</parameter>&nbsp;:</entry>
<entry></entry></row>
<row><entry align="right"><parameter>callback</parameter>&nbsp;:</entry>
<entry></entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry></entry></row>
<row><entry align="right"><parameter>parent</parameter>&nbsp;:</entry>
<entry></entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>

</entry></row>
</tbody></tgroup></informaltable></refsect2>
<refsect2>
<title><anchor id="gnome-request-dialog">gnome_request_dialog ()</title>
<programlisting><link linkend="GtkWidget">GtkWidget</link>*  gnome_request_dialog            (<link linkend="gboolean">gboolean</link> password,
                                             const <link linkend="gchar">gchar</link> *prompt,
                                             const <link linkend="gchar">gchar</link> *default_text,
                                             const <link linkend="guint16">guint16</link> max_length,
                                             <link linkend="GnomeStringCallback">GnomeStringCallback</link> callback,
                                             <link linkend="gpointer">gpointer</link> data,
                                             <link linkend="GtkWindow">GtkWindow</link> *parent);</programlisting>
<para>
Creates and shows a GNOME text entry request dialog.
<parameter>callback</parameter> is called when the dialog closes, passing the text entry
input or <literal>NULL</literal> if the user cancelled.  <parameter>callback</parameter> is defined as
</para>
<para>
void (* GnomeStringCallback)(gchar * string, gpointer data);</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>password</parameter>&nbsp;:</entry>
<entry> <literal>TRUE</literal> if on-screen text input is masked
</entry></row>
<row><entry align="right"><parameter>prompt</parameter>&nbsp;:</entry>
<entry> Text of the prompt to be displayed
</entry></row>
<row><entry align="right"><parameter>default_text</parameter>&nbsp;:</entry>
<entry> Default text in entry widget, <literal>NULL</literal> if none
</entry></row>
<row><entry align="right"><parameter>max_length</parameter>&nbsp;:</entry>
<entry> Maximum input chars allowed
</entry></row>
<row><entry align="right"><parameter>callback</parameter>&nbsp;:</entry>
<entry> Callback function for handling dialog results
</entry></row>
<row><entry align="right"><parameter>data</parameter>&nbsp;:</entry>
<entry> Data passed to the callback
</entry></row>
<row><entry align="right"><parameter>parent</parameter>&nbsp;:</entry>
<entry> Parent window, or <literal>NULL</literal> for no parent.
</entry></row>
<row><entry align="right"><emphasis>Returns</emphasis> :</entry><entry>  Pointer to new GNOME dialog object.
</entry></row>
</tbody></tgroup></informaltable></refsect2>

</refsect1>




</refentry>
