<HTML
><HEAD
><TITLE
>gnome-dialog-util</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-canvas-util"
HREF="gnomeui-gnome-canvas-util.html"><LINK
REL="NEXT"
TITLE="gnome-dns"
HREF="gnomeui-gnome-dns.html"></HEAD
><BODY
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="5"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-canvas-util.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-dns.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-DIALOG-UTIL"
>gnome-dialog-util</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN3284"
></A
><H2
>Name</H2
>gnome-dialog-util&nbsp;--&nbsp;Convenience functions for making dialogs.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN3287"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-OK-DIALOG"
>gnome_ok_dialog</A
>                 (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *message);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-OK-DIALOG-PARENTED"
>gnome_ok_dialog_parented</A
>        (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *message,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-ERROR-DIALOG"
>gnome_error_dialog</A
>              (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *error);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-ERROR-DIALOG-PARENTED"
>gnome_error_dialog_parented</A
>     (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *error,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-WARNING-DIALOG"
>gnome_warning_dialog</A
>            (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *warning);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-WARNING-DIALOG-PARENTED"
>gnome_warning_dialog_parented</A
>   (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *warning,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-QUESTION-DIALOG"
>gnome_question_dialog</A
>           (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-QUESTION-DIALOG-PARENTED"
>gnome_question_dialog_parented</A
>  (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-QUESTION-DIALOG-MODAL"
>gnome_question_dialog_modal</A
>     (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-QUESTION-DIALOG-MODAL-PARENTED"
>gnome_question_dialog_modal_parented</A
>
                                            (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-OK-CANCEL-DIALOG"
>gnome_ok_cancel_dialog</A
>          (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-OK-CANCEL-DIALOG-PARENTED"
>gnome_ok_cancel_dialog_parented</A
> (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-OK-CANCEL-DIALOG-MODAL"
>gnome_ok_cancel_dialog_modal</A
>    (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-OK-CANCEL-DIALOG-MODAL-PARENTED"
>gnome_ok_cancel_dialog_modal_parented</A
>
                                            (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-STRING-DIALOG"
>gnome_request_string_dialog</A
>     (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-STRING-DIALOG-PARENTED"
>gnome_request_string_dialog_parented</A
>
                                            (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-PASSWORD-DIALOG"
>gnome_request_password_dialog</A
>   (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-PASSWORD-DIALOG-PARENTED"
>gnome_request_password_dialog_parented</A
>
                                            (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);
<GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-DIALOG"
>gnome_request_dialog</A
>            (<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> password,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *prompt,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *default_text,
                                             const <GTKDOCLINK
HREF="GUINT16"
>guint16</GTKDOCLINK
> max_length,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN3386"
></A
><H2
>Description</H2
><P
>These functions create common dialogs for you. In all cases, you
should prefer the <GTKDOCLINK
HREF="PARENTED"
>_parented</GTKDOCLINK
>() variants, because they will properly
call <A
HREF="gnomedialog.html#GNOME-DIALOG-SET-PARENT"
>gnome_dialog_set_parent</A
>() prior to showing the dialog. All of
these functions automatically show the dialog before they return.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN3391"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN3393"
></A
><H3
><A
NAME="GNOME-OK-DIALOG"
></A
>gnome_ok_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_ok_dialog                 (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *message);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows a simple message dialog.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3414"
></A
><H3
><A
NAME="GNOME-OK-DIALOG-PARENTED"
></A
>gnome_ok_dialog_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_ok_dialog_parented        (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *message,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows a simple message dialog.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3440"
></A
><H3
><A
NAME="GNOME-ERROR-DIALOG"
></A
>gnome_error_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_error_dialog              (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *error);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows a error dialog.  This is an OK
dialog to display on fatally failed operations.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>error</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3461"
></A
><H3
><A
NAME="GNOME-ERROR-DIALOG-PARENTED"
></A
>gnome_error_dialog_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_error_dialog_parented     (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *error,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows a error dialog.  This is an OK
dialog to display on fatally failed operations.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>error</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3487"
></A
><H3
><A
NAME="GNOME-WARNING-DIALOG"
></A
>gnome_warning_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_warning_dialog            (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *warning);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows a warning dialog.  For non-fatal
warnings.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>warning</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3508"
></A
><H3
><A
NAME="GNOME-WARNING-DIALOG-PARENTED"
></A
>gnome_warning_dialog_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_warning_dialog_parented   (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *warning,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows a warning dialog.  For non-fatal
warnings.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>warning</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3534"
></A
><H3
><A
NAME="GNOME-QUESTION-DIALOG"
></A
>gnome_question_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_question_dialog           (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
>Creates a question dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>question</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Question to ask</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3567"
></A
><H3
><A
NAME="GNOME-QUESTION-DIALOG-PARENTED"
></A
>gnome_question_dialog_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_question_dialog_parented  (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates a question dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
when user answers the button number is passed onto 'reply'.
0 is for 'Yes', 1 for 'No'</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>question</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Question to ask</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3605"
></A
><H3
><A
NAME="GNOME-QUESTION-DIALOG-MODAL"
></A
>gnome_question_dialog_modal ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_question_dialog_modal     (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
>Creates a question dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
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.</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>question</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Question to ask</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3638"
></A
><H3
><A
NAME="GNOME-QUESTION-DIALOG-MODAL-PARENTED"
></A
>gnome_question_dialog_modal_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_question_dialog_modal_parented
                                            (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *question,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates a question dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
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.</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>question</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Question to ask</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3676"
></A
><H3
><A
NAME="GNOME-OK-CANCEL-DIALOG"
></A
>gnome_ok_cancel_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_ok_cancel_dialog          (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
>Creates an OK/Cancel dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3709"
></A
><H3
><A
NAME="GNOME-OK-CANCEL-DIALOG-PARENTED"
></A
>gnome_ok_cancel_dialog_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_ok_cancel_dialog_parented (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates an OK/Cancel dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
when user answers the button number is passed onto 'reply'.
0 is for 'OK', 1 for 'Cancel'.</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3747"
></A
><H3
><A
NAME="GNOME-OK-CANCEL-DIALOG-MODAL"
></A
>gnome_ok_cancel_dialog_modal ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_ok_cancel_dialog_modal    (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
>Creates an OK/Cancel dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
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.</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3780"
></A
><H3
><A
NAME="GNOME-OK-CANCEL-DIALOG-MODAL-PARENTED"
></A
>gnome_ok_cancel_dialog_modal_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_ok_cancel_dialog_modal_parented
                                            (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *message,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMEREPLYCALLBACK"
>GnomeReplyCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows an OK/Cancel dialog and calls <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>
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.</P
><P
>void (* GnomeReplyCallback)(gint reply, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>message</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Message to display</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data to pass to callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3818"
></A
><H3
><A
NAME="GNOME-REQUEST-STRING-DIALOG"
></A
>gnome_request_string_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_request_string_dialog     (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
>Deprecated, use <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-DIALOG"
>gnome_request_dialog</A
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>prompt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3850"
></A
><H3
><A
NAME="GNOME-REQUEST-STRING-DIALOG-PARENTED"
></A
>gnome_request_string_dialog_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_request_string_dialog_parented
                                            (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);</PRE
></TD
></TR
></TABLE
><P
>Deprecated, use <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-DIALOG"
>gnome_request_dialog</A
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>prompt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3887"
></A
><H3
><A
NAME="GNOME-REQUEST-PASSWORD-DIALOG"
></A
>gnome_request_password_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_request_password_dialog   (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
>Deprecated, use <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-DIALOG"
>gnome_request_dialog</A
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>prompt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3919"
></A
><H3
><A
NAME="GNOME-REQUEST-PASSWORD-DIALOG-PARENTED"
></A
>gnome_request_password_dialog_parented ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_request_password_dialog_parented
                                            (const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *prompt,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);</PRE
></TD
></TR
></TABLE
><P
>Deprecated, use <A
HREF="gnomeui-gnome-dialog-util.html#GNOME-REQUEST-DIALOG"
>gnome_request_dialog</A
></P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>prompt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>&nbsp;</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3956"
></A
><H3
><A
NAME="GNOME-REQUEST-DIALOG"
></A
>gnome_request_dialog ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GTKWIDGET"
>GtkWidget</GTKDOCLINK
>*  gnome_request_dialog            (<GTKDOCLINK
HREF="GBOOLEAN"
>gboolean</GTKDOCLINK
> password,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *prompt,
                                             const <GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *default_text,
                                             const <GTKDOCLINK
HREF="GUINT16"
>guint16</GTKDOCLINK
> max_length,
                                             <A
HREF="gnomeui-gnome-types.html#GNOMESTRINGCALLBACK"
>GnomeStringCallback</A
> callback,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKWINDOW"
>GtkWindow</GTKDOCLINK
> *parent);</PRE
></TD
></TR
></TABLE
><P
>Creates and shows a GNOME text entry request dialog.
<TT
CLASS="PARAMETER"
><I
>callback</I
></TT
> is called when the dialog closes, passing the text entry
input or <TT
CLASS="LITERAL"
>NULL</TT
> if the user cancelled.  <TT
CLASS="PARAMETER"
><I
>callback</I
></TT
> is defined as</P
><P
>void (* GnomeStringCallback)(gchar * string, gpointer data);</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>password</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> <TT
CLASS="LITERAL"
>TRUE</TT
> if on-screen text input is masked</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>prompt</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Text of the prompt to be displayed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>default_text</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Default text in entry widget, <TT
CLASS="LITERAL"
>NULL</TT
> if none</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>max_length</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Maximum input chars allowed</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>callback</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Callback function for handling dialog results</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Data passed to the callback</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>parent</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Parent window, or <TT
CLASS="LITERAL"
>NULL</TT
> for no parent.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>  Pointer to new GNOME dialog object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-canvas-util.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-dns.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-canvas-util</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-dns</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>