</para>
<para>
-Gtk+ treats a dialog as a window split horizontally. The top section is a
-#GtkVBox, and is where widgets such as a #GtkLabel or a #GtkEntry should be
-packed. The second area is known as the
-<structfield>action_area</structfield>. This is generally used for packing
-buttons into the dialog which may perform functions such as cancel, ok, or
-apply. The two areas are separated by a #GtkHSeparator.
+GTK+ treats a dialog as a window split vertically. The top section is a
+#GtkVBox, and is where widgets such as a #GtkLabel or a #GtkEntry should
+be packed. The bottom area is known as the
+<structfield>action_area</structfield>. This is generally used for
+packing buttons into the dialog which may perform functions such as
+cancel, ok, or apply. The two areas are separated by a #GtkHSeparator.
</para>
<para>
<para>
If 'dialog' is a newly created dialog, the two primary areas of the window
-can be accessed as GTK_DIALOG(dialog)->vbox and GTK_DIALOG(dialog)->action_area,
+can be accessed as <literal>GTK_DIALOG(dialog)->vbox</literal> and
+<literal>GTK_DIALOG(dialog)->action_area</literal>,
as can be seen from the example, below.
</para>
user input), can be created by calling gtk_window_set_modal() on the dialog. Use
the GTK_WINDOW() macro to cast the widget returned from gtk_dialog_new() into a
#GtkWindow. When using gtk_dialog_new_with_buttons() you can also pass the
-GTK_DIALOG_MODAL flag to make a dialog modal.
+#GTK_DIALOG_MODAL flag to make a dialog modal.
</para>
<para>
meaning to positive response IDs; these are entirely user-defined. But for
convenience, you can use the response IDs in the #GtkResponseType enumeration
(these all have values less than zero). If a dialog receives a delete event, the
-"response" signal will be emitted with a response ID of GTK_RESPONSE_NONE.
+"response" signal will be emitted with a response ID of #GTK_RESPONSE_NONE.
</para>
#GtkMessageDialog to save yourself some effort. But you'd need to create the
dialog contents manually if you had more than a simple message in the dialog.
<example>
-<title>Simple #GtkDialog usage.</title>
+<title>Simple <structname>GtkDialog</structname> usage.</title>
<programlisting>
/* Function to open a dialog box displaying the message provided. */
-void quick_message(#gchar *message) {
+void quick_message (gchar *message) {
- #GtkWidget *dialog, *label;
+ GtkWidget *dialog, *label;
/* Create the widgets */
dialog = gtk_dialog_new_with_buttons ("Message",
main_application_window,
GTK_DIALOG_DESTROY_WITH_PARENT,
- GTK_STOCK_BUTTON_OK,
+ GTK_STOCK_OK,
GTK_RESPONSE_NONE,
NULL);
label = gtk_label_new (message);
/* Ensure that the dialog box is destroyed when the user responds. */
- gtk_signal_connect_object (GTK_OBJECT (dialog), "response",
- GTK_SIGNAL_FUNC (gtk_widget_destroy),
- GTK_OBJECT (dialog));
+ g_signal_connect_swapped (GTK_OBJECT (dialog),
+ "response",
+ G_CALLBACK (gtk_widget_destroy),
+ GTK_OBJECT (dialog));
/* Add the label, and show everything we've added to the dialog. */
@GTK_DIALOG_MODAL:
@GTK_DIALOG_DESTROY_WITH_PARENT:
+@GTK_DIALOG_NO_SEPARATOR:
+
+<!-- ##### ENUM GtkResponseType ##### -->
+<para>
+
+</para>
+
+@GTK_RESPONSE_NONE:
+@GTK_RESPONSE_REJECT:
+@GTK_RESPONSE_ACCEPT:
+@GTK_RESPONSE_DELETE_EVENT:
+@GTK_RESPONSE_OK:
+@GTK_RESPONSE_CANCEL:
+@GTK_RESPONSE_CLOSE:
+@GTK_RESPONSE_YES:
+@GTK_RESPONSE_NO:
+@GTK_RESPONSE_APPLY:
+@GTK_RESPONSE_HELP:
<!-- ##### FUNCTION gtk_dialog_new ##### -->
<para>
Creates a new dialog box. Widgets should not be packed into this #GtkWindow
-directly, but into the vbox and action_area, as described above.
+directly, but into the @vbox and @action_area, as described above.
</para>
-@Returns: a #GtkWidget - the newly created dialog box.
+@Returns: a new #GtkDialog.
<!-- ##### FUNCTION gtk_dialog_new_with_buttons ##### -->
@dialog:
@button_text:
@response_id:
+@Returns:
<!-- ##### FUNCTION gtk_dialog_add_buttons ##### -->
@widget:
+<!-- ##### FUNCTION gtk_dialog_get_has_separator ##### -->
+<para>
+
+</para>
+
+@dialog:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_dialog_set_default_response ##### -->
+<para>
+
+</para>
+
+@dialog:
+@response_id:
+
+
+<!-- ##### FUNCTION gtk_dialog_set_has_separator ##### -->
+<para>
+
+</para>
+
+@dialog:
+@setting:
+
+
+<!-- ##### FUNCTION gtk_dialog_set_response_sensitive ##### -->
+<para>
+
+</para>
+
+@dialog:
+@response_id:
+@setting:
+
+
+<!-- ##### SIGNAL GtkDialog::close ##### -->
+<para>
+
+</para>
+
+@dialog: the object which received the signal.
+
<!-- ##### SIGNAL GtkDialog::response ##### -->
<para>
Emitted when an action widget is clicked, the dialog receives a delete event, or
the application programmer calls gtk_dialog_response(). On a delete event, the
-response ID is GTK_RESPONSE_NONE. Otherwise, it depends on which action widget
+response ID is #GTK_RESPONSE_NONE. Otherwise, it depends on which action widget
was clicked.
</para>
@dialog: the object which received the signal.
@arg1: the response ID
+<!-- ##### ARG GtkDialog:has-separator ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkDialog:content-area-border ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkDialog:button-spacing ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkDialog:action-area-border ##### -->
+<para>
+
+</para>
+