|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /usr/share/gtk-doc/html/libgnomeui/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GnomeDialog</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="GNOME UI Library Reference Manual">
<link rel="up" href="deprecated.html" title="Deprecated modules">
<link rel="prev" href="libgnomeui-gnome-mdi-session.html" title="gnome-mdi-session">
<link rel="next" href="GnomeMessageBox.html" title="GnomeMessageBox">
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="ch01.html" title="GNOME UI Library (libgnomeui)">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="libgnomeui-gnome-mdi-session.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="deprecated.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GNOME UI Library Reference Manual</th>
<td><a accesskey="n" href="GnomeMessageBox.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3140105" class="shortcut">Top</a>
 | 
<a href="#id3142217" class="shortcut">Description</a>
 | 
<a href="#id3142021" class="shortcut">Object Hierarchy</a>
 | 
<a href="#id3142107" class="shortcut">Implemented Interfaces</a>
 | 
<a href="#id3142130" class="shortcut">Signals</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="GnomeDialog"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id3140105"></a><span class="refentrytitle">GnomeDialog</span>
</h2>
<p>GnomeDialog — Create generic dialog boxes.</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
#include <libgnomeui/libgnomeui.h>
<a href="GnomeDialog.html#GnomeDialog-struct">GnomeDialog</a>;
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* <a href="GnomeDialog.html#gnome-dialog-new">gnome_dialog_new</a> (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *title,
...);
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* <a href="GnomeDialog.html#gnome-dialog-newv">gnome_dialog_newv</a> (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *title,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **buttons);
void <a href="GnomeDialog.html#gnome-dialog-set-parent">gnome_dialog_set_parent</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWindow.html"
>GtkWindow</a> *parent);
void <a href="GnomeDialog.html#gnome-dialog-button-connect">gnome_dialog_button_connect</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> button,
<a
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
>GCallback</a> callback,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);
void <a href="GnomeDialog.html#gnome-dialog-button-connect-object">gnome_dialog_button_connect_object</a>
(<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> button,
<a
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
>GCallback</a> callback,
<a
href="/usr/share/gtk-doc/html/gtk/GtkObject.html"
>GtkObject</a> *obj);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> <a href="GnomeDialog.html#gnome-dialog-run">gnome_dialog_run</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> <a href="GnomeDialog.html#gnome-dialog-run-and-close">gnome_dialog_run_and_close</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog);
void <a href="GnomeDialog.html#gnome-dialog-set-default">gnome_dialog_set_default</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> button);
void <a href="GnomeDialog.html#gnome-dialog-grab-focus">gnome_dialog_grab_focus</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> button);
void <a href="GnomeDialog.html#gnome-dialog-set-sensitive">gnome_dialog_set_sensitive</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> button,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> setting);
void <a href="GnomeDialog.html#gnome-dialog-set-accelerator">gnome_dialog_set_accelerator</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> button,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"
>guchar</a> accelerator_key,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint8"
>guint8</a> accelerator_mods);
void <a href="GnomeDialog.html#gnome-dialog-close">gnome_dialog_close</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog);
void <a href="GnomeDialog.html#gnome-dialog-close-hides">gnome_dialog_close_hides</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> just_hide);
void <a href="GnomeDialog.html#gnome-dialog-set-close">gnome_dialog_set_close</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> click_closes);
void <a href="GnomeDialog.html#gnome-dialog-editable-enters">gnome_dialog_editable_enters</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/gtk/GtkEditable.html"
>GtkEditable</a> *editable);
void <a href="GnomeDialog.html#gnome-dialog-append-buttons">gnome_dialog_append_buttons</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *first,
...);
void <a href="GnomeDialog.html#gnome-dialog-append-button">gnome_dialog_append_button</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *button_name);
void <a href="GnomeDialog.html#gnome-dialog-append-buttonsv">gnome_dialog_append_buttonsv</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **buttons);
void <a href="GnomeDialog.html#gnome-dialog-append-button-with-pixmap">gnome_dialog_append_button_with_pixmap</a>
(<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *button_name,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *pixmap_name);
void <a href="GnomeDialog.html#gnome-dialog-append-buttons-with-pixmaps">gnome_dialog_append_buttons_with_pixmaps</a>
(<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **names,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **pixmaps);
void <a href="GnomeDialog.html#gnome-dialog-construct">gnome_dialog_construct</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *title,
va_list ap);
void <a href="GnomeDialog.html#gnome-dialog-constructv">gnome_dialog_constructv</a> (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *title,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **buttons);
#define <a href="GnomeDialog.html#GNOME-STOCK-BUTTON-OK:CAPS">GNOME_STOCK_BUTTON_OK</a>
#define <a href="GnomeDialog.html#GNOME-STOCK-BUTTON-CANCEL:CAPS">GNOME_STOCK_BUTTON_CANCEL</a>
#define <a href="GnomeDialog.html#GNOME-STOCK-BUTTON-YES:CAPS">GNOME_STOCK_BUTTON_YES</a>
#define <a href="GnomeDialog.html#GNOME-STOCK-BUTTON-NO:CAPS">GNOME_STOCK_BUTTON_NO</a>
#define <a href="GnomeDialog.html#GNOME-STOCK-BUTTON-CLOSE:CAPS">GNOME_STOCK_BUTTON_CLOSE</a>
#define <a href="GnomeDialog.html#GNOME-STOCK-BUTTON-APPLY:CAPS">GNOME_STOCK_BUTTON_APPLY</a>
#define <a href="GnomeDialog.html#GNOME-STOCK-BUTTON-HELP:CAPS">GNOME_STOCK_BUTTON_HELP</a>
#define <a href="GnomeDialog.html#GNOME-STOCK-BUTTON-NEXT:CAPS">GNOME_STOCK_BUTTON_NEXT</a>
#define <a href="GnomeDialog.html#GNOME-STOCK-BUTTON-PREV:CAPS">GNOME_STOCK_BUTTON_PREV</a>
#define <a href="GnomeDialog.html#GNOME-STOCK-BUTTON-UP:CAPS">GNOME_STOCK_BUTTON_UP</a>
#define <a href="GnomeDialog.html#GNOME-STOCK-BUTTON-DOWN:CAPS">GNOME_STOCK_BUTTON_DOWN</a>
#define <a href="GnomeDialog.html#GNOME-STOCK-BUTTON-FONT:CAPS">GNOME_STOCK_BUTTON_FONT</a>
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3142021"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
+----<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned"
>GInitiallyUnowned</a>
+----<a
href="/usr/share/gtk-doc/html/gtk/GtkObject.html"
>GtkObject</a>
+----<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>
+----<a
href="/usr/share/gtk-doc/html/gtk/GtkContainer.html"
>GtkContainer</a>
+----<a
href="/usr/share/gtk-doc/html/gtk/GtkBin.html"
>GtkBin</a>
+----<a
href="/usr/share/gtk-doc/html/gtk/GtkWindow.html"
>GtkWindow</a>
+----GnomeDialog
+----<a href="GnomeMessageBox.html" title="GnomeMessageBox">GnomeMessageBox</a>
+----<a href="GnomePropertyBox.html" title="GnomePropertyBox">GnomePropertyBox</a>
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3142107"></a><h2>Implemented Interfaces</h2>
<p>
GnomeDialog implements
AtkImplementorIface.</p>
</div>
<div class="refsect1" lang="en">
<a name="id3142130"></a><h2>Signals</h2>
<pre class="synopsis">
"<a href="GnomeDialog.html#GnomeDialog-clicked">clicked</a>" void user_function (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> arg1,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last
"<a href="GnomeDialog.html#GnomeDialog-close">close</a>" <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> user_function (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3142217"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3142232"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id3142242"></a><h3>
<a name="GnomeDialog-struct"></a>GnomeDialog</h3>
<a class="indexterm" name="id3142255"></a><pre class="programlisting">typedef struct {
GtkWidget * vbox;
} GnomeDialog;
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GnomeDialog</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Client code can pack widgets (for example, text or images) into <em class="parameter"><code>vbox</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a> *<em class="structfield"><code>vbox</code></em>;</span></td>
<td> The middle portion of the dialog box.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3142318"></a><h3>
<a name="gnome-dialog-new"></a>gnome_dialog_new ()</h3>
<a class="indexterm" name="id3142333"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* gnome_dialog_new (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *title,
...);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_new</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Creates a new <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a>, 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 <a href="GnomeDialog.html#GNOME-STOCK-BUTTON-OK:CAPS"><code class="literal">GNOME_STOCK_BUTTON_OK</code></a>, etc. The last
argument should be NULL to terminate the list.
</p>
<p>
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
<a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> API.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>title</code></em> :</span></td>
<td> The title of the dialog; appears in window titlebar.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>...</code></em> :</span></td>
<td> NULL-terminated varargs list of button names or GNOME_STOCK_BUTTON_* defines.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> The new <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3142467"></a><h3>
<a name="gnome-dialog-newv"></a>gnome_dialog_newv ()</h3>
<a class="indexterm" name="id3142482"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html"
>GtkWidget</a>* gnome_dialog_newv (const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *title,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **buttons);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_newv</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
See <a href="GnomeDialog.html#gnome-dialog-new"><code class="function">gnome_dialog_new()</code></a>, this function is identical but does not use
varargs.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>title</code></em> :</span></td>
<td> Title of the dialog.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>buttons</code></em> :</span></td>
<td> NULL-terminated vector of buttons names.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> The new <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3142596"></a><h3>
<a name="gnome-dialog-set-parent"></a>gnome_dialog_set_parent ()</h3>
<a class="indexterm" name="id3142611"></a><pre class="programlisting">void gnome_dialog_set_parent (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/gtk/GtkWindow.html"
>GtkWindow</a> *parent);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_set_parent</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
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).</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to set the parent of.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>parent</code></em> :</span></td>
<td> Parent <a
href="/usr/share/gtk-doc/html/gtk/GtkWindow.html"
><span class="type">GtkWindow</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3142717"></a><h3>
<a name="gnome-dialog-button-connect"></a>gnome_dialog_button_connect ()</h3>
<a class="indexterm" name="id3142734"></a><pre class="programlisting">void gnome_dialog_button_connect (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> button,
<a
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
>GCallback</a> callback,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_button_connect</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Simply <a
href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect"
><code class="function">g_signal_connect()</code></a> to the "clicked" signal of the specified button.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to affect.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>button</code></em> :</span></td>
<td> Button number.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td> A standard Gtk callback.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td> Callback data.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3142880"></a><h3>
<a name="gnome-dialog-button-connect-object"></a>gnome_dialog_button_connect_object ()</h3>
<a class="indexterm" name="id3142896"></a><pre class="programlisting">void gnome_dialog_button_connect_object
(<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> button,
<a
href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#GCallback"
>GCallback</a> callback,
<a
href="/usr/share/gtk-doc/html/gtk/GtkObject.html"
>GtkObject</a> *obj);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_button_connect_object</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
<a
href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect-swapped"
><code class="function">g_signal_connect_swapped()</code></a> to the "clicked" signal of the given button.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to affect.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>button</code></em> :</span></td>
<td> Button to connect to.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>callback</code></em> :</span></td>
<td> Callback.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>obj</code></em> :</span></td>
<td> As for <a
href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect-swapped"
><code class="function">g_signal_connect_swapped()</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3143055"></a><h3>
<a name="gnome-dialog-run"></a>gnome_dialog_run ()</h3>
<a class="indexterm" name="id3143070"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> gnome_dialog_run (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_run</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Blocks until the user clicks a button, or closes the dialog with the
window manager's close decoration (or by pressing Escape).
</p>
<p>
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
<a href="GnomeDialog.html#gnome-dialog-run"><code class="function">gnome_dialog_run()</code></a> returns. A common mistake is to forget about
Escape and the window manager close decoration; by default, these
call <a href="GnomeDialog.html#gnome-dialog-close"><code class="function">gnome_dialog_close()</code></a>, 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 <a href="GnomeDialog.html#gnome-dialog-run"><code class="function">gnome_dialog_run()</code></a>
returns. This is bad.
</p>
<p>
So you should either close the dialog on button clicks as well, or
change the <a href="GnomeDialog.html#gnome-dialog-close"><code class="function">gnome_dialog_close()</code></a> behavior to hide instead of
destroy. You can do this with <a href="GnomeDialog.html#gnome-dialog-close-hides"><code class="function">gnome_dialog_close_hides()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to use.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> If a button was pressed, the button number is returned. If not, -1 is returned.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3143224"></a><h3>
<a name="gnome-dialog-run-and-close"></a>gnome_dialog_run_and_close ()</h3>
<a class="indexterm" name="id3143240"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> gnome_dialog_run_and_close (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_run_and_close</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
See <a href="GnomeDialog.html#gnome-dialog-run"><code class="function">gnome_dialog_run()</code></a>. The only difference is that this function calls
<a href="GnomeDialog.html#gnome-dialog-close"><code class="function">gnome_dialog_close()</code></a> before returning, if the dialog was not already closed.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to use.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> If a button was pressed, the button number. Otherwise -1.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3143344"></a><h3>
<a name="gnome-dialog-set-default"></a>gnome_dialog_set_default ()</h3>
<a class="indexterm" name="id3143359"></a><pre class="programlisting">void gnome_dialog_set_default (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> button);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_set_default</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
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.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to affect.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>button</code></em> :</span></td>
<td> Number of the default button.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3143454"></a><h3>
<a name="gnome-dialog-grab-focus"></a>gnome_dialog_grab_focus ()</h3>
<a class="indexterm" name="id3143469"></a><pre class="programlisting">void gnome_dialog_grab_focus (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> button);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_grab_focus</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
The button <em class="parameter"><code>button</code></em> will grab the focus. Use this for dialogs
Where only buttons are displayed and you want to change the
default button.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to affect.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>button</code></em> :</span></td>
<td> Number of the default button.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3143569"></a><h3>
<a name="gnome-dialog-set-sensitive"></a>gnome_dialog_set_sensitive ()</h3>
<a class="indexterm" name="id3143584"></a><pre class="programlisting">void gnome_dialog_set_sensitive (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> button,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> setting);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_set_sensitive</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Calls <a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-set-sensitive"
><code class="function">gtk_widget_set_sensitive()</code></a> on the specified button number.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to affect.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>button</code></em> :</span></td>
<td> Which button to affect.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>setting</code></em> :</span></td>
<td> TRUE means it's sensitive.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3143711"></a><h3>
<a name="gnome-dialog-set-accelerator"></a>gnome_dialog_set_accelerator ()</h3>
<a class="indexterm" name="id3143727"></a><pre class="programlisting">void gnome_dialog_set_accelerator (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> button,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guchar"
>guchar</a> accelerator_key,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint8"
>guint8</a> accelerator_mods);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_set_accelerator</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Set an accelerator key for a button.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to affect.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>button</code></em> :</span></td>
<td> Button number.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>accelerator_key</code></em> :</span></td>
<td> Key for the accelerator.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>accelerator_mods</code></em> :</span></td>
<td> Modifier.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3143863"></a><h3>
<a name="gnome-dialog-close"></a>gnome_dialog_close ()</h3>
<a class="indexterm" name="id3143879"></a><pre class="programlisting">void gnome_dialog_close (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_close</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
See also <a href="GnomeDialog.html#gnome-dialog-close-hides"><code class="function">gnome_dialog_close_hides()</code></a>. 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.
</p>
<p>
Using <a href="GnomeDialog.html#gnome-dialog-close"><code class="function">gnome_dialog_close()</code></a> in place of <a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-hide"
><code class="function">gtk_widget_hide()</code></a> or
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-destroy"
><code class="function">gtk_widget_destroy()</code></a> allows you to easily catch all sources of
dialog closure, including delete_event and button clicks, and
handle them in a central location.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to close.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3144005"></a><h3>
<a name="gnome-dialog-close-hides"></a>gnome_dialog_close_hides ()</h3>
<a class="indexterm" name="id3144020"></a><pre class="programlisting">void gnome_dialog_close_hides (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> just_hide);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_close_hides</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Some dialogs are expensive to create, so you want to keep them around and just
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-show"
><code class="function">gtk_widget_show()</code></a> them when they are opened, and <a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-hide"
><code class="function">gtk_widget_hide()</code></a> them when
they're closed. Other dialogs are expensive to keep around, so you want to
<a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-destroy"
><code class="function">gtk_widget_destroy()</code></a> them when they're closed. It's a judgment call you
will need to make for each dialog.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to affect.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>just_hide</code></em> :</span></td>
<td> If TRUE, <a href="GnomeDialog.html#gnome-dialog-close"><code class="function">gnome_dialog_close()</code></a> calls <a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-hide"
><code class="function">gtk_widget_hide()</code></a> instead of <a
href="/usr/share/gtk-doc/html/gtk/GtkWidget.html#gtk-widget-destroy"
><code class="function">gtk_widget_destroy()</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3144181"></a><h3>
<a name="gnome-dialog-set-close"></a>gnome_dialog_set_close ()</h3>
<a class="indexterm" name="id3144197"></a><pre class="programlisting">void gnome_dialog_set_close (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> click_closes);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_set_close</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This is a convenience function so you don't have to connect callbacks
to each button just to close the dialog. By default, <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a>
has this parameter set the FALSE and it will not close on any click.
(This was a design error.) However, almost all the <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> subclasses,
such as <a href="GnomeMessageBox.html" title="GnomeMessageBox"><span class="type">GnomeMessageBox</span></a> and <a href="GnomePropertyBox.html" title="GnomePropertyBox"><span class="type">GnomePropertyBox</span></a>, have this parameter set to
TRUE by default.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to affect.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>click_closes</code></em> :</span></td>
<td> TRUE if clicking any button should call <a href="GnomeDialog.html#gnome-dialog-close"><code class="function">gnome_dialog_close()</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3144338"></a><h3>
<a name="gnome-dialog-editable-enters"></a>gnome_dialog_editable_enters ()</h3>
<a class="indexterm" name="id3144354"></a><pre class="programlisting">void gnome_dialog_editable_enters (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/gtk/GtkEditable.html"
>GtkEditable</a> *editable);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_editable_enters</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Normally if there's an editable widget (such as <a
href="/usr/share/gtk-doc/html/gtk/GtkEntry.html"
><span class="type">GtkEntry</span></a>) 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.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to affect.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>editable</code></em> :</span></td>
<td> Editable to affect.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3144458"></a><h3>
<a name="gnome-dialog-append-buttons"></a>gnome_dialog_append_buttons ()</h3>
<a class="indexterm" name="id3144474"></a><pre class="programlisting">void gnome_dialog_append_buttons (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *first,
...);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_append_buttons</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This function is mostly for internal library use. You should use
<a href="GnomeDialog.html#gnome-dialog-new"><code class="function">gnome_dialog_new()</code></a> instead. See that function for a description of
the button arguments.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to add buttons to.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>first</code></em> :</span></td>
<td> First button to add.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>...</code></em> :</span></td>
<td> varargs list of additional buttons, NULL-terminated.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3144594"></a><h3>
<a name="gnome-dialog-append-button"></a>gnome_dialog_append_button ()</h3>
<a class="indexterm" name="id3144610"></a><pre class="programlisting">void gnome_dialog_append_button (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *button_name);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_append_button</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Add a button to a dialog after its initial construction.
This function is mostly for internal library use. You should use
<a href="GnomeDialog.html#gnome-dialog-new"><code class="function">gnome_dialog_new()</code></a> instead. See that function for a description of
the button argument.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to add button to.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>button_name</code></em> :</span></td>
<td> Button to add.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3144715"></a><h3>
<a name="gnome-dialog-append-buttonsv"></a>gnome_dialog_append_buttonsv ()</h3>
<a class="indexterm" name="id3144731"></a><pre class="programlisting">void gnome_dialog_append_buttonsv (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **buttons);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_append_buttonsv</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
For internal use, language bindings, etc. Use <a href="GnomeDialog.html#gnome-dialog-new"><code class="function">gnome_dialog_new()</code></a> instead.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to append to.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>buttons</code></em> :</span></td>
<td> NULL-terminated vector of buttons to append.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3144835"></a><h3>
<a name="gnome-dialog-append-button-with-pixmap"></a>gnome_dialog_append_button_with_pixmap ()</h3>
<a class="indexterm" name="id3144851"></a><pre class="programlisting">void gnome_dialog_append_button_with_pixmap
(<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *button_name,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *pixmap_name);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_append_button_with_pixmap</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Add a pixmap button to a dialog.
<a href="GnomeDialog.html#gnome-dialog-new"><code class="function">gnome_dialog_new()</code></a> does not permit custom buttons with pixmaps, so if you
want one of those you need to use this function.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to add the button to.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>button_name</code></em> :</span></td>
<td> Name of the button, or stock button <span class="type">define</span>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>pixmap_name</code></em> :</span></td>
<td> Stock pixmap name.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3144989"></a><h3>
<a name="gnome-dialog-append-buttons-with-pixmaps"></a>gnome_dialog_append_buttons_with_pixmaps ()</h3>
<a class="indexterm" name="id3145005"></a><pre class="programlisting">void gnome_dialog_append_buttons_with_pixmaps
(<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **names,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **pixmaps);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_append_buttons_with_pixmaps</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Simply calls <a href="GnomeDialog.html#gnome-dialog-append-button-with-pixmap"><code class="function">gnome_dialog_append_button_with_pixmap()</code></a> repeatedly.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> <a href="GnomeDialog.html" title="GnomeDialog"><span class="type">GnomeDialog</span></a> to append to.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>names</code></em> :</span></td>
<td> NULL-terminated vector of button names.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>pixmaps</code></em> :</span></td>
<td> NULL-terminated vector of pixmap names.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145133"></a><h3>
<a name="gnome-dialog-construct"></a>gnome_dialog_construct ()</h3>
<a class="indexterm" name="id3145149"></a><pre class="programlisting">void gnome_dialog_construct (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *title,
va_list ap);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_construct</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
See <a href="GnomeDialog.html#gnome-dialog-new"><code class="function">gnome_dialog_new()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> Dialog to construct.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>title</code></em> :</span></td>
<td> Title of the dialog.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>ap</code></em> :</span></td>
<td> va_list of buttons, NULL-terminated.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145266"></a><h3>
<a name="gnome-dialog-constructv"></a>gnome_dialog_constructv ()</h3>
<a class="indexterm" name="id3145281"></a><pre class="programlisting">void gnome_dialog_constructv (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *title,
const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **buttons);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_dialog_constructv</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
See <a href="GnomeDialog.html#gnome-dialog-new"><code class="function">gnome_dialog_new()</code></a>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td> Dialog to construct.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>title</code></em> :</span></td>
<td> Title of the dialog.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>buttons</code></em> :</span></td>
<td> NULL-terminated array of buttons.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145398"></a><h3>
<a name="GNOME-STOCK-BUTTON-OK:CAPS"></a>GNOME_STOCK_BUTTON_OK</h3>
<a class="indexterm" name="id3145413"></a><pre class="programlisting">#define GNOME_STOCK_BUTTON_OK GTK_STOCK_OK
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GNOME_STOCK_BUTTON_OK</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This button has been replaced by one in GTK+ and new code should use that.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145443"></a><h3>
<a name="GNOME-STOCK-BUTTON-CANCEL:CAPS"></a>GNOME_STOCK_BUTTON_CANCEL</h3>
<a class="indexterm" name="id3145459"></a><pre class="programlisting">#define GNOME_STOCK_BUTTON_CANCEL GTK_STOCK_CANCEL
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GNOME_STOCK_BUTTON_CANCEL</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This button has been replaced by one in GTK+ and new code should use that.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145489"></a><h3>
<a name="GNOME-STOCK-BUTTON-YES:CAPS"></a>GNOME_STOCK_BUTTON_YES</h3>
<a class="indexterm" name="id3145505"></a><pre class="programlisting">#define GNOME_STOCK_BUTTON_YES GTK_STOCK_YES
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GNOME_STOCK_BUTTON_YES</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This button has been replaced by one in GTK+ and new code should use that.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145535"></a><h3>
<a name="GNOME-STOCK-BUTTON-NO:CAPS"></a>GNOME_STOCK_BUTTON_NO</h3>
<a class="indexterm" name="id3145550"></a><pre class="programlisting">#define GNOME_STOCK_BUTTON_NO GTK_STOCK_NO
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GNOME_STOCK_BUTTON_NO</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This button has been replaced by one in GTK+ and new code should use that.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145580"></a><h3>
<a name="GNOME-STOCK-BUTTON-CLOSE:CAPS"></a>GNOME_STOCK_BUTTON_CLOSE</h3>
<a class="indexterm" name="id3145595"></a><pre class="programlisting">#define GNOME_STOCK_BUTTON_CLOSE GTK_STOCK_CLOSE
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GNOME_STOCK_BUTTON_CLOSE</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This button has been replaced by one in GTK+ and new code should use that.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145625"></a><h3>
<a name="GNOME-STOCK-BUTTON-APPLY:CAPS"></a>GNOME_STOCK_BUTTON_APPLY</h3>
<a class="indexterm" name="id3145641"></a><pre class="programlisting">#define GNOME_STOCK_BUTTON_APPLY GTK_STOCK_APPLY
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GNOME_STOCK_BUTTON_APPLY</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This button has been replaced by one in GTK+ and new code should use that.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145670"></a><h3>
<a name="GNOME-STOCK-BUTTON-HELP:CAPS"></a>GNOME_STOCK_BUTTON_HELP</h3>
<a class="indexterm" name="id3145686"></a><pre class="programlisting">#define GNOME_STOCK_BUTTON_HELP GTK_STOCK_HELP
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GNOME_STOCK_BUTTON_HELP</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This button has been replaced by one in GTK+ and new code should use that.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145716"></a><h3>
<a name="GNOME-STOCK-BUTTON-NEXT:CAPS"></a>GNOME_STOCK_BUTTON_NEXT</h3>
<a class="indexterm" name="id3145731"></a><pre class="programlisting">#define GNOME_STOCK_BUTTON_NEXT GTK_STOCK_GO_FORWARD
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GNOME_STOCK_BUTTON_NEXT</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This button has been replaced by one in GTK+ and new code should use that.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145761"></a><h3>
<a name="GNOME-STOCK-BUTTON-PREV:CAPS"></a>GNOME_STOCK_BUTTON_PREV</h3>
<a class="indexterm" name="id3145776"></a><pre class="programlisting">#define GNOME_STOCK_BUTTON_PREV GTK_STOCK_GO_BACK
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GNOME_STOCK_BUTTON_PREV</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This button has been replaced by one in GTK+ and new code should use that.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145806"></a><h3>
<a name="GNOME-STOCK-BUTTON-UP:CAPS"></a>GNOME_STOCK_BUTTON_UP</h3>
<a class="indexterm" name="id3145822"></a><pre class="programlisting">#define GNOME_STOCK_BUTTON_UP GTK_STOCK_GO_UP
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GNOME_STOCK_BUTTON_UP</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This button has been replaced by one in GTK+ and new code should use that.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145852"></a><h3>
<a name="GNOME-STOCK-BUTTON-DOWN:CAPS"></a>GNOME_STOCK_BUTTON_DOWN</h3>
<a class="indexterm" name="id3145868"></a><pre class="programlisting">#define GNOME_STOCK_BUTTON_DOWN GTK_STOCK_GO_DOWN
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GNOME_STOCK_BUTTON_DOWN</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This button has been replaced by one in GTK+ and new code should use that.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3145898"></a><h3>
<a name="GNOME-STOCK-BUTTON-FONT:CAPS"></a>GNOME_STOCK_BUTTON_FONT</h3>
<a class="indexterm" name="id3145914"></a><pre class="programlisting">#define GNOME_STOCK_BUTTON_FONT GTK_STOCK_SELECT_FONT
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">GNOME_STOCK_BUTTON_FONT</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
This button has been replaced by one in GTK+ and new code should use that.
</p>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id3145945"></a><h2>Signal Details</h2>
<div class="refsect2" lang="en">
<a name="id3145955"></a><h3>
<a name="GnomeDialog-clicked"></a>The "clicked" signal</h3>
<a class="indexterm" name="id3145965"></a><pre class="programlisting">void user_function (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> arg1,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>arg1</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3146053"></a><h3>
<a name="GnomeDialog-close"></a>The "close" signal</h3>
<a class="indexterm" name="id3146064"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> user_function (<a href="GnomeDialog.html" title="GnomeDialog">GnomeDialog</a> *dialog,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> user_data) : Run last</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dialog</code></em> :</span></td>
<td>the object which received the signal.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em> :</span></td>
<td>user data set when the signal handler was connected.</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
</body>
</html>