<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>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
1bbf51ece72e40a5f40ad48678e7c5a5
>
files
>
528
