<refentry id="gnomeui-gnome-dialog-util"> <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 <gnome.h> <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> :</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> :</entry> <entry> Message to display </entry></row> <row><entry align="right"><parameter>parent</parameter> :</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> :</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> :</entry> <entry> </entry></row> <row><entry align="right"><parameter>parent</parameter> :</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> :</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> :</entry> <entry> Message to display </entry></row> <row><entry align="right"><parameter>parent</parameter> :</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> :</entry> <entry> Question to ask </entry></row> <row><entry align="right"><parameter>callback</parameter> :</entry> <entry> Callback function for handling dialog results </entry></row> <row><entry align="right"><parameter>data</parameter> :</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> :</entry> <entry> Question to ask </entry></row> <row><entry align="right"><parameter>callback</parameter> :</entry> <entry> Callback function for handling dialog results </entry></row> <row><entry align="right"><parameter>data</parameter> :</entry> <entry> Data to pass to callback </entry></row> <row><entry align="right"><parameter>parent</parameter> :</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> :</entry> <entry> Question to ask </entry></row> <row><entry align="right"><parameter>callback</parameter> :</entry> <entry> Callback function for handling dialog results </entry></row> <row><entry align="right"><parameter>data</parameter> :</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> :</entry> <entry> Question to ask </entry></row> <row><entry align="right"><parameter>callback</parameter> :</entry> <entry> Callback function for handling dialog results </entry></row> <row><entry align="right"><parameter>data</parameter> :</entry> <entry> Data to pass to callback </entry></row> <row><entry align="right"><parameter>parent</parameter> :</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> :</entry> <entry> Message to display </entry></row> <row><entry align="right"><parameter>callback</parameter> :</entry> <entry> Callback function for handling dialog results </entry></row> <row><entry align="right"><parameter>data</parameter> :</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> :</entry> <entry> Message to display </entry></row> <row><entry align="right"><parameter>callback</parameter> :</entry> <entry> Callback function for handling dialog results </entry></row> <row><entry align="right"><parameter>data</parameter> :</entry> <entry> Data to pass to callback </entry></row> <row><entry align="right"><parameter>parent</parameter> :</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> :</entry> <entry> Message to display </entry></row> <row><entry align="right"><parameter>callback</parameter> :</entry> <entry> Callback function for handling dialog results </entry></row> <row><entry align="right"><parameter>data</parameter> :</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> :</entry> <entry> Message to display </entry></row> <row><entry align="right"><parameter>callback</parameter> :</entry> <entry> Callback function for handling dialog results </entry></row> <row><entry align="right"><parameter>data</parameter> :</entry> <entry> Data to pass to callback </entry></row> <row><entry align="right"><parameter>parent</parameter> :</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> :</entry> <entry> </entry></row> <row><entry align="right"><parameter>callback</parameter> :</entry> <entry> </entry></row> <row><entry align="right"><parameter>data</parameter> :</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> :</entry> <entry> </entry></row> <row><entry align="right"><parameter>callback</parameter> :</entry> <entry> </entry></row> <row><entry align="right"><parameter>data</parameter> :</entry> <entry> </entry></row> <row><entry align="right"><parameter>parent</parameter> :</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> :</entry> <entry> </entry></row> <row><entry align="right"><parameter>callback</parameter> :</entry> <entry> </entry></row> <row><entry align="right"><parameter>data</parameter> :</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> :</entry> <entry> </entry></row> <row><entry align="right"><parameter>callback</parameter> :</entry> <entry> </entry></row> <row><entry align="right"><parameter>data</parameter> :</entry> <entry> </entry></row> <row><entry align="right"><parameter>parent</parameter> :</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> :</entry> <entry> <literal>TRUE</literal> if on-screen text input is masked </entry></row> <row><entry align="right"><parameter>prompt</parameter> :</entry> <entry> Text of the prompt to be displayed </entry></row> <row><entry align="right"><parameter>default_text</parameter> :</entry> <entry> Default text in entry widget, <literal>NULL</literal> if none </entry></row> <row><entry align="right"><parameter>max_length</parameter> :</entry> <entry> Maximum input chars allowed </entry></row> <row><entry align="right"><parameter>callback</parameter> :</entry> <entry> Callback function for handling dialog results </entry></row> <row><entry align="right"><parameter>data</parameter> :</entry> <entry> Data passed to the callback </entry></row> <row><entry align="right"><parameter>parent</parameter> :</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>