← Back to branch summary

~ubuntu-branches/ubuntu/raring/gtk+2.0/raring-proposed

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/GtkDialog.html

  • Committer: Package Import Robot
  • Author(s): Ken VanDine
  • Date: 2011-12-01 11:40:06 UTC
  • mfrom: (1.14.11)
  • Revision ID: package-import@ubuntu.com-20111201114006-nrmf6qu3pg512veo
Tags: 2.24.8-0ubuntu1
https://launchpad.net/bugs/189494
https://launchpad.net/bugs/889019
* New upstream release 
  - gtkfilechooser should be more robust to malformed URIs
    in .gtk-bookmarks (LP: #189494)
* debian/patches/010_make_bg_changes_queue_repaint.patch
  - dropped it introduces performance regressions in some gtk2 
    apps (LP: #889019)
* 101_filechooser.patch, 000git_file_chooser.patch: dropped, upstream

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkDialog.html
8
8
<link rel="up" href="WindowWidgets.html" title="Windows">
9
9
<link rel="prev" href="WindowWidgets.html" title="Windows">
10
10
<link rel="next" href="GtkInvisible.html" title="GtkInvisible">
11
 
<meta name="generator" content="GTK-Doc V1.17.1 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
54
54
enum                <a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags">GtkDialogFlags</a>;
55
55
enum                <a class="link" href="GtkDialog.html#GtkResponseType" title="enum GtkResponseType">GtkResponseType</a>;
56
56
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkDialog.html#gtk-dialog-new" title="gtk_dialog_new ()">gtk_dialog_new</a>                      (<em class="parameter"><code><span class="type">void</span></code></em>);
57
 
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkDialog.html#gtk-dialog-new-with-buttons" title="gtk_dialog_new_with_buttons ()">gtk_dialog_new_with_buttons</a>         (<em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>,
 
57
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkDialog.html#gtk-dialog-new-with-buttons" title="gtk_dialog_new_with_buttons ()">gtk_dialog_new_with_buttons</a>         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>,
58
58
                                                         <em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
59
59
                                                         <em class="parameter"><code><a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags"><span class="type">GtkDialogFlags</span></a> flags</code></em>,
60
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_button_text</code></em>,
 
60
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_button_text</code></em>,
61
61
                                                         <em class="parameter"><code>...</code></em>);
62
 
<span class="returnvalue">gint</span>                <a class="link" href="GtkDialog.html#gtk-dialog-run" title="gtk_dialog_run ()">gtk_dialog_run</a>                      (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>);
 
62
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkDialog.html#gtk-dialog-run" title="gtk_dialog_run ()">gtk_dialog_run</a>                      (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>);
63
63
<span class="returnvalue">void</span>                <a class="link" href="GtkDialog.html#gtk-dialog-response" title="gtk_dialog_response ()">gtk_dialog_response</a>                 (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
64
 
                                                         <em class="parameter"><code><span class="type">gint</span> response_id</code></em>);
 
64
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);
65
65
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkDialog.html#gtk-dialog-add-button" title="gtk_dialog_add_button ()">gtk_dialog_add_button</a>               (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
66
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *button_text</code></em>,
67
 
                                                         <em class="parameter"><code><span class="type">gint</span> response_id</code></em>);
 
66
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *button_text</code></em>,
 
67
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);
68
68
<span class="returnvalue">void</span>                <a class="link" href="GtkDialog.html#gtk-dialog-add-buttons" title="gtk_dialog_add_buttons ()">gtk_dialog_add_buttons</a>              (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
69
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_button_text</code></em>,
 
69
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_button_text</code></em>,
70
70
                                                         <em class="parameter"><code>...</code></em>);
71
71
<span class="returnvalue">void</span>                <a class="link" href="GtkDialog.html#gtk-dialog-add-action-widget" title="gtk_dialog_add_action_widget ()">gtk_dialog_add_action_widget</a>        (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
72
72
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
73
 
                                                         <em class="parameter"><code><span class="type">gint</span> response_id</code></em>);
74
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkDialog.html#gtk-dialog-get-has-separator" title="gtk_dialog_get_has_separator ()">gtk_dialog_get_has_separator</a>        (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>);
 
73
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);
 
74
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkDialog.html#gtk-dialog-get-has-separator" title="gtk_dialog_get_has_separator ()">gtk_dialog_get_has_separator</a>        (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>);
75
75
<span class="returnvalue">void</span>                <a class="link" href="GtkDialog.html#gtk-dialog-set-default-response" title="gtk_dialog_set_default_response ()">gtk_dialog_set_default_response</a>     (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
76
 
                                                         <em class="parameter"><code><span class="type">gint</span> response_id</code></em>);
 
76
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);
77
77
<span class="returnvalue">void</span>                <a class="link" href="GtkDialog.html#gtk-dialog-set-has-separator" title="gtk_dialog_set_has_separator ()">gtk_dialog_set_has_separator</a>        (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
78
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);
 
78
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);
79
79
<span class="returnvalue">void</span>                <a class="link" href="GtkDialog.html#gtk-dialog-set-response-sensitive" title="gtk_dialog_set_response_sensitive ()">gtk_dialog_set_response_sensitive</a>   (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
80
 
                                                         <em class="parameter"><code><span class="type">gint</span> response_id</code></em>,
81
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);
82
 
<span class="returnvalue">gint</span>                <a class="link" href="GtkDialog.html#gtk-dialog-get-response-for-widget" title="gtk_dialog_get_response_for_widget ()">gtk_dialog_get_response_for_widget</a>  (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
 
80
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>,
 
81
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);
 
82
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="GtkDialog.html#gtk-dialog-get-response-for-widget" title="gtk_dialog_get_response_for_widget ()">gtk_dialog_get_response_for_widget</a>  (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
83
83
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);
84
84
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkDialog.html#gtk-dialog-get-widget-for-response" title="gtk_dialog_get_widget_for_response ()">gtk_dialog_get_widget_for_response</a>  (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
85
 
                                                         <em class="parameter"><code><span class="type">gint</span> response_id</code></em>);
 
85
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);
86
86
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkDialog.html#gtk-dialog-get-action-area" title="gtk_dialog_get_action_area ()">gtk_dialog_get_action_area</a>          (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>);
87
87
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkDialog.html#gtk-dialog-get-content-area" title="gtk_dialog_get_content_area ()">gtk_dialog_get_content_area</a>         (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>);
88
88
 
89
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkDialog.html#gtk-alternative-dialog-button-order" title="gtk_alternative_dialog_button_order ()">gtk_alternative_dialog_button_order</a> (<em class="parameter"><code><a href="../gdk/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);
 
89
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkDialog.html#gtk-alternative-dialog-button-order" title="gtk_alternative_dialog_button_order ()">gtk_alternative_dialog_button_order</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);
90
90
<span class="returnvalue">void</span>                <a class="link" href="GtkDialog.html#gtk-dialog-set-alternative-button-order" title="gtk_dialog_set_alternative_button_order ()">gtk_dialog_set_alternative_button_order</a>
91
91
                                                        (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
92
 
                                                         <em class="parameter"><code><span class="type">gint</span> first_response_id</code></em>,
 
92
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> first_response_id</code></em>,
93
93
                                                         <em class="parameter"><code>...</code></em>);
94
94
<span class="returnvalue">void</span>                <a class="link" href="GtkDialog.html#gtk-dialog-set-alternative-button-order-from-array" title="gtk_dialog_set_alternative_button_order_from_array ()">gtk_dialog_set_alternative_button_order_from_array</a>
95
95
                                                        (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
96
 
                                                         <em class="parameter"><code><span class="type">gint</span> n_params</code></em>,
97
 
                                                         <em class="parameter"><code><span class="type">gint</span> *new_order</code></em>);
 
96
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_params</code></em>,
 
97
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *new_order</code></em>);
98
98
</pre>
99
99
</div>
100
100
<div class="refsect1">
101
101
<a name="GtkDialog.object-hierarchy"></a><h2>Object Hierarchy</h2>
102
102
<pre class="synopsis">
103
 
  GObject
104
 
   +----GInitiallyUnowned
 
103
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
104
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
105
105
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
106
106
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
107
107
                     +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
129
129
<div class="refsect1">
130
130
<a name="GtkDialog.properties"></a><h2>Properties</h2>
131
131
<pre class="synopsis">
132
 
  "<a class="link" href="GtkDialog.html#GtkDialog--has-separator" title='The "has-separator" property'>has-separator</a>"            <span class="type">gboolean</span>              : Read / Write
 
132
  "<a class="link" href="GtkDialog.html#GtkDialog--has-separator" title='The "has-separator" property'>has-separator</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
133
133
</pre>
134
134
</div>
135
135
<div class="refsect1">
136
136
<a name="GtkDialog.style-properties"></a><h2>Style Properties</h2>
137
137
<pre class="synopsis">
138
 
  "<a class="link" href="GtkDialog.html#GtkDialog--s-action-area-border" title='The "action-area-border" style property'>action-area-border</a>"       <span class="type">gint</span>                  : Read
139
 
  "<a class="link" href="GtkDialog.html#GtkDialog--s-button-spacing" title='The "button-spacing" style property'>button-spacing</a>"           <span class="type">gint</span>                  : Read
140
 
  "<a class="link" href="GtkDialog.html#GtkDialog--s-content-area-border" title='The "content-area-border" style property'>content-area-border</a>"      <span class="type">gint</span>                  : Read
141
 
  "<a class="link" href="GtkDialog.html#GtkDialog--s-content-area-spacing" title='The "content-area-spacing" style property'>content-area-spacing</a>"     <span class="type">gint</span>                  : Read
 
138
  "<a class="link" href="GtkDialog.html#GtkDialog--s-action-area-border" title='The "action-area-border" style property'>action-area-border</a>"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 
139
  "<a class="link" href="GtkDialog.html#GtkDialog--s-button-spacing" title='The "button-spacing" style property'>button-spacing</a>"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 
140
  "<a class="link" href="GtkDialog.html#GtkDialog--s-content-area-border" title='The "content-area-border" style property'>content-area-border</a>"      <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
 
141
  "<a class="link" href="GtkDialog.html#GtkDialog--s-content-area-spacing" title='The "content-area-spacing" style property'>content-area-spacing</a>"     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read
142
142
</pre>
143
143
</div>
144
144
<div class="refsect1">
145
145
<a name="GtkDialog.signals"></a><h2>Signals</h2>
146
146
<pre class="synopsis">
147
 
  "<a class="link" href="GtkDialog.html#GtkDialog-close" title='The "close" signal'>close</a>"                                          : <code class="literal">Action</code>
148
 
  "<a class="link" href="GtkDialog.html#GtkDialog-response" title='The "response" signal'>response</a>"                                       : <code class="literal">Run Last</code>
 
147
  "<a class="link" href="GtkDialog.html#GtkDialog-close" title='The "close" signal'>close</a>"                                          : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a>
 
148
  "<a class="link" href="GtkDialog.html#GtkDialog-response" title='The "response" signal'>response</a>"                                       : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
149
149
</pre>
150
150
</div>
151
151
<div class="refsect1">
203
203
dialog contents manually if you had more than a simple message in the dialog.
204
204
</p>
205
205
<div class="example">
206
 
<a name="id655134"></a><p class="title"><b>Example 6. Simple <span class="structname">GtkDialog</span> usage.</b></p>
 
206
<a name="id705951"></a><p class="title"><b>Example 6. Simple <span class="structname">GtkDialog</span> usage.</b></p>
207
207
<div class="example-contents">
208
208
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
209
209
    <tbody>
238
238
<span class="normal">                                         <a href="GtkDialog.html#GTK-DIALOG-DESTROY-WITH-PARENT:CAPS">GTK_DIALOG_DESTROY_WITH_PARENT</a></span><span class="symbol">,</span>
239
239
<span class="normal">                                         <a href="gtk-Stock-Items.html#GTK-STOCK-OK:CAPS">GTK_STOCK_OK</a></span><span class="symbol">,</span>
240
240
<span class="normal">                                         <a href="GtkDialog.html#GTK-RESPONSE-NONE:CAPS">GTK_RESPONSE_NONE</a></span><span class="symbol">,</span>
241
 
<span class="normal">                                         <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a></span><span class="symbol">);</span>
 
241
<span class="normal">                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
242
242
<span class="normal">   content_area </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkDialog.html#gtk-dialog-get-content-area">gtk_dialog_get_content_area</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_DIALOG</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dialog</span><span class="symbol">));</span>
243
243
<span class="normal">   label </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkLabel.html#gtk-label-new">gtk_label_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">message</span><span class="symbol">);</span>
244
244
<span class="normal">   </span><span class="comment">/* Ensure that the dialog box is destroyed when the user responds. */</span>
245
 
<span class="normal">   </span><span class="function">g_signal_connect_swapped</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dialog</span><span class="symbol">,</span>
 
245
<span class="normal">   </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dialog</span><span class="symbol">,</span>
246
246
<span class="normal">                             </span><span class="string">"response"</span><span class="symbol">,</span>
247
 
<span class="normal">                             </span><span class="function">G_CALLBACK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span><span class="symbol">),</span>
 
247
<span class="normal">                             </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span><span class="symbol">),</span>
248
248
<span class="normal">                             dialog</span><span class="symbol">);</span>
249
249
<span class="normal">   </span><span class="comment">/* Add the label, and show everything we've added to the dialog. */</span>
250
250
<span class="normal">   </span><span class="function"><a href="GtkContainer.html#gtk-container-add">gtk_container_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_CONTAINER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">content_area</span><span class="symbol">),</span><span class="normal"> label</span><span class="symbol">);</span>
272
272
is the id of widget (which should be a child of the dialogs <em class="parameter"><code>action_area</code></em>).
273
273
</p>
274
274
<div class="example">
275
 
<a name="id655198"></a><p class="title"><b>Example 7. A <span class="structname">GtkDialog</span> UI definition fragment.</b></p>
 
275
<a name="id706015"></a><p class="title"><b>Example 7. A <span class="structname">GtkDialog</span> UI definition fragment.</b></p>
276
276
<div class="example-contents">
277
277
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
278
278
    <tbody>
500
500
<hr>
501
501
<div class="refsect2">
502
502
<a name="gtk-dialog-new-with-buttons"></a><h3>gtk_dialog_new_with_buttons ()</h3>
503
 
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_dialog_new_with_buttons         (<em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>,
 
503
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_dialog_new_with_buttons         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>,
504
504
                                                         <em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
505
505
                                                         <em class="parameter"><code><a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags"><span class="type">GtkDialogFlags</span></a> flags</code></em>,
506
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_button_text</code></em>,
 
506
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_button_text</code></em>,
507
507
                                                         <em class="parameter"><code>...</code></em>);</pre>
508
508
<p>
509
 
Creates a new <a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> with title <em class="parameter"><code>title</code></em> (or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for the default
 
509
Creates a new <a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> with title <em class="parameter"><code>title</code></em> (or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default
510
510
title; see <a class="link" href="GtkWindow.html#gtk-window-set-title" title="gtk_window_set_title ()"><code class="function">gtk_window_set_title()</code></a>) and transient parent <em class="parameter"><code>parent</code></em> (or
511
 
<a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> for none; see <a class="link" href="GtkWindow.html#gtk-window-set-transient-for" title="gtk_window_set_transient_for ()"><code class="function">gtk_window_set_transient_for()</code></a>). The <em class="parameter"><code>flags</code></em>
 
511
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for none; see <a class="link" href="GtkWindow.html#gtk-window-set-transient-for" title="gtk_window_set_transient_for ()"><code class="function">gtk_window_set_transient_for()</code></a>). The <em class="parameter"><code>flags</code></em>
512
512
argument can be used to make the dialog modal (<a class="link" href="GtkDialog.html#GTK-DIALOG-MODAL:CAPS"><span class="type">GTK_DIALOG_MODAL</span></a>)
513
513
and/or to have it destroyed along with its transient parent
514
514
(<a class="link" href="GtkDialog.html#GTK-DIALOG-DESTROY-WITH-PARENT:CAPS"><span class="type">GTK_DIALOG_DESTROY_WITH_PARENT</span></a>). After <em class="parameter"><code>flags</code></em>, button
515
 
text/response ID pairs should be listed, with a <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> pointer ending
 
515
text/response ID pairs should be listed, with a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> pointer ending
516
516
the list. Button text can be either a stock ID such as
517
517
<a class="link" href="gtk-Stock-Items.html#GTK-STOCK-OK:CAPS" title="GTK_STOCK_OK"><span class="type">GTK_STOCK_OK</span></a>, or some arbitrary text. A response ID can be
518
518
any positive number, or one of the values in the <a class="link" href="GtkDialog.html#GtkResponseType" title="enum GtkResponseType"><span class="type">GtkResponseType</span></a>
547
547
<span class="normal">                                                 <a href="GtkDialog.html#GTK-RESPONSE-ACCEPT:CAPS">GTK_RESPONSE_ACCEPT</a></span><span class="symbol">,</span>
548
548
<span class="normal">                                                 <a href="gtk-Stock-Items.html#GTK-STOCK-CANCEL:CAPS">GTK_STOCK_CANCEL</a></span><span class="symbol">,</span>
549
549
<span class="normal">                                                 <a href="GtkDialog.html#GTK-RESPONSE-REJECT:CAPS">GTK_RESPONSE_REJECT</a></span><span class="symbol">,</span>
550
 
<span class="normal">                                                 <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
 
550
<span class="normal">                                                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
551
551
      </tr>
552
552
    </tbody>
553
553
  </table>
560
560
<tbody>
561
561
<tr>
562
562
<td><p><span class="term"><em class="parameter"><code>title</code></em> :</span></p></td>
563
 
<td>Title of the dialog, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
563
<td>Title of the dialog, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
564
564
</td>
565
565
</tr>
566
566
<tr>
567
567
<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
568
 
<td>Transient parent of the dialog, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
568
<td>Transient parent of the dialog, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
569
569
</td>
570
570
</tr>
571
571
<tr>
575
575
</tr>
576
576
<tr>
577
577
<td><p><span class="term"><em class="parameter"><code>first_button_text</code></em> :</span></p></td>
578
 
<td>stock ID or text to go in first button, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
578
<td>stock ID or text to go in first button, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
579
</td>
 
580
</tr>
 
581
<tr>
 
582
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
 
583
<td>response ID for first button, then additional buttons, ending with <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
579
584
</td>
580
585
</tr>
581
586
<tr>
589
594
<hr>
590
595
<div class="refsect2">
591
596
<a name="gtk-dialog-run"></a><h3>gtk_dialog_run ()</h3>
592
 
<pre class="programlisting"><span class="returnvalue">gint</span>                gtk_dialog_run                      (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>);</pre>
 
597
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_dialog_run                      (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>);</pre>
593
598
<p>
594
599
Blocks in a recursive main loop until the <em class="parameter"><code>dialog</code></em> either emits the
595
600
<a class="link" href="GtkDialog.html#GtkDialog-response" title='The "response" signal'><span class="type">"response"</span></a> signal, or is destroyed. If the dialog is 
678
683
<div class="refsect2">
679
684
<a name="gtk-dialog-response"></a><h3>gtk_dialog_response ()</h3>
680
685
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_dialog_response                 (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
681
 
                                                         <em class="parameter"><code><span class="type">gint</span> response_id</code></em>);</pre>
 
686
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);</pre>
682
687
<p>
683
688
Emits the <a class="link" href="GtkDialog.html#GtkDialog-response" title='The "response" signal'><span class="type">"response"</span></a> signal with the given response ID. 
684
689
Used to indicate that the user has responded to the dialog in some way;
704
709
<div class="refsect2">
705
710
<a name="gtk-dialog-add-button"></a><h3>gtk_dialog_add_button ()</h3>
706
711
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_dialog_add_button               (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
707
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *button_text</code></em>,
708
 
                                                         <em class="parameter"><code><span class="type">gint</span> response_id</code></em>);</pre>
 
712
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *button_text</code></em>,
 
713
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);</pre>
709
714
<p>
710
715
Adds a button with the given text (or a stock button, if <em class="parameter"><code>button_text</code></em> is a
711
716
stock ID) and sets things up so that clicking the button will emit the
741
746
<div class="refsect2">
742
747
<a name="gtk-dialog-add-buttons"></a><h3>gtk_dialog_add_buttons ()</h3>
743
748
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_dialog_add_buttons              (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
744
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_button_text</code></em>,
 
749
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_button_text</code></em>,
745
750
                                                         <em class="parameter"><code>...</code></em>);</pre>
746
751
<p>
747
752
Adds more buttons, same as calling <a class="link" href="GtkDialog.html#gtk-dialog-add-button" title="gtk_dialog_add_button ()"><code class="function">gtk_dialog_add_button()</code></a>
748
 
repeatedly.  The variable argument list should be <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>-terminated
 
753
repeatedly.  The variable argument list should be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated
749
754
as with <a class="link" href="GtkDialog.html#gtk-dialog-new-with-buttons" title="gtk_dialog_new_with_buttons ()"><code class="function">gtk_dialog_new_with_buttons()</code></a>. Each button must have both
750
755
text and response ID.
751
756
</p>
761
766
<td><p><span class="term"><em class="parameter"><code>first_button_text</code></em> :</span></p></td>
762
767
<td>button text or stock ID</td>
763
768
</tr>
 
769
<tr>
 
770
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
 
771
<td>response ID for first button, then more text-response_id pairs</td>
 
772
</tr>
764
773
</tbody>
765
774
</table></div>
766
775
</div>
769
778
<a name="gtk-dialog-add-action-widget"></a><h3>gtk_dialog_add_action_widget ()</h3>
770
779
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_dialog_add_action_widget        (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
771
780
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
772
 
                                                         <em class="parameter"><code><span class="type">gint</span> response_id</code></em>);</pre>
 
781
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);</pre>
773
782
<p>
774
783
Adds an activatable widget to the action area of a <a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a>,
775
784
connecting a signal handler that will emit the <a class="link" href="GtkDialog.html#GtkDialog-response" title='The "response" signal'><span class="type">"response"</span></a> 
801
810
<hr>
802
811
<div class="refsect2">
803
812
<a name="gtk-dialog-get-has-separator"></a><h3>gtk_dialog_get_has_separator ()</h3>
804
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_dialog_get_has_separator        (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>);</pre>
 
813
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_dialog_get_has_separator        (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>);</pre>
805
814
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
806
815
<h3 class="title">Warning</h3>
807
816
<p><code class="literal">gtk_dialog_get_has_separator</code> has been deprecated since version 2.22 and should not be used in newly-written code. This function will be removed in GTK+ 3</p>
820
829
<tr>
821
830
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
822
831
<td>
823
 
<code class="literal">TRUE</code> if the dialog has a separator</td>
 
832
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the dialog has a separator</td>
824
833
</tr>
825
834
</tbody>
826
835
</table></div>
829
838
<div class="refsect2">
830
839
<a name="gtk-dialog-set-default-response"></a><h3>gtk_dialog_set_default_response ()</h3>
831
840
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_dialog_set_default_response     (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
832
 
                                                         <em class="parameter"><code><span class="type">gint</span> response_id</code></em>);</pre>
 
841
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);</pre>
833
842
<p>
834
843
Sets the last widget in the dialog's action area with the given <em class="parameter"><code>response_id</code></em>
835
844
as the default widget for the dialog. Pressing "Enter" normally activates
854
863
<div class="refsect2">
855
864
<a name="gtk-dialog-set-has-separator"></a><h3>gtk_dialog_set_has_separator ()</h3>
856
865
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_dialog_set_has_separator        (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
857
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
 
866
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre>
858
867
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
859
868
<h3 class="title">Warning</h3>
860
869
<p><code class="literal">gtk_dialog_set_has_separator</code> has been deprecated since version 2.22 and should not be used in newly-written code. This function will be removed in GTK+ 3</p>
873
882
<tr>
874
883
<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td>
875
884
<td>
876
 
<code class="literal">TRUE</code> to have a separator</td>
 
885
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to have a separator</td>
877
886
</tr>
878
887
</tbody>
879
888
</table></div>
882
891
<div class="refsect2">
883
892
<a name="gtk-dialog-set-response-sensitive"></a><h3>gtk_dialog_set_response_sensitive ()</h3>
884
893
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_dialog_set_response_sensitive   (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
885
 
                                                         <em class="parameter"><code><span class="type">gint</span> response_id</code></em>,
886
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> setting</code></em>);</pre>
 
894
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>,
 
895
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> setting</code></em>);</pre>
887
896
<p>
888
897
Calls <code class="literal">gtk_widget_set_sensitive (widget, <em class="parameter"><code>setting</code></em>)</code> 
889
898
for each widget in the dialog's action area with the given <em class="parameter"><code>response_id</code></em>.
904
913
<tr>
905
914
<td><p><span class="term"><em class="parameter"><code>setting</code></em> :</span></p></td>
906
915
<td>
907
 
<code class="literal">TRUE</code> for sensitive</td>
 
916
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> for sensitive</td>
908
917
</tr>
909
918
</tbody>
910
919
</table></div>
912
921
<hr>
913
922
<div class="refsect2">
914
923
<a name="gtk-dialog-get-response-for-widget"></a><h3>gtk_dialog_get_response_for_widget ()</h3>
915
 
<pre class="programlisting"><span class="returnvalue">gint</span>                gtk_dialog_get_response_for_widget  (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
 
924
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gtk_dialog_get_response_for_widget  (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
916
925
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);</pre>
917
926
<p>
918
927
Gets the response id of a widget in the action area
944
953
<div class="refsect2">
945
954
<a name="gtk-dialog-get-widget-for-response"></a><h3>gtk_dialog_get_widget_for_response ()</h3>
946
955
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_dialog_get_widget_for_response  (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
947
 
                                                         <em class="parameter"><code><span class="type">gint</span> response_id</code></em>);</pre>
 
956
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> response_id</code></em>);</pre>
948
957
<p>
949
958
Gets the widget button that uses the given response ID in the action area
950
959
of a dialog.
963
972
</tr>
964
973
<tr>
965
974
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
966
 
<td>the <em class="parameter"><code>widget</code></em> button that uses the given <em class="parameter"><code>response_id</code></em>, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
975
<td>the <em class="parameter"><code>widget</code></em> button that uses the given <em class="parameter"><code>response_id</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
967
976
</td>
968
977
</tr>
969
978
</tbody>
1021
1030
<hr>
1022
1031
<div class="refsect2">
1023
1032
<a name="gtk-alternative-dialog-button-order"></a><h3>gtk_alternative_dialog_button_order ()</h3>
1024
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_alternative_dialog_button_order (<em class="parameter"><code><a href="../gdk/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
 
1033
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_alternative_dialog_button_order (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
1025
1034
<p>
1026
 
Returns <code class="literal">TRUE</code> if dialogs are expected to use an alternative
 
1035
Returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if dialogs are expected to use an alternative
1027
1036
button order on the screen <em class="parameter"><code>screen</code></em>. See
1028
1037
<a class="link" href="GtkDialog.html#gtk-dialog-set-alternative-button-order" title="gtk_dialog_set_alternative_button_order ()"><code class="function">gtk_dialog_set_alternative_button_order()</code></a> for more details
1029
1038
about alternative button order. 
1039
1048
<tbody>
1040
1049
<tr>
1041
1050
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
1042
 
<td>a <a href="../gdk/GdkScreen.html"><span class="type">GdkScreen</span></a>, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> to use the default screen. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
1051
<td>a <a href="http://library.gnome.org/devel/gdk3/GdkScreen.html"><span class="type">GdkScreen</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to use the default screen. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
1043
1052
</td>
1044
1053
</tr>
1045
1054
<tr>
1055
1064
<a name="gtk-dialog-set-alternative-button-order"></a><h3>gtk_dialog_set_alternative_button_order ()</h3>
1056
1065
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_dialog_set_alternative_button_order
1057
1066
                                                        (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
1058
 
                                                         <em class="parameter"><code><span class="type">gint</span> first_response_id</code></em>,
 
1067
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> first_response_id</code></em>,
1059
1068
                                                         <em class="parameter"><code>...</code></em>);</pre>
1060
1069
<p>
1061
1070
Sets an alternative button order. If the 
1062
 
<a class="link" href="GtkSettings.html#GtkSettings--gtk-alternative-button-order" title='The "gtk-alternative-button-order" property'><span class="type">"gtk-alternative-button-order"</span></a> setting is set to <code class="literal">TRUE</code>, 
 
1071
<a class="link" href="GtkSettings.html#GtkSettings--gtk-alternative-button-order" title='The "gtk-alternative-button-order" property'><span class="type">"gtk-alternative-button-order"</span></a> setting is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, 
1063
1072
the dialog buttons are reordered according to the order of the 
1064
1073
response ids passed to this function.
1065
1074
</p>
1136
1145
<td><p><span class="term"><em class="parameter"><code>first_response_id</code></em> :</span></p></td>
1137
1146
<td>a response id used by one <em class="parameter"><code>dialog</code></em>'s buttons</td>
1138
1147
</tr>
 
1148
<tr>
 
1149
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
 
1150
<td>a list of more response ids of <em class="parameter"><code>dialog</code></em>'s buttons, terminated by -1</td>
 
1151
</tr>
1139
1152
</tbody>
1140
1153
</table></div>
1141
1154
<p class="since">Since 2.6</p>
1145
1158
<a name="gtk-dialog-set-alternative-button-order-from-array"></a><h3>gtk_dialog_set_alternative_button_order_from_array ()</h3>
1146
1159
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_dialog_set_alternative_button_order_from_array
1147
1160
                                                        (<em class="parameter"><code><a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog</code></em>,
1148
 
                                                         <em class="parameter"><code><span class="type">gint</span> n_params</code></em>,
1149
 
                                                         <em class="parameter"><code><span class="type">gint</span> *new_order</code></em>);</pre>
 
1161
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> n_params</code></em>,
 
1162
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *new_order</code></em>);</pre>
1150
1163
<p>
1151
1164
Sets an alternative button order. If the 
1152
 
<a class="link" href="GtkSettings.html#GtkSettings--gtk-alternative-button-order" title='The "gtk-alternative-button-order" property'><span class="type">"gtk-alternative-button-order"</span></a> setting is set to <code class="literal">TRUE</code>, 
 
1165
<a class="link" href="GtkSettings.html#GtkSettings--gtk-alternative-button-order" title='The "gtk-alternative-button-order" property'><span class="type">"gtk-alternative-button-order"</span></a> setting is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, 
1153
1166
the dialog buttons are reordered according to the order of the 
1154
1167
response ids in <em class="parameter"><code>new_order</code></em>.
1155
1168
</p>
1187
1200
<a name="GtkDialog.property-details"></a><h2>Property Details</h2>
1188
1201
<div class="refsect2">
1189
1202
<a name="GtkDialog--has-separator"></a><h3>The <code class="literal">"has-separator"</code> property</h3>
1190
 
<pre class="programlisting">  "has-separator"            <span class="type">gboolean</span>              : Read / Write</pre>
 
1203
<pre class="programlisting">  "has-separator"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
1191
1204
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1192
1205
<h3 class="title">Warning</h3>
1193
1206
<p><code class="literal">GtkDialog:has-separator</code> has been deprecated since version 2.22 and should not be used in newly-written code. This property will be removed in GTK+ 3.</p>
1194
1207
</div>
1195
1208
<p>
1196
 
When <code class="literal">TRUE</code>, the dialog has a separator bar above its buttons.
 
1209
When <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the dialog has a separator bar above its buttons.
1197
1210
</p>
1198
1211
<p>Default value: FALSE</p>
1199
1212
</div>
1202
1215
<a name="GtkDialog.style-property-details"></a><h2>Style Property Details</h2>
1203
1216
<div class="refsect2">
1204
1217
<a name="GtkDialog--s-action-area-border"></a><h3>The <code class="literal">"action-area-border"</code> style property</h3>
1205
 
<pre class="programlisting">  "action-area-border"       <span class="type">gint</span>                  : Read</pre>
 
1218
<pre class="programlisting">  "action-area-border"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
1206
1219
<p>Width of border around the button area at the bottom of the dialog.</p>
1207
1220
<p>Allowed values: &gt;= 0</p>
1208
1221
<p>Default value: 5</p>
1210
1223
<hr>
1211
1224
<div class="refsect2">
1212
1225
<a name="GtkDialog--s-button-spacing"></a><h3>The <code class="literal">"button-spacing"</code> style property</h3>
1213
 
<pre class="programlisting">  "button-spacing"           <span class="type">gint</span>                  : Read</pre>
 
1226
<pre class="programlisting">  "button-spacing"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
1214
1227
<p>Spacing between buttons.</p>
1215
1228
<p>Allowed values: &gt;= 0</p>
1216
1229
<p>Default value: 6</p>
1218
1231
<hr>
1219
1232
<div class="refsect2">
1220
1233
<a name="GtkDialog--s-content-area-border"></a><h3>The <code class="literal">"content-area-border"</code> style property</h3>
1221
 
<pre class="programlisting">  "content-area-border"      <span class="type">gint</span>                  : Read</pre>
 
1234
<pre class="programlisting">  "content-area-border"      <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
1222
1235
<p>Width of border around the main dialog area.</p>
1223
1236
<p>Allowed values: &gt;= 0</p>
1224
1237
<p>Default value: 2</p>
1226
1239
<hr>
1227
1240
<div class="refsect2">
1228
1241
<a name="GtkDialog--s-content-area-spacing"></a><h3>The <code class="literal">"content-area-spacing"</code> style property</h3>
1229
 
<pre class="programlisting">  "content-area-spacing"     <span class="type">gint</span>                  : Read</pre>
 
1242
<pre class="programlisting">  "content-area-spacing"     <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read</pre>
1230
1243
<p>
1231
1244
The default spacing used between elements of the
1232
1245
content area of the dialog, as returned by
1243
1256
<div class="refsect2">
1244
1257
<a name="GtkDialog-close"></a><h3>The <code class="literal">"close"</code> signal</h3>
1245
1258
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *arg0,
1246
 
                                                        <span class="type">gpointer</span>   user_data)      : <code class="literal">Action</code></pre>
 
1259
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a></pre>
1247
1260
<p>
1248
1261
The ::close signal is a
1249
1262
<a class="link" href="gtk-Bindings.html#keybinding-signals">keybinding signal</a>
1265
1278
<div class="refsect2">
1266
1279
<a name="GtkDialog-response"></a><h3>The <code class="literal">"response"</code> signal</h3>
1267
1280
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a> *dialog,
1268
 
                                                        <span class="type">gint</span>       response_id,
1269
 
                                                        <span class="type">gpointer</span>   user_data)        : <code class="literal">Run Last</code></pre>
 
1281
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>       response_id,
 
1282
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>   user_data)        : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
1270
1283
<p>
1271
1284
Emitted when an action widget is clicked, the dialog receives a 
1272
1285
delete event, or the application programmer calls <a class="link" href="GtkDialog.html#gtk-dialog-response" title="gtk_dialog_response ()"><code class="function">gtk_dialog_response()</code></a>. 
1320
1333
</div>
1321
1334
<div class="footer">
1322
1335
<hr>
1323
 
          Generated by GTK-Doc V1.17.1</div>
 
1336
          Generated by GTK-Doc V1.17</div>
1324
1337
</body>
1325
1338
</html>
 
 
b'\\ No newline at end of file'