<refentry id="GnomeDialog">
<refmeta>
<refentrytitle role="top_of_page" id="GnomeDialog.top_of_page">GnomeDialog</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>LIBGNOMEUI Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GnomeDialog</refname>
<refpurpose>Create generic dialog boxes.</refpurpose>
</refnamediv>

<refsynopsisdiv id="GnomeDialog.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

#include &lt;libgnomeui/libgnomeui.h&gt;

                    <link linkend="GnomeDialog-struct">GnomeDialog</link>;
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gnome-dialog-new">gnome_dialog_new</link>                    (const <link linkend="gchar">gchar</link> *title,
                                                         ...);
<link linkend="GtkWidget">GtkWidget</link>*          <link linkend="gnome-dialog-newv">gnome_dialog_newv</link>                   (const <link linkend="gchar">gchar</link> *title,
                                                         const <link linkend="gchar">gchar</link> **buttons);
<link linkend="void">void</link>                <link linkend="gnome-dialog-set-parent">gnome_dialog_set_parent</link>             (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="GtkWindow">GtkWindow</link> *parent);
<link linkend="void">void</link>                <link linkend="gnome-dialog-button-connect">gnome_dialog_button_connect</link>         (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gint">gint</link> button,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> data);
<link linkend="void">void</link>                <link linkend="gnome-dialog-button-connect-object">gnome_dialog_button_connect_object</link>  (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gint">gint</link> button,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="GtkObject">GtkObject</link> *obj);
<link linkend="gint">gint</link>                <link linkend="gnome-dialog-run">gnome_dialog_run</link>                    (<link linkend="GnomeDialog">GnomeDialog</link> *dialog);
<link linkend="gint">gint</link>                <link linkend="gnome-dialog-run-and-close">gnome_dialog_run_and_close</link>          (<link linkend="GnomeDialog">GnomeDialog</link> *dialog);
<link linkend="void">void</link>                <link linkend="gnome-dialog-set-default">gnome_dialog_set_default</link>            (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gint">gint</link> button);
<link linkend="void">void</link>                <link linkend="gnome-dialog-grab-focus">gnome_dialog_grab_focus</link>             (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gint">gint</link> button);
<link linkend="void">void</link>                <link linkend="gnome-dialog-set-sensitive">gnome_dialog_set_sensitive</link>          (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gint">gint</link> button,
                                                         <link linkend="gboolean">gboolean</link> setting);
<link linkend="void">void</link>                <link linkend="gnome-dialog-set-accelerator">gnome_dialog_set_accelerator</link>        (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gint">gint</link> button,
                                                         const <link linkend="guchar">guchar</link> accelerator_key,
                                                         <link linkend="guint8">guint8</link> accelerator_mods);
<link linkend="void">void</link>                <link linkend="gnome-dialog-close">gnome_dialog_close</link>                  (<link linkend="GnomeDialog">GnomeDialog</link> *dialog);
<link linkend="void">void</link>                <link linkend="gnome-dialog-close-hides">gnome_dialog_close_hides</link>            (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gboolean">gboolean</link> just_hide);
<link linkend="void">void</link>                <link linkend="gnome-dialog-set-close">gnome_dialog_set_close</link>              (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gboolean">gboolean</link> click_closes);
<link linkend="void">void</link>                <link linkend="gnome-dialog-editable-enters">gnome_dialog_editable_enters</link>        (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="GtkEditable">GtkEditable</link> *editable);
<link linkend="void">void</link>                <link linkend="gnome-dialog-append-buttons">gnome_dialog_append_buttons</link>         (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         const <link linkend="gchar">gchar</link> *first,
                                                         ...);
<link linkend="void">void</link>                <link linkend="gnome-dialog-append-button">gnome_dialog_append_button</link>          (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         const <link linkend="gchar">gchar</link> *button_name);
<link linkend="void">void</link>                <link linkend="gnome-dialog-append-buttonsv">gnome_dialog_append_buttonsv</link>        (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         const <link linkend="gchar">gchar</link> **buttons);
<link linkend="void">void</link>                <link linkend="gnome-dialog-append-button-with-pixmap">gnome_dialog_append_button_with_pixmap</link>
                                                        (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         const <link linkend="gchar">gchar</link> *button_name,
                                                         const <link linkend="gchar">gchar</link> *pixmap_name);
<link linkend="void">void</link>                <link linkend="gnome-dialog-append-buttons-with-pixmaps">gnome_dialog_append_buttons_with_pixmaps</link>
                                                        (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         const <link linkend="gchar">gchar</link> **names,
                                                         const <link linkend="gchar">gchar</link> **pixmaps);
<link linkend="void">void</link>                <link linkend="gnome-dialog-construct">gnome_dialog_construct</link>              (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         const <link linkend="gchar">gchar</link> *title,
                                                         <link linkend="va-list">va_list</link> ap);
<link linkend="void">void</link>                <link linkend="gnome-dialog-constructv">gnome_dialog_constructv</link>             (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         const <link linkend="gchar">gchar</link> *title,
                                                         const <link linkend="gchar">gchar</link> **buttons);
#define             <link linkend="GNOME-STOCK-BUTTON-OK--CAPS">GNOME_STOCK_BUTTON_OK</link>
#define             <link linkend="GNOME-STOCK-BUTTON-CANCEL--CAPS">GNOME_STOCK_BUTTON_CANCEL</link>
#define             <link linkend="GNOME-STOCK-BUTTON-YES--CAPS">GNOME_STOCK_BUTTON_YES</link>
#define             <link linkend="GNOME-STOCK-BUTTON-NO--CAPS">GNOME_STOCK_BUTTON_NO</link>
#define             <link linkend="GNOME-STOCK-BUTTON-CLOSE--CAPS">GNOME_STOCK_BUTTON_CLOSE</link>
#define             <link linkend="GNOME-STOCK-BUTTON-APPLY--CAPS">GNOME_STOCK_BUTTON_APPLY</link>
#define             <link linkend="GNOME-STOCK-BUTTON-HELP--CAPS">GNOME_STOCK_BUTTON_HELP</link>
#define             <link linkend="GNOME-STOCK-BUTTON-NEXT--CAPS">GNOME_STOCK_BUTTON_NEXT</link>
#define             <link linkend="GNOME-STOCK-BUTTON-PREV--CAPS">GNOME_STOCK_BUTTON_PREV</link>
#define             <link linkend="GNOME-STOCK-BUTTON-UP--CAPS">GNOME_STOCK_BUTTON_UP</link>
#define             <link linkend="GNOME-STOCK-BUTTON-DOWN--CAPS">GNOME_STOCK_BUTTON_DOWN</link>
#define             <link linkend="GNOME-STOCK-BUTTON-FONT--CAPS">GNOME_STOCK_BUTTON_FONT</link>
</synopsis>
</refsynopsisdiv>

<refsect1 id="GnomeDialog.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
         +----<link linkend="GtkObject">GtkObject</link>
               +----<link linkend="GtkWidget">GtkWidget</link>
                     +----<link linkend="GtkContainer">GtkContainer</link>
                           +----<link linkend="GtkBin">GtkBin</link>
                                 +----<link linkend="GtkWindow">GtkWindow</link>
                                       +----GnomeDialog
                                             +----<link linkend="GnomeMessageBox">GnomeMessageBox</link>
                                             +----<link linkend="GnomePropertyBox">GnomePropertyBox</link>
</synopsis>
</refsect1>



<refsect1 id="GnomeDialog.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GnomeDialog implements
 <link linkend="GtkBuildable">GtkBuildable</link> and  <link linkend="AtkImplementorIface">AtkImplementorIface</link>.</para>
</refsect1>



<refsect1 id="GnomeDialog.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<synopsis>
  &quot;<link linkend="GnomeDialog-clicked">clicked</link>&quot;                                        : Run Last
  &quot;<link linkend="GnomeDialog-close">close</link>&quot;                                          : Run Last
</synopsis>
</refsect1>


<refsect1 id="GnomeDialog.description" role="desc">
<title role="desc.title">Description</title>
<para>
</para>
</refsect1>

<refsect1 id="GnomeDialog.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GnomeDialog-struct" role="struct">
<title>GnomeDialog</title>
<indexterm zone="GnomeDialog-struct" role="deprecated"><primary sortas="GnomeDialog">GnomeDialog</primary></indexterm><programlisting>typedef struct {
  GtkWidget * vbox;
} GnomeDialog;
</programlisting>
<warning><para><literal>GnomeDialog</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Client code can pack widgets (for example, text or images) into <parameter>vbox</parameter>.</para>
<para>
</para><variablelist role="struct">
<varlistentry>
<term><link linkend="GtkWidget">GtkWidget</link>&#160;*<structfield>vbox</structfield>;</term>
<listitem><simpara> The middle portion of the dialog box.
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-new" role="function" condition="deprecated:">
<title>gnome_dialog_new ()</title>
<indexterm zone="gnome-dialog-new" role="deprecated"><primary sortas="gnome_dialog_new">gnome_dialog_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gnome_dialog_new                    (const <link linkend="gchar">gchar</link> *title,
                                                         ...);</programlisting>
<warning><para><literal>gnome_dialog_new</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Creates a new <link linkend="GnomeDialog"><type>GnomeDialog</type></link>, with the given title, and any button names
in the arg list. Buttons can be simple names, such as _("My Button"),
or gnome-stock defines such as <link linkend="GNOME-STOCK-BUTTON-OK--CAPS"><literal>GNOME_STOCK_BUTTON_OK</literal></link>, etc. The last
argument should be NULL to terminate the list.
</para>
<para>
Buttons passed to this function are numbered from left to right,
starting with 0. So the first button in the arglist is button 0,
then button 1, etc.  These numbers are used throughout the
<link linkend="GnomeDialog"><type>GnomeDialog</type></link> API.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>title</parameter>&#160;:</term>
<listitem><simpara> The title of the dialog; appears in window titlebar.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara> NULL-terminated varargs list of button names or GNOME_STOCK_BUTTON_* defines.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The new <link linkend="GnomeDialog"><type>GnomeDialog</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-newv" role="function" condition="deprecated:">
<title>gnome_dialog_newv ()</title>
<indexterm zone="gnome-dialog-newv" role="deprecated"><primary sortas="gnome_dialog_newv">gnome_dialog_newv</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>*          gnome_dialog_newv                   (const <link linkend="gchar">gchar</link> *title,
                                                         const <link linkend="gchar">gchar</link> **buttons);</programlisting>
<warning><para><literal>gnome_dialog_newv</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
See <link linkend="gnome-dialog-new"><function>gnome_dialog_new()</function></link>, this function is identical but does not use
varargs.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>title</parameter>&#160;:</term>
<listitem><simpara> Title of the dialog.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>buttons</parameter>&#160;:</term>
<listitem><simpara> NULL-terminated vector of buttons names.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> The new <link linkend="GnomeDialog"><type>GnomeDialog</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-set-parent" role="function" condition="deprecated:">
<title>gnome_dialog_set_parent ()</title>
<indexterm zone="gnome-dialog-set-parent" role="deprecated"><primary sortas="gnome_dialog_set_parent">gnome_dialog_set_parent</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_set_parent             (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="GtkWindow">GtkWindow</link> *parent);</programlisting>
<warning><para><literal>gnome_dialog_set_parent</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Dialogs have "parents," usually the main application window which spawned
them. This function will let the window manager know about the parent-child
relationship. Usually this means the dialog must stay on top of the parent,
and will be minimized when the parent is. Gnome also allows users to
request dialog placement above the parent window (vs. at the mouse position,
or at a default window manger location).</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to set the parent of.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>parent</parameter>&#160;:</term>
<listitem><simpara> Parent <link linkend="GtkWindow"><type>GtkWindow</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-button-connect" role="function" condition="deprecated:">
<title>gnome_dialog_button_connect ()</title>
<indexterm zone="gnome-dialog-button-connect" role="deprecated"><primary sortas="gnome_dialog_button_connect">gnome_dialog_button_connect</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_button_connect         (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gint">gint</link> button,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
<warning><para><literal>gnome_dialog_button_connect</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Simply <link linkend="g-signal-connect"><function>g_signal_connect()</function></link> to the "clicked" signal of the specified button.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button</parameter>&#160;:</term>
<listitem><simpara> Button number.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&#160;:</term>
<listitem><simpara> A standard Gtk callback.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara> Callback data.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-button-connect-object" role="function" condition="deprecated:">
<title>gnome_dialog_button_connect_object ()</title>
<indexterm zone="gnome-dialog-button-connect-object" role="deprecated"><primary sortas="gnome_dialog_button_connect_object">gnome_dialog_button_connect_object</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_button_connect_object  (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gint">gint</link> button,
                                                         <link linkend="GCallback">GCallback</link> callback,
                                                         <link linkend="GtkObject">GtkObject</link> *obj);</programlisting>
<warning><para><literal>gnome_dialog_button_connect_object</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
<link linkend="g-signal-connect-swapped"><function>g_signal_connect_swapped()</function></link> to the "clicked" signal of the given button.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button</parameter>&#160;:</term>
<listitem><simpara> Button to connect to.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&#160;:</term>
<listitem><simpara> Callback.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>obj</parameter>&#160;:</term>
<listitem><simpara> As for <link linkend="g-signal-connect-swapped"><function>g_signal_connect_swapped()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-run" role="function" condition="deprecated:">
<title>gnome_dialog_run ()</title>
<indexterm zone="gnome-dialog-run" role="deprecated"><primary sortas="gnome_dialog_run">gnome_dialog_run</primary></indexterm><programlisting><link linkend="gint">gint</link>                gnome_dialog_run                    (<link linkend="GnomeDialog">GnomeDialog</link> *dialog);</programlisting>
<warning><para><literal>gnome_dialog_run</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Blocks until the user clicks a button, or closes the dialog with the
window manager's close decoration (or by pressing Escape).
</para>
<para>
You need to set up the dialog to do the right thing when a button
is clicked or delete_event is received; you must consider both of
those possibilities so that you know the status of the dialog when
<link linkend="gnome-dialog-run"><function>gnome_dialog_run()</function></link> returns. A common mistake is to forget about
Escape and the window manager close decoration; by default, these
call <link linkend="gnome-dialog-close"><function>gnome_dialog_close()</function></link>, which by default destroys the dialog. If
your button clicks do not destroy the dialog, you don't know
whether the dialog is destroyed when <link linkend="gnome-dialog-run"><function>gnome_dialog_run()</function></link>
returns. This is bad.
</para>
<para>
So you should either close the dialog on button clicks as well, or
change the <link linkend="gnome-dialog-close"><function>gnome_dialog_close()</function></link> behavior to hide instead of
destroy. You can do this with <link linkend="gnome-dialog-close-hides"><function>gnome_dialog_close_hides()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to use.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>  If a button was pressed, the button number is returned. If not, -1 is returned.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-run-and-close" role="function" condition="deprecated:">
<title>gnome_dialog_run_and_close ()</title>
<indexterm zone="gnome-dialog-run-and-close" role="deprecated"><primary sortas="gnome_dialog_run_and_close">gnome_dialog_run_and_close</primary></indexterm><programlisting><link linkend="gint">gint</link>                gnome_dialog_run_and_close          (<link linkend="GnomeDialog">GnomeDialog</link> *dialog);</programlisting>
<warning><para><literal>gnome_dialog_run_and_close</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
See <link linkend="gnome-dialog-run"><function>gnome_dialog_run()</function></link>. The only difference is that this function calls
<link linkend="gnome-dialog-close"><function>gnome_dialog_close()</function></link> before returning, if the dialog was not already closed.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to use.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> If a button was pressed, the button number. Otherwise -1.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-set-default" role="function" condition="deprecated:">
<title>gnome_dialog_set_default ()</title>
<indexterm zone="gnome-dialog-set-default" role="deprecated"><primary sortas="gnome_dialog_set_default">gnome_dialog_set_default</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_set_default            (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gint">gint</link> button);</programlisting>
<warning><para><literal>gnome_dialog_set_default</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
The default button will be activated if the user just presses return.
Usually you should make the least-destructive button the default.
Otherwise, the most commonly-used button.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button</parameter>&#160;:</term>
<listitem><simpara> Number of the default button.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-grab-focus" role="function" condition="deprecated:">
<title>gnome_dialog_grab_focus ()</title>
<indexterm zone="gnome-dialog-grab-focus" role="deprecated"><primary sortas="gnome_dialog_grab_focus">gnome_dialog_grab_focus</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_grab_focus             (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gint">gint</link> button);</programlisting>
<warning><para><literal>gnome_dialog_grab_focus</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
The button <parameter>button</parameter> will grab the focus.  Use this for dialogs
Where only buttons are displayed and you want to change the
default button.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button</parameter>&#160;:</term>
<listitem><simpara> Number of the default button.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-set-sensitive" role="function" condition="deprecated:">
<title>gnome_dialog_set_sensitive ()</title>
<indexterm zone="gnome-dialog-set-sensitive" role="deprecated"><primary sortas="gnome_dialog_set_sensitive">gnome_dialog_set_sensitive</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_set_sensitive          (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gint">gint</link> button,
                                                         <link linkend="gboolean">gboolean</link> setting);</programlisting>
<warning><para><literal>gnome_dialog_set_sensitive</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Calls <link linkend="gtk-widget-set-sensitive"><function>gtk_widget_set_sensitive()</function></link> on the specified button number.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button</parameter>&#160;:</term>
<listitem><simpara> Which button to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>setting</parameter>&#160;:</term>
<listitem><simpara> TRUE means it's sensitive.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-set-accelerator" role="function" condition="deprecated:">
<title>gnome_dialog_set_accelerator ()</title>
<indexterm zone="gnome-dialog-set-accelerator" role="deprecated"><primary sortas="gnome_dialog_set_accelerator">gnome_dialog_set_accelerator</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_set_accelerator        (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gint">gint</link> button,
                                                         const <link linkend="guchar">guchar</link> accelerator_key,
                                                         <link linkend="guint8">guint8</link> accelerator_mods);</programlisting>
<warning><para><literal>gnome_dialog_set_accelerator</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Set an accelerator key for a button.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button</parameter>&#160;:</term>
<listitem><simpara> Button number.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>accelerator_key</parameter>&#160;:</term>
<listitem><simpara> Key for the accelerator.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>accelerator_mods</parameter>&#160;:</term>
<listitem><simpara> Modifier.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-close" role="function" condition="deprecated:">
<title>gnome_dialog_close ()</title>
<indexterm zone="gnome-dialog-close" role="deprecated"><primary sortas="gnome_dialog_close">gnome_dialog_close</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_close                  (<link linkend="GnomeDialog">GnomeDialog</link> *dialog);</programlisting>
<warning><para><literal>gnome_dialog_close</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
See also <link linkend="gnome-dialog-close-hides"><function>gnome_dialog_close_hides()</function></link>. This function emits the
"close" signal, which either hides or destroys the dialog (destroy
by default). If you connect to the "close" signal, and your
callback returns TRUE, the hide or destroy will be blocked. You can
do this to avoid closing the dialog if the user gives invalid
input, for example.
</para>
<para>
Using <link linkend="gnome-dialog-close"><function>gnome_dialog_close()</function></link> in place of <link linkend="gtk-widget-hide"><function>gtk_widget_hide()</function></link> or
<link linkend="gtk-widget-destroy"><function>gtk_widget_destroy()</function></link> allows you to easily catch all sources of
dialog closure, including delete_event and button clicks, and
handle them in a central location.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to close.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-close-hides" role="function" condition="deprecated:">
<title>gnome_dialog_close_hides ()</title>
<indexterm zone="gnome-dialog-close-hides" role="deprecated"><primary sortas="gnome_dialog_close_hides">gnome_dialog_close_hides</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_close_hides            (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gboolean">gboolean</link> just_hide);</programlisting>
<warning><para><literal>gnome_dialog_close_hides</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Some dialogs are expensive to create, so you want to keep them around and just
<link linkend="gtk-widget-show"><function>gtk_widget_show()</function></link> them when they are opened, and <link linkend="gtk-widget-hide"><function>gtk_widget_hide()</function></link> them when
they're closed. Other dialogs are expensive to keep around, so you want to
<link linkend="gtk-widget-destroy"><function>gtk_widget_destroy()</function></link> them when they're closed. It's a judgment call you
will need to make for each dialog.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>just_hide</parameter>&#160;:</term>
<listitem><simpara> If TRUE, <link linkend="gnome-dialog-close"><function>gnome_dialog_close()</function></link> calls <link linkend="gtk-widget-hide"><function>gtk_widget_hide()</function></link> instead of <link linkend="gtk-widget-destroy"><function>gtk_widget_destroy()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-set-close" role="function" condition="deprecated:">
<title>gnome_dialog_set_close ()</title>
<indexterm zone="gnome-dialog-set-close" role="deprecated"><primary sortas="gnome_dialog_set_close">gnome_dialog_set_close</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_set_close              (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="gboolean">gboolean</link> click_closes);</programlisting>
<warning><para><literal>gnome_dialog_set_close</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This is a convenience function so you don't have to connect callbacks
to each button just to close the dialog. By default, <link linkend="GnomeDialog"><type>GnomeDialog</type></link>
has this parameter set the FALSE and it will not close on any click.
(This was a design error.) However, almost all the <link linkend="GnomeDialog"><type>GnomeDialog</type></link> subclasses,
such as <link linkend="GnomeMessageBox"><type>GnomeMessageBox</type></link> and <link linkend="GnomePropertyBox"><type>GnomePropertyBox</type></link>, have this parameter set to
TRUE by default.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>click_closes</parameter>&#160;:</term>
<listitem><simpara> TRUE if clicking any button should call <link linkend="gnome-dialog-close"><function>gnome_dialog_close()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-editable-enters" role="function" condition="deprecated:">
<title>gnome_dialog_editable_enters ()</title>
<indexterm zone="gnome-dialog-editable-enters" role="deprecated"><primary sortas="gnome_dialog_editable_enters">gnome_dialog_editable_enters</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_editable_enters        (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         <link linkend="GtkEditable">GtkEditable</link> *editable);</programlisting>
<warning><para><literal>gnome_dialog_editable_enters</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Normally if there's an editable widget (such as <link linkend="GtkEntry"><type>GtkEntry</type></link>) in your
dialog, pressing Enter will activate the editable rather than the
default dialog button. However, in most cases, the user expects to
type something in and then press enter to close the dialog. This
function enables that behavior.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>editable</parameter>&#160;:</term>
<listitem><simpara> Editable to affect.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-append-buttons" role="function" condition="deprecated:">
<title>gnome_dialog_append_buttons ()</title>
<indexterm zone="gnome-dialog-append-buttons" role="deprecated"><primary sortas="gnome_dialog_append_buttons">gnome_dialog_append_buttons</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_append_buttons         (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         const <link linkend="gchar">gchar</link> *first,
                                                         ...);</programlisting>
<warning><para><literal>gnome_dialog_append_buttons</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This function is mostly for internal library use. You should use
<link linkend="gnome-dialog-new"><function>gnome_dialog_new()</function></link> instead. See that function for a description of
the button arguments.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to add buttons to.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>first</parameter>&#160;:</term>
<listitem><simpara> First button to add.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara> varargs list of additional buttons, NULL-terminated.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-append-button" role="function" condition="deprecated:">
<title>gnome_dialog_append_button ()</title>
<indexterm zone="gnome-dialog-append-button" role="deprecated"><primary sortas="gnome_dialog_append_button">gnome_dialog_append_button</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_append_button          (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         const <link linkend="gchar">gchar</link> *button_name);</programlisting>
<warning><para><literal>gnome_dialog_append_button</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Add a button to a dialog after its initial construction.
This function is mostly for internal library use. You should use
<link linkend="gnome-dialog-new"><function>gnome_dialog_new()</function></link> instead. See that function for a description of
the button argument.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to add button to.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button_name</parameter>&#160;:</term>
<listitem><simpara> Button to add.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-append-buttonsv" role="function" condition="deprecated:">
<title>gnome_dialog_append_buttonsv ()</title>
<indexterm zone="gnome-dialog-append-buttonsv" role="deprecated"><primary sortas="gnome_dialog_append_buttonsv">gnome_dialog_append_buttonsv</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_append_buttonsv        (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         const <link linkend="gchar">gchar</link> **buttons);</programlisting>
<warning><para><literal>gnome_dialog_append_buttonsv</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
For internal use, language bindings, etc. Use <link linkend="gnome-dialog-new"><function>gnome_dialog_new()</function></link> instead.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to append to.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>buttons</parameter>&#160;:</term>
<listitem><simpara> NULL-terminated vector of buttons to append.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-append-button-with-pixmap" role="function" condition="deprecated:">
<title>gnome_dialog_append_button_with_pixmap ()</title>
<indexterm zone="gnome-dialog-append-button-with-pixmap" role="deprecated"><primary sortas="gnome_dialog_append_button_with_pixmap">gnome_dialog_append_button_with_pixmap</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_append_button_with_pixmap
                                                        (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         const <link linkend="gchar">gchar</link> *button_name,
                                                         const <link linkend="gchar">gchar</link> *pixmap_name);</programlisting>
<warning><para><literal>gnome_dialog_append_button_with_pixmap</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Add a pixmap button to a dialog.
<link linkend="gnome-dialog-new"><function>gnome_dialog_new()</function></link> does not permit custom buttons with pixmaps, so if you
want one of those you need to use this function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to add the button to.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button_name</parameter>&#160;:</term>
<listitem><simpara> Name of the button, or stock button #define.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>pixmap_name</parameter>&#160;:</term>
<listitem><simpara> Stock pixmap name.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-append-buttons-with-pixmaps" role="function" condition="deprecated:">
<title>gnome_dialog_append_buttons_with_pixmaps ()</title>
<indexterm zone="gnome-dialog-append-buttons-with-pixmaps" role="deprecated"><primary sortas="gnome_dialog_append_buttons_with_pixmaps">gnome_dialog_append_buttons_with_pixmaps</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_append_buttons_with_pixmaps
                                                        (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         const <link linkend="gchar">gchar</link> **names,
                                                         const <link linkend="gchar">gchar</link> **pixmaps);</programlisting>
<warning><para><literal>gnome_dialog_append_buttons_with_pixmaps</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Simply calls <link linkend="gnome-dialog-append-button-with-pixmap"><function>gnome_dialog_append_button_with_pixmap()</function></link> repeatedly.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to append to.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>names</parameter>&#160;:</term>
<listitem><simpara> NULL-terminated vector of button names.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>pixmaps</parameter>&#160;:</term>
<listitem><simpara> NULL-terminated vector of pixmap names.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-construct" role="function" condition="deprecated:">
<title>gnome_dialog_construct ()</title>
<indexterm zone="gnome-dialog-construct" role="deprecated"><primary sortas="gnome_dialog_construct">gnome_dialog_construct</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_construct              (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         const <link linkend="gchar">gchar</link> *title,
                                                         <link linkend="va-list">va_list</link> ap);</programlisting>
<warning><para><literal>gnome_dialog_construct</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
See <link linkend="gnome-dialog-new"><function>gnome_dialog_new()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> Dialog to construct.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>title</parameter>&#160;:</term>
<listitem><simpara> Title of the dialog.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>ap</parameter>&#160;:</term>
<listitem><simpara> va_list of buttons, NULL-terminated.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-dialog-constructv" role="function" condition="deprecated:">
<title>gnome_dialog_constructv ()</title>
<indexterm zone="gnome-dialog-constructv" role="deprecated"><primary sortas="gnome_dialog_constructv">gnome_dialog_constructv</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_dialog_constructv             (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                         const <link linkend="gchar">gchar</link> *title,
                                                         const <link linkend="gchar">gchar</link> **buttons);</programlisting>
<warning><para><literal>gnome_dialog_constructv</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
See <link linkend="gnome-dialog-new"><function>gnome_dialog_new()</function></link>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara> Dialog to construct.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>title</parameter>&#160;:</term>
<listitem><simpara> Title of the dialog.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>buttons</parameter>&#160;:</term>
<listitem><simpara> NULL-terminated array of buttons.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GNOME-STOCK-BUTTON-OK--CAPS" role="macro" condition="deprecated:">
<title>GNOME_STOCK_BUTTON_OK</title>
<indexterm zone="GNOME-STOCK-BUTTON-OK--CAPS" role="deprecated"><primary sortas="GNOME_STOCK_BUTTON_OK">GNOME_STOCK_BUTTON_OK</primary></indexterm><programlisting>#define GNOME_STOCK_BUTTON_OK     GTK_STOCK_OK
</programlisting>
<warning><para><literal>GNOME_STOCK_BUTTON_OK</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This button has been replaced by one in GTK+ and new code should use that.
</para></refsect2>
<refsect2 id="GNOME-STOCK-BUTTON-CANCEL--CAPS" role="macro" condition="deprecated:">
<title>GNOME_STOCK_BUTTON_CANCEL</title>
<indexterm zone="GNOME-STOCK-BUTTON-CANCEL--CAPS" role="deprecated"><primary sortas="GNOME_STOCK_BUTTON_CANCEL">GNOME_STOCK_BUTTON_CANCEL</primary></indexterm><programlisting>#define GNOME_STOCK_BUTTON_CANCEL GTK_STOCK_CANCEL
</programlisting>
<warning><para><literal>GNOME_STOCK_BUTTON_CANCEL</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This button has been replaced by one in GTK+ and new code should use that.
</para></refsect2>
<refsect2 id="GNOME-STOCK-BUTTON-YES--CAPS" role="macro" condition="deprecated:">
<title>GNOME_STOCK_BUTTON_YES</title>
<indexterm zone="GNOME-STOCK-BUTTON-YES--CAPS" role="deprecated"><primary sortas="GNOME_STOCK_BUTTON_YES">GNOME_STOCK_BUTTON_YES</primary></indexterm><programlisting>#define GNOME_STOCK_BUTTON_YES    GTK_STOCK_YES
</programlisting>
<warning><para><literal>GNOME_STOCK_BUTTON_YES</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This button has been replaced by one in GTK+ and new code should use that.
</para></refsect2>
<refsect2 id="GNOME-STOCK-BUTTON-NO--CAPS" role="macro" condition="deprecated:">
<title>GNOME_STOCK_BUTTON_NO</title>
<indexterm zone="GNOME-STOCK-BUTTON-NO--CAPS" role="deprecated"><primary sortas="GNOME_STOCK_BUTTON_NO">GNOME_STOCK_BUTTON_NO</primary></indexterm><programlisting>#define GNOME_STOCK_BUTTON_NO     GTK_STOCK_NO
</programlisting>
<warning><para><literal>GNOME_STOCK_BUTTON_NO</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This button has been replaced by one in GTK+ and new code should use that.
</para></refsect2>
<refsect2 id="GNOME-STOCK-BUTTON-CLOSE--CAPS" role="macro" condition="deprecated:">
<title>GNOME_STOCK_BUTTON_CLOSE</title>
<indexterm zone="GNOME-STOCK-BUTTON-CLOSE--CAPS" role="deprecated"><primary sortas="GNOME_STOCK_BUTTON_CLOSE">GNOME_STOCK_BUTTON_CLOSE</primary></indexterm><programlisting>#define GNOME_STOCK_BUTTON_CLOSE  GTK_STOCK_CLOSE
</programlisting>
<warning><para><literal>GNOME_STOCK_BUTTON_CLOSE</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This button has been replaced by one in GTK+ and new code should use that.
</para></refsect2>
<refsect2 id="GNOME-STOCK-BUTTON-APPLY--CAPS" role="macro" condition="deprecated:">
<title>GNOME_STOCK_BUTTON_APPLY</title>
<indexterm zone="GNOME-STOCK-BUTTON-APPLY--CAPS" role="deprecated"><primary sortas="GNOME_STOCK_BUTTON_APPLY">GNOME_STOCK_BUTTON_APPLY</primary></indexterm><programlisting>#define GNOME_STOCK_BUTTON_APPLY  GTK_STOCK_APPLY
</programlisting>
<warning><para><literal>GNOME_STOCK_BUTTON_APPLY</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This button has been replaced by one in GTK+ and new code should use that.
</para></refsect2>
<refsect2 id="GNOME-STOCK-BUTTON-HELP--CAPS" role="macro" condition="deprecated:">
<title>GNOME_STOCK_BUTTON_HELP</title>
<indexterm zone="GNOME-STOCK-BUTTON-HELP--CAPS" role="deprecated"><primary sortas="GNOME_STOCK_BUTTON_HELP">GNOME_STOCK_BUTTON_HELP</primary></indexterm><programlisting>#define GNOME_STOCK_BUTTON_HELP   GTK_STOCK_HELP
</programlisting>
<warning><para><literal>GNOME_STOCK_BUTTON_HELP</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This button has been replaced by one in GTK+ and new code should use that.
</para></refsect2>
<refsect2 id="GNOME-STOCK-BUTTON-NEXT--CAPS" role="macro" condition="deprecated:">
<title>GNOME_STOCK_BUTTON_NEXT</title>
<indexterm zone="GNOME-STOCK-BUTTON-NEXT--CAPS" role="deprecated"><primary sortas="GNOME_STOCK_BUTTON_NEXT">GNOME_STOCK_BUTTON_NEXT</primary></indexterm><programlisting>#define GNOME_STOCK_BUTTON_NEXT   GTK_STOCK_GO_FORWARD
</programlisting>
<warning><para><literal>GNOME_STOCK_BUTTON_NEXT</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This button has been replaced by one in GTK+ and new code should use that.
</para></refsect2>
<refsect2 id="GNOME-STOCK-BUTTON-PREV--CAPS" role="macro" condition="deprecated:">
<title>GNOME_STOCK_BUTTON_PREV</title>
<indexterm zone="GNOME-STOCK-BUTTON-PREV--CAPS" role="deprecated"><primary sortas="GNOME_STOCK_BUTTON_PREV">GNOME_STOCK_BUTTON_PREV</primary></indexterm><programlisting>#define GNOME_STOCK_BUTTON_PREV   GTK_STOCK_GO_BACK
</programlisting>
<warning><para><literal>GNOME_STOCK_BUTTON_PREV</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This button has been replaced by one in GTK+ and new code should use that.
</para></refsect2>
<refsect2 id="GNOME-STOCK-BUTTON-UP--CAPS" role="macro" condition="deprecated:">
<title>GNOME_STOCK_BUTTON_UP</title>
<indexterm zone="GNOME-STOCK-BUTTON-UP--CAPS" role="deprecated"><primary sortas="GNOME_STOCK_BUTTON_UP">GNOME_STOCK_BUTTON_UP</primary></indexterm><programlisting>#define GNOME_STOCK_BUTTON_UP     GTK_STOCK_GO_UP
</programlisting>
<warning><para><literal>GNOME_STOCK_BUTTON_UP</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This button has been replaced by one in GTK+ and new code should use that.
</para></refsect2>
<refsect2 id="GNOME-STOCK-BUTTON-DOWN--CAPS" role="macro" condition="deprecated:">
<title>GNOME_STOCK_BUTTON_DOWN</title>
<indexterm zone="GNOME-STOCK-BUTTON-DOWN--CAPS" role="deprecated"><primary sortas="GNOME_STOCK_BUTTON_DOWN">GNOME_STOCK_BUTTON_DOWN</primary></indexterm><programlisting>#define GNOME_STOCK_BUTTON_DOWN   GTK_STOCK_GO_DOWN
</programlisting>
<warning><para><literal>GNOME_STOCK_BUTTON_DOWN</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This button has been replaced by one in GTK+ and new code should use that.
</para></refsect2>
<refsect2 id="GNOME-STOCK-BUTTON-FONT--CAPS" role="macro" condition="deprecated:">
<title>GNOME_STOCK_BUTTON_FONT</title>
<indexterm zone="GNOME-STOCK-BUTTON-FONT--CAPS" role="deprecated"><primary sortas="GNOME_STOCK_BUTTON_FONT">GNOME_STOCK_BUTTON_FONT</primary></indexterm><programlisting>#define GNOME_STOCK_BUTTON_FONT   GTK_STOCK_SELECT_FONT
</programlisting>
<warning><para><literal>GNOME_STOCK_BUTTON_FONT</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This button has been replaced by one in GTK+ and new code should use that.
</para></refsect2>

</refsect1>

<refsect1 id="GnomeDialog.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GnomeDialog-clicked" role="signal"><title>The <literal>&quot;clicked&quot;</literal> signal</title>
<indexterm zone="GnomeDialog-clicked"><primary sortas="GnomeDialog::clicked">GnomeDialog::clicked</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                        <link linkend="gint">gint</link>         arg1,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run Last</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="GnomeDialog-close" role="signal"><title>The <literal>&quot;close&quot;</literal> signal</title>
<indexterm zone="GnomeDialog-close"><primary sortas="GnomeDialog::close">GnomeDialog::close</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            user_function                      (<link linkend="GnomeDialog">GnomeDialog</link> *dialog,
                                                        <link linkend="gpointer">gpointer</link>     user_data)      : Run Last</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>dialog</parameter>&#160;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>



</refentry>
