~ubuntu-branches/debian/experimental/gtk+2.0/experimental

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkDialog.html#gtk-dialog-new" title="gtk_dialog_new ()">gtk_dialog_new</a> (<code>void</code>);

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkDialog.html#gtk-dialog-new-with-buttons" title="gtk_dialog_new_with_buttons ()">gtk_dialog_new_with_buttons</a> (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *title</code>,

<code><a class="link" href="GtkWindow.html" title="GtkWindow">GtkWindow</a> *parent</code>,

<code><a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags">GtkDialogFlags</a> flags</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *first_button_text</code>,

<code>const gchar *first_button_text</code>,

<code>...</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> <a class="link" href="GtkDialog.html#gtk-dialog-run" title="gtk_dialog_run ()">gtk_dialog_run</a> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>);

gint <a class="link" href="GtkDialog.html#gtk-dialog-run" title="gtk_dialog_run ()">gtk_dialog_run</a> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>);

void <a class="link" href="GtkDialog.html#gtk-dialog-response" title="gtk_dialog_response ()">gtk_dialog_response</a> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> response_id</code>);

<code>gint response_id</code>);

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkDialog.html#gtk-dialog-add-button" title="gtk_dialog_add_button ()">gtk_dialog_add_button</a> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *button_text</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> response_id</code>);

<code>const gchar *button_text</code>,

<code>gint response_id</code>);

void <a class="link" href="GtkDialog.html#gtk-dialog-add-buttons" title="gtk_dialog_add_buttons ()">gtk_dialog_add_buttons</a> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *first_button_text</code>,

<code>const gchar *first_button_text</code>,

<code>...</code>);

void <a class="link" href="GtkDialog.html#gtk-dialog-add-action-widget" title="gtk_dialog_add_action_widget ()">gtk_dialog_add_action_widget</a> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

<code><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> response_id</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkDialog.html#gtk-dialog-get-has-separator" title="gtk_dialog_get_has_separator ()">gtk_dialog_get_has_separator</a> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>);

<code>gint response_id</code>);

gboolean <a class="link" href="GtkDialog.html#gtk-dialog-get-has-separator" title="gtk_dialog_get_has_separator ()">gtk_dialog_get_has_separator</a> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>);

void <a class="link" href="GtkDialog.html#gtk-dialog-set-default-response" title="gtk_dialog_set_default_response ()">gtk_dialog_set_default_response</a> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> response_id</code>);

<code>gint response_id</code>);

void <a class="link" href="GtkDialog.html#gtk-dialog-set-has-separator" title="gtk_dialog_set_has_separator ()">gtk_dialog_set_has_separator</a> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> setting</code>);

<code>gboolean setting</code>);

void <a class="link" href="GtkDialog.html#gtk-dialog-set-response-sensitive" title="gtk_dialog_set_response_sensitive ()">gtk_dialog_set_response_sensitive</a> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> response_id</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> setting</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</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> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

<code>gint response_id</code>,

<code>gboolean setting</code>);

gint <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> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

<code><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget</code>);

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</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> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> response_id</code>);

<code>gint response_id</code>);

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkDialog.html#gtk-dialog-get-action-area" title="gtk_dialog_get_action_area ()">gtk_dialog_get_action_area</a> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>);

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkDialog.html#gtk-dialog-get-content-area" title="gtk_dialog_get_content_area ()">gtk_dialog_get_content_area</a> (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkDialog.html#gtk-alternative-dialog-button-order" title="gtk_alternative_dialog_button_order ()">gtk_alternative_dialog_button_order</a> (<code><a href="http://library.gnome.org/devel/gdk3/GdkScreen.html">GdkScreen</a> *screen</code>);

gboolean <a class="link" href="GtkDialog.html#gtk-alternative-dialog-button-order" title="gtk_alternative_dialog_button_order ()">gtk_alternative_dialog_button_order</a> (<code><a href="../gdk/GdkScreen.html">GdkScreen</a> *screen</code>);

void <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>

(<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> first_response_id</code>,

<code>gint first_response_id</code>,

<code>...</code>);

void <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>

(<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> n_params</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> *new_order</code>);

<code>gint n_params</code>,

<code>gint *new_order</code>);

</pre>

</div>

100

101

<a name="GtkDialog.object-hierarchy"></a><h2>Object Hierarchy</h2>

102

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>

103

GObject

104

+----GInitiallyUnowned

105

+----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>

106

+----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>

107

+----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>

129

130

<a name="GtkDialog.properties"></a><h2>Properties</h2>

131

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">gboolean</a> : Read / Write

132

"<a class="link" href="GtkDialog.html#GtkDialog--has-separator" title='The "has-separator" property'>has-separator</a>" gboolean : Read / Write

133

</pre>

134

</div>

135

136

<a name="GtkDialog.style-properties"></a><h2>Style Properties</h2>

137

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">gint</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">gint</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">gint</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">gint</a> : Read

138

"<a class="link" href="GtkDialog.html#GtkDialog--s-action-area-border" title='The "action-area-border" style property'>action-area-border</a>" gint : Read

139

"<a class="link" href="GtkDialog.html#GtkDialog--s-button-spacing" title='The "button-spacing" style property'>button-spacing</a>" gint : Read

140

"<a class="link" href="GtkDialog.html#GtkDialog--s-content-area-border" title='The "content-area-border" style property'>content-area-border</a>" gint : Read

141

"<a class="link" href="GtkDialog.html#GtkDialog--s-content-area-spacing" title='The "content-area-spacing" style property'>content-area-spacing</a>" gint : Read

142

</pre>

143

</div>

144

145

<a name="GtkDialog.signals"></a><h2>Signals</h2>

146

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>

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>

149

</pre>

150

</div>

151

203

dialog contents manually if you had more than a simple message in the dialog.

204

205

206

<a name="id534782"></a>Example 6. Simple GtkDialog usage.

206

<a name="id655134"></a>Example 6. Simple GtkDialog usage.

207

208

209

<tbody>

238

<a href="GtkDialog.html#GTK-DIALOG-DESTROY-WITH-PARENT:CAPS">GTK_DIALOG_DESTROY_WITH_PARENT</a>,

239

<a href="gtk-Stock-Items.html#GTK-STOCK-OK:CAPS">GTK_STOCK_OK</a>,

240

<a href="GtkDialog.html#GTK-RESPONSE-NONE:CAPS">GTK_RESPONSE_NONE</a>,

241

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>);

241

<a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a>);

242

content_area = <a href="GtkDialog.html#gtk-dialog-get-content-area">gtk_dialog_get_content_area</a> (GTK_DIALOG (dialog));

243

label = <a href="GtkLabel.html#gtk-label-new">gtk_label_new</a> (message);

244

/* Ensure that the dialog box is destroyed when the user responds. */

245

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a> (dialog,

245

g_signal_connect_swapped (dialog,

246

"response",

247

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a> (<a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a>),

247

G_CALLBACK (<a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a>),

248

dialog);

249

/* Add the label, and show everything we've added to the dialog. */

250

<a href="GtkContainer.html#gtk-container-add">gtk_container_add</a> (GTK_CONTAINER (content_area), label);

272

is the id of widget (which should be a child of the dialogs <code>action_area</code>).

273

274

275

<a name="id534846"></a>Example 7. A GtkDialog UI definition fragment.

275

<a name="id655198"></a>Example 7. A GtkDialog UI definition fragment.

276

277

278

<tbody>

500

<hr>

501

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">GtkWidget</a> * gtk_dialog_new_with_buttons (<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *title</code>,

503

504

<code><a class="link" href="GtkWindow.html" title="GtkWindow">GtkWindow</a> *parent</code>,

505

<code><a class="link" href="GtkDialog.html#GtkDialogFlags" title="enum GtkDialogFlags">GtkDialogFlags</a> flags</code>,

506

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *first_button_text</code>,

506

<code>const gchar *first_button_text</code>,

507

508

509

Creates a new <a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> with title <code>title</code> (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

509

Creates a new <a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> with title <code>title</code> (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

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 <code>parent</code> (or

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 <code>flags</code>

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 <code>flags</code>

512

argument can be used to make the dialog modal (<a class="link" href="GtkDialog.html#GTK-DIALOG-MODAL:CAPS">GTK_DIALOG_MODAL</a>)

513

and/or to have it destroyed along with its transient parent

514

(<a class="link" href="GtkDialog.html#GTK-DIALOG-DESTROY-WITH-PARENT:CAPS">GTK_DIALOG_DESTROY_WITH_PARENT</a>). After <code>flags</code>, button

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

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

516

the list. Button text can be either a stock ID such as

517

<a class="link" href="gtk-Stock-Items.html#GTK-STOCK-OK:CAPS" title="GTK_STOCK_OK">GTK_STOCK_OK</a>, or some arbitrary text. A response ID can be

518

any positive number, or one of the values in the <a class="link" href="GtkDialog.html#GtkResponseType" title="enum GtkResponseType">GtkResponseType</a>

547

<a href="GtkDialog.html#GTK-RESPONSE-ACCEPT:CAPS">GTK_RESPONSE_ACCEPT</a>,

548

<a href="gtk-Stock-Items.html#GTK-STOCK-CANCEL:CAPS">GTK_STOCK_CANCEL</a>,

549

<a href="GtkDialog.html#GTK-RESPONSE-REJECT:CAPS">GTK_RESPONSE_REJECT</a>,

550

550

551

</tr>

552

</tbody>

553

</table>

560

<tbody>

561

<tr>

562

<td><code>title</code> :</td>

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>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

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>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

564

</td>

565

</tr>

566

<tr>

567

<td><code>parent</code> :</td>

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>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

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>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

569

</td>

570

</tr>

571

<tr>

575

</tr>

576

<tr>

577

<td><code>first_button_text</code> :</td>

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>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

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>. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

579

</td>

580

</tr>

581

<tr>

589

<hr>

590

591

<a name="gtk-dialog-run"></a><h3>gtk_dialog_run ()</h3>

592

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> gtk_dialog_run (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>);</pre>

592

<pre class="programlisting">gint gtk_dialog_run (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>);</pre>

593

594

Blocks in a recursive main loop until the <code>dialog</code> either emits the

595

<a class="link" href="GtkDialog.html#GtkDialog-response" title='The "response" signal'>"response"</a> signal, or is destroyed. If the dialog is

678

679

<a name="gtk-dialog-response"></a><h3>gtk_dialog_response ()</h3>

680

<pre class="programlisting">void gtk_dialog_response (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

681

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> response_id</code>);</pre>

681

<code>gint response_id</code>);</pre>

682

683

Emits the <a class="link" href="GtkDialog.html#GtkDialog-response" title='The "response" signal'>"response"</a> signal with the given response ID.

684

Used to indicate that the user has responded to the dialog in some way;

704

705

<a name="gtk-dialog-add-button"></a><h3>gtk_dialog_add_button ()</h3>

706

<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * gtk_dialog_add_button (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

707

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *button_text</code>,

708

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> response_id</code>);</pre>

707

<code>const gchar *button_text</code>,

708

<code>gint response_id</code>);</pre>

709

710

Adds a button with the given text (or a stock button, if <code>button_text</code> is a

711

stock ID) and sets things up so that clicking the button will emit the

741

742

<a name="gtk-dialog-add-buttons"></a><h3>gtk_dialog_add_buttons ()</h3>

743

<pre class="programlisting">void gtk_dialog_add_buttons (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

744

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *first_button_text</code>,

744

<code>const gchar *first_button_text</code>,

745

746

747

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="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated

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

749

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

text and response ID.

751

769

<a name="gtk-dialog-add-action-widget"></a><h3>gtk_dialog_add_action_widget ()</h3>

770

<pre class="programlisting">void gtk_dialog_add_action_widget (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

771

<code><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *child</code>,

772

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> response_id</code>);</pre>

772

<code>gint response_id</code>);</pre>

773

774

Adds an activatable widget to the action area of a <a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a>,

775

connecting a signal handler that will emit the <a class="link" href="GtkDialog.html#GtkDialog-response" title='The "response" signal'>"response"</a>

801

<hr>

802

803

<a name="gtk-dialog-get-has-separator"></a><h3>gtk_dialog_get_has_separator ()</h3>

804

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_dialog_get_has_separator (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>);</pre>

804

<pre class="programlisting">gboolean gtk_dialog_get_has_separator (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>);</pre>

805

806

<h3 class="title">Warning</h3>

807

<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

820

<tr>

821

<td>Returns :</td>

822

<td>

823

<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>

823

<code class="literal">TRUE</code> if the dialog has a separator</td>

824

</tr>

825

</tbody>

826

</table></div>

829

830

<a name="gtk-dialog-set-default-response"></a><h3>gtk_dialog_set_default_response ()</h3>

831

<pre class="programlisting">void gtk_dialog_set_default_response (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

832

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> response_id</code>);</pre>

832

<code>gint response_id</code>);</pre>

833

834

Sets the last widget in the dialog's action area with the given <code>response_id</code>

835

as the default widget for the dialog. Pressing "Enter" normally activates

854

855

<a name="gtk-dialog-set-has-separator"></a><h3>gtk_dialog_set_has_separator ()</h3>

856

<pre class="programlisting">void gtk_dialog_set_has_separator (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

857

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> setting</code>);</pre>

857

<code>gboolean setting</code>);</pre>

858

859

<h3 class="title">Warning</h3>

860

<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

873

<tr>

874

<td><code>setting</code> :</td>

875

<td>

876

<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>

876

<code class="literal">TRUE</code> to have a separator</td>

877

</tr>

878

</tbody>

879

</table></div>

882

883

<a name="gtk-dialog-set-response-sensitive"></a><h3>gtk_dialog_set_response_sensitive ()</h3>

884

<pre class="programlisting">void gtk_dialog_set_response_sensitive (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

885

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> response_id</code>,

886

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> setting</code>);</pre>

885

<code>gint response_id</code>,

886

<code>gboolean setting</code>);</pre>

887

888

Calls <code class="literal">gtk_widget_set_sensitive (widget, <code>setting</code>)</code>

889

for each widget in the dialog's action area with the given <code>response_id</code>.

904

<tr>

905

<td><code>setting</code> :</td>

906

<td>

907

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> for sensitive</td>

907

<code class="literal">TRUE</code> for sensitive</td>

908

</tr>

909

</tbody>

910

</table></div>

912

<hr>

913

914

<a name="gtk-dialog-get-response-for-widget"></a><h3>gtk_dialog_get_response_for_widget ()</h3>

915

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> gtk_dialog_get_response_for_widget (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

915

<pre class="programlisting">gint gtk_dialog_get_response_for_widget (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

916

<code><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget</code>);</pre>

917

918

Gets the response id of a widget in the action area

944

945

<a name="gtk-dialog-get-widget-for-response"></a><h3>gtk_dialog_get_widget_for_response ()</h3>

946

<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * gtk_dialog_get_widget_for_response (<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

947

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> response_id</code>);</pre>

947

<code>gint response_id</code>);</pre>

948

949

Gets the widget button that uses the given response ID in the action area

950

of a dialog.

963

</tr>

964

<tr>

965

<td>Returns :</td>

966

<td>the <code>widget</code> button that uses the given <code>response_id</code>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

966

<td>the <code>widget</code> button that uses the given <code>response_id</code>, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

967

</td>

968

</tr>

969

</tbody>

1021

<hr>

1022

1023

<a name="gtk-alternative-dialog-button-order"></a><h3>gtk_alternative_dialog_button_order ()</h3>

1024

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_alternative_dialog_button_order (<code><a href="http://library.gnome.org/devel/gdk3/GdkScreen.html">GdkScreen</a> *screen</code>);</pre>

1024

<pre class="programlisting">gboolean gtk_alternative_dialog_button_order (<code><a href="../gdk/GdkScreen.html">GdkScreen</a> *screen</code>);</pre>

1025

1026

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

1026

Returns <code class="literal">TRUE</code> if dialogs are expected to use an alternative

1027

button order on the screen <code>screen</code>. See

1028

<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

about alternative button order.

1039

<tbody>

1040

<tr>

1041

<td><code>screen</code> :</td>

1042

<td>a <a href="http://library.gnome.org/devel/gdk3/GdkScreen.html">GdkScreen</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. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

1042

<td>a <a href="../gdk/GdkScreen.html">GdkScreen</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. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

1043

</td>

1044

</tr>

1045

<tr>

1055

<a name="gtk-dialog-set-alternative-button-order"></a><h3>gtk_dialog_set_alternative_button_order ()</h3>

1056

<pre class="programlisting">void gtk_dialog_set_alternative_button_order

1057

(<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

1058

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> first_response_id</code>,

1058

<code>gint first_response_id</code>,

1059

1060

1061

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'>"gtk-alternative-button-order"</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>,

1062

1063

the dialog buttons are reordered according to the order of the

1064

response ids passed to this function.

1065

1145

<a name="gtk-dialog-set-alternative-button-order-from-array"></a><h3>gtk_dialog_set_alternative_button_order_from_array ()</h3>

1146

<pre class="programlisting">void gtk_dialog_set_alternative_button_order_from_array

1147

(<code><a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog</code>,

1148

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> n_params</code>,

1149

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> *new_order</code>);</pre>

1148

<code>gint n_params</code>,

1149

<code>gint *new_order</code>);</pre>

1150

1151

Sets an alternative button order. If the

1152

1153

the dialog buttons are reordered according to the order of the

1154

response ids in <code>new_order</code>.

1155

1187

<a name="GtkDialog.property-details"></a><h2>Property Details</h2>

1188

1189

<a name="GtkDialog--has-separator"></a><h3>The <code class="literal">"has-separator"</code> property</h3>

1190

<pre class="programlisting"> "has-separator" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> : Read / Write</pre>

1190

<pre class="programlisting"> "has-separator" gboolean : Read / Write</pre>

1191

1192

<h3 class="title">Warning</h3>

1193

<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.

1194

</div>

1195

1196

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.

1196

When <code class="literal">TRUE</code>, the dialog has a separator bar above its buttons.

1197

1198

Default value: FALSE

1199

</div>

1202

<a name="GtkDialog.style-property-details"></a><h2>Style Property Details</h2>

1203

1204

<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" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> : Read</pre>

1205

<pre class="programlisting"> "action-area-border" gint : Read</pre>

1206

Width of border around the button area at the bottom of the dialog.

1207

Allowed values: >= 0

1208

Default value: 5

1210

<hr>

1211

1212

<a name="GtkDialog--s-button-spacing"></a><h3>The <code class="literal">"button-spacing"</code> style property</h3>

1213

<pre class="programlisting"> "button-spacing" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> : Read</pre>

1213

<pre class="programlisting"> "button-spacing" gint : Read</pre>

1214

Spacing between buttons.

1215

Allowed values: >= 0

1216

Default value: 6

1218

<hr>

1219

1220

<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" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> : Read</pre>

1221

<pre class="programlisting"> "content-area-border" gint : Read</pre>

1222

Width of border around the main dialog area.

1223

Allowed values: >= 0

1224

Default value: 2

1226

<hr>

1227

1228

<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" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> : Read</pre>

1229

<pre class="programlisting"> "content-area-spacing" gint : Read</pre>

1230

1231

The default spacing used between elements of the

1232

content area of the dialog, as returned by

1243

1244

<a name="GtkDialog-close"></a><h3>The <code class="literal">"close"</code> signal</h3>

1245

<pre class="programlisting">void user_function (<a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *arg0,

1246

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</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>

1246

gpointer user_data) : <code class="literal">Action</code></pre>

1247

1248

The ::close signal is a

1249

<a class="link" href="gtk-Bindings.html#keybinding-signals">keybinding signal</a>

1265

1266

<a name="GtkDialog-response"></a><h3>The <code class="literal">"response"</code> signal</h3>

1267

<pre class="programlisting">void user_function (<a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a> *dialog,

1268

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> response_id,

1269

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</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>

1268

gint response_id,

1269

gpointer user_data) : <code class="literal">Run Last</code></pre>

1270

1271

Emitted when an action widget is clicked, the dialog receives a

1272

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>.

Older »