File: gnome-dialog.xml

package info (click to toggle)
libgnomeui 2.20.1.1-2
links: PTS
area: main
in suites: lenny
size: 13,400 kB
ctags: 7,371
sloc: ansic: 40,799; xml: 19,721; sh: 8,821; makefile: 443
file content (785 lines) | stat: -rw-r--r-- 54,046 bytes
<refentry id="GnomeDialog">
<refmeta>
<refentrytitle role="top_of_page">GnomeDialog</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>LIBGNOMEUI Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GnomeDialog</refname>
<refpurpose>Create generic dialog boxes.</refpurpose>
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
</refnamediv>

<refsynopsisdiv 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 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 role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GnomeDialog implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link> and  <link linkend="GtkBuildable">GtkBuildable</link>.</para>

</refsect1>



<refsect1 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 role="desc">
<title role="desc.title">Description</title>
<para>

</para>
</refsect1>

<refsect1 role="details">
<title role="details.title">Details</title>
<refsect2>
<title><anchor id="GnomeDialog-struct" role="struct"/>GnomeDialog</title>
<indexterm role="deprecated"><primary>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>&nbsp;*<structfield>vbox</structfield>;</term>
<listitem><simpara> The middle portion of the dialog box.
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-new" role="function" condition="deprecated:"/>gnome_dialog_new ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> The title of the dialog; appears in window titlebar.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&nbsp;:</term>
<listitem><simpara> NULL-terminated varargs list of button names or GNOME_STOCK_BUTTON_* defines.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> The new <link linkend="GnomeDialog"><type>GnomeDialog</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-newv" role="function" condition="deprecated:"/>gnome_dialog_newv ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> Title of the dialog.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>buttons</parameter>&nbsp;:</term>
<listitem><simpara> NULL-terminated vector of buttons names.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> The new <link linkend="GnomeDialog"><type>GnomeDialog</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-set-parent" role="function" condition="deprecated:"/>gnome_dialog_set_parent ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to set the parent of.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>parent</parameter>&nbsp;:</term>
<listitem><simpara> Parent <link linkend="GtkWindow"><type>GtkWindow</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-button-connect" role="function" condition="deprecated:"/>gnome_dialog_button_connect ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button</parameter>&nbsp;:</term>
<listitem><simpara> Button number.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&nbsp;:</term>
<listitem><simpara> A standard Gtk callback.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&nbsp;:</term>
<listitem><simpara> Callback data.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-button-connect-object" role="function" condition="deprecated:"/>gnome_dialog_button_connect_object ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button</parameter>&nbsp;:</term>
<listitem><simpara> Button to connect to.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&nbsp;:</term>
<listitem><simpara> Callback.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>obj</parameter>&nbsp;:</term>
<listitem><simpara> As for <link linkend="g-signal-connect-swapped"><function>g_signal_connect_swapped()</function></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-run" role="function" condition="deprecated:"/>gnome_dialog_run ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to use.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>  If a button was pressed, the button number is returned. If not, -1 is returned.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-run-and-close" role="function" condition="deprecated:"/>gnome_dialog_run_and_close ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to use.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> If a button was pressed, the button number. Otherwise -1.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-set-default" role="function" condition="deprecated:"/>gnome_dialog_set_default ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button</parameter>&nbsp;:</term>
<listitem><simpara> Number of the default button.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-grab-focus" role="function" condition="deprecated:"/>gnome_dialog_grab_focus ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button</parameter>&nbsp;:</term>
<listitem><simpara> Number of the default button.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-set-sensitive" role="function" condition="deprecated:"/>gnome_dialog_set_sensitive ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button</parameter>&nbsp;:</term>
<listitem><simpara> Which button to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>setting</parameter>&nbsp;:</term>
<listitem><simpara> TRUE means it's sensitive.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-set-accelerator" role="function" condition="deprecated:"/>gnome_dialog_set_accelerator ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button</parameter>&nbsp;:</term>
<listitem><simpara> Button number.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>accelerator_key</parameter>&nbsp;:</term>
<listitem><simpara> Key for the accelerator.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>accelerator_mods</parameter>&nbsp;:</term>
<listitem><simpara> Modifier.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-close" role="function" condition="deprecated:"/>gnome_dialog_close ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to close.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-close-hides" role="function" condition="deprecated:"/>gnome_dialog_close_hides ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>just_hide</parameter>&nbsp;:</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>
<title><anchor id="gnome-dialog-set-close" role="function" condition="deprecated:"/>gnome_dialog_set_close ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>click_closes</parameter>&nbsp;:</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>
<title><anchor id="gnome-dialog-editable-enters" role="function" condition="deprecated:"/>gnome_dialog_editable_enters ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to affect.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>editable</parameter>&nbsp;:</term>
<listitem><simpara> Editable to affect.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-append-buttons" role="function" condition="deprecated:"/>gnome_dialog_append_buttons ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to add buttons to.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>first</parameter>&nbsp;:</term>
<listitem><simpara> First button to add.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&nbsp;:</term>
<listitem><simpara> varargs list of additional buttons, NULL-terminated.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-append-button" role="function" condition="deprecated:"/>gnome_dialog_append_button ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to add button to.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button_name</parameter>&nbsp;:</term>
<listitem><simpara> Button to add.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-append-buttonsv" role="function" condition="deprecated:"/>gnome_dialog_append_buttonsv ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to append to.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>buttons</parameter>&nbsp;:</term>
<listitem><simpara> NULL-terminated vector of buttons to append.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-append-button-with-pixmap" role="function" condition="deprecated:"/>gnome_dialog_append_button_with_pixmap ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to add the button to.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button_name</parameter>&nbsp;:</term>
<listitem><simpara> Name of the button, or stock button #define.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>pixmap_name</parameter>&nbsp;:</term>
<listitem><simpara> Stock pixmap name.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-append-buttons-with-pixmaps" role="function" condition="deprecated:"/>gnome_dialog_append_buttons_with_pixmaps ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeDialog"><type>GnomeDialog</type></link> to append to.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>names</parameter>&nbsp;:</term>
<listitem><simpara> NULL-terminated vector of button names.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>pixmaps</parameter>&nbsp;:</term>
<listitem><simpara> NULL-terminated vector of pixmap names.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-construct" role="function" condition="deprecated:"/>gnome_dialog_construct ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> Dialog to construct.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>title</parameter>&nbsp;:</term>
<listitem><simpara> Title of the dialog.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>ap</parameter>&nbsp;:</term>
<listitem><simpara> va_list of buttons, NULL-terminated.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-dialog-constructv" role="function" condition="deprecated:"/>gnome_dialog_constructv ()</title>
<indexterm role="deprecated"><primary>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>&nbsp;:</term>
<listitem><simpara> Dialog to construct.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>title</parameter>&nbsp;:</term>
<listitem><simpara> Title of the dialog.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>buttons</parameter>&nbsp;:</term>
<listitem><simpara> NULL-terminated array of buttons.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="GNOME-STOCK-BUTTON-OK:CAPS" role="macro" condition="deprecated:"/>GNOME_STOCK_BUTTON_OK</title>
<indexterm role="deprecated"><primary>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>
<title><anchor id="GNOME-STOCK-BUTTON-CANCEL:CAPS" role="macro" condition="deprecated:"/>GNOME_STOCK_BUTTON_CANCEL</title>
<indexterm role="deprecated"><primary>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>
<title><anchor id="GNOME-STOCK-BUTTON-YES:CAPS" role="macro" condition="deprecated:"/>GNOME_STOCK_BUTTON_YES</title>
<indexterm role="deprecated"><primary>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>
<title><anchor id="GNOME-STOCK-BUTTON-NO:CAPS" role="macro" condition="deprecated:"/>GNOME_STOCK_BUTTON_NO</title>
<indexterm role="deprecated"><primary>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>
<title><anchor id="GNOME-STOCK-BUTTON-CLOSE:CAPS" role="macro" condition="deprecated:"/>GNOME_STOCK_BUTTON_CLOSE</title>
<indexterm role="deprecated"><primary>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>
<title><anchor id="GNOME-STOCK-BUTTON-APPLY:CAPS" role="macro" condition="deprecated:"/>GNOME_STOCK_BUTTON_APPLY</title>
<indexterm role="deprecated"><primary>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>
<title><anchor id="GNOME-STOCK-BUTTON-HELP:CAPS" role="macro" condition="deprecated:"/>GNOME_STOCK_BUTTON_HELP</title>
<indexterm role="deprecated"><primary>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>
<title><anchor id="GNOME-STOCK-BUTTON-NEXT:CAPS" role="macro" condition="deprecated:"/>GNOME_STOCK_BUTTON_NEXT</title>
<indexterm role="deprecated"><primary>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>
<title><anchor id="GNOME-STOCK-BUTTON-PREV:CAPS" role="macro" condition="deprecated:"/>GNOME_STOCK_BUTTON_PREV</title>
<indexterm role="deprecated"><primary>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>
<title><anchor id="GNOME-STOCK-BUTTON-UP:CAPS" role="macro" condition="deprecated:"/>GNOME_STOCK_BUTTON_UP</title>
<indexterm role="deprecated"><primary>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>
<title><anchor id="GNOME-STOCK-BUTTON-DOWN:CAPS" role="macro" condition="deprecated:"/>GNOME_STOCK_BUTTON_DOWN</title>
<indexterm role="deprecated"><primary>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>
<title><anchor id="GNOME-STOCK-BUTTON-FONT:CAPS" role="macro" condition="deprecated:"/>GNOME_STOCK_BUTTON_FONT</title>
<indexterm role="deprecated"><primary>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 role="signals">
<title role="signals.title">Signal Details</title>
<refsect2><title><anchor id="GnomeDialog-clicked"/>The <literal>&quot;clicked&quot;</literal> signal</title>
<indexterm><primary>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>&nbsp;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&nbsp;:</term>
<listitem><simpara>

</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2><title><anchor id="GnomeDialog-close"/>The <literal>&quot;close&quot;</literal> signal</title>
<indexterm><primary>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>&nbsp;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>

</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>



</refentry>