GtkDialog
<!-- ##### SECTION Short_Description ##### -->
-
-create popup windows.
+Create popup windows
<!-- ##### SECTION Long_Description ##### -->
<para>
Dialog boxes are a convenient way to prompt the user for a small amount of
-input, eg. to display a message, ask a question, or anything else that does not
-require extensive effort on the user's part.
+input, e.g. to display a message, ask a question, or anything else that does
+not require extensive effort on the user's part.
</para>
<para>
<para>
If 'dialog' is a newly created dialog, the two primary areas of the window
-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.
+can be accessed through gtk_dialog_get_content_area() and
+gtk_dialog_get_action_area(), as can be seen from the example, below.
</para>
<para>
"response" with a response ID that you specified. GTK+ will never assign a
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.
+(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_DELETE_EVENT.
</para>
void quick_message (gchar *message) {
- GtkWidget *dialog, *label;
+ GtkWidget *dialog, *label, *content_area;
/* Create the widgets */
GTK_STOCK_OK,
GTK_RESPONSE_NONE,
NULL);
+ content_area = gtk_dialog_get_content_area (GTK_DIALOG (dialog));
label = gtk_label_new (message);
/* Ensure that the dialog box is destroyed when the user responds. */
- g_signal_connect_swapped (GTK_OBJECT (dialog),
+ g_signal_connect_swapped (dialog,
"response",
G_CALLBACK (gtk_widget_destroy),
- GTK_OBJECT (dialog));
+ dialog);
/* Add the label, and show everything we've added to the dialog. */
- gtk_container_add (GTK_CONTAINER (GTK_DIALOG(dialog)->vbox),
- label);
+ gtk_container_add (GTK_CONTAINER (content_area), label);
gtk_widget_show_all (dialog);
}
</example>
</para>
+<refsect2 id="GtkDialog-BUILDER-UI"><title>GtkDialog as GtkBuildable</title>
+<para>
+The GtkDialog implementation of the GtkBuildable interface exposes the
+@vbox and @action_area as internal children with the names "vbox" and
+"action_area".
+</para>
+<para>
+GtkDialog supports a custom <action-widgets> element, which
+can contain multiple <action-widget> elements. The "response"
+attribute specifies a numeric response, and the content of the element
+is the id of widget (which should be a child of the dialogs @action_area).
+</para>
+<example>
+<title>A <structname>GtkDialog</structname> UI definition fragment.</title>
+<programlisting><![CDATA[
+<object class="GtkDialog" id="dialog1">
+ <child internal-child="vbox">"
+ <object class="GtkVBox" id="vbox">
+ <child internal-child="action_area">
+ <object class="GtkHButtonBox" id="button_box">
+ <child>
+ <object class="GtkButton" id="button_cancel"/>
+ </child>
+ <child>
+ <object class="GtkButton" id="button_ok"/>
+ </child>
+ </object>
+ </child>
+ </object>
+ </child>
+ <action-widgets>
+ <action-widget response="3">button_ok</action-widget>
+ <action-widget response="-5">button_cancel</action-widget>
+ </action-widgets>
+</object>
+]]></programlisting>
+</example>
+</refsect2>
+
<!-- ##### SECTION See_Also ##### -->
<para>
</variablelist>
</para>
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
<!-- ##### STRUCT GtkDialog ##### -->
<para>
<structfield>vbox</structfield> is a #GtkVBox - the main part of the
as any other #GtkHButtonBox.
</para>
-@vbox:
-@action_area:
-<!-- ##### ENUM GtkDialogFlags ##### -->
+<!-- ##### SIGNAL GtkDialog::close ##### -->
<para>
</para>
-@GTK_DIALOG_MODAL:
-@GTK_DIALOG_DESTROY_WITH_PARENT:
-@GTK_DIALOG_NO_SEPARATOR:
+@dialog: the object which received the signal.
-<!-- ##### ENUM GtkResponseType ##### -->
+<!-- ##### SIGNAL GtkDialog::response ##### -->
+<para>
+
+</para>
+
+@dialog:
+@arg1:
+
+<!-- ##### ARG GtkDialog:has-separator ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkDialog:action-area-border ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkDialog:button-spacing ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkDialog:content-area-border ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkDialog:content-area-spacing ##### -->
+<para>
+
+</para>
+
+<!-- ##### ENUM GtkDialogFlags ##### -->
<para>
+Flags used to influence dialog construction.
+</para>
+@GTK_DIALOG_MODAL: Make the constructed dialog modal,
+ see gtk_window_set_modal().
+@GTK_DIALOG_DESTROY_WITH_PARENT: Destroy the dialog when its
+ parent is destroyed, see gtk_window_set_destroy_with_parent().
+@GTK_DIALOG_NO_SEPARATOR: Don't put a separator between the
+ action area and the dialog content.
+
+<!-- ##### ENUM GtkResponseType ##### -->
+<para>
+Predefined values for use as response ids in gtk_dialog_add_button().
+All predefined values are negative, GTK+ leaves positive values for
+application-defined response ids.
</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:
+@GTK_RESPONSE_NONE: Returned if an action widget has no response id, or if
+ the dialog gets programmatically hidden or destroyed.
+@GTK_RESPONSE_REJECT: Generic response id, not used by GTK+ dialogs.
+@GTK_RESPONSE_ACCEPT: Generic response id, not used by GTK+ dialogs.
+@GTK_RESPONSE_DELETE_EVENT: Returned if the dialog is deleted.
+@GTK_RESPONSE_OK: Returned by OK buttons in GTK+ dialogs.
+@GTK_RESPONSE_CANCEL: Returned by Cancel buttons in GTK+ dialogs.
+@GTK_RESPONSE_CLOSE: Returned by Close buttons in GTK+ dialogs.
+@GTK_RESPONSE_YES: Returned by Yes buttons in GTK+ dialogs.
+@GTK_RESPONSE_NO: Returned by No buttons in GTK+ dialogs.
+@GTK_RESPONSE_APPLY: Returned by Apply buttons in GTK+ dialogs.
+@GTK_RESPONSE_HELP: Returned by Help buttons in GTK+ dialogs.
<!-- ##### FUNCTION gtk_dialog_new ##### -->
<para>
directly, but into the @vbox and @action_area, as described above.
</para>
+@void:
@Returns: a new #GtkDialog.
@dialog:
@child:
@response_id:
-<!-- # Unused Parameters # -->
-@widget:
<!-- ##### FUNCTION gtk_dialog_get_has_separator ##### -->
@setting:
-<!-- ##### SIGNAL GtkDialog::close ##### -->
+<!-- ##### FUNCTION gtk_dialog_get_response_for_widget ##### -->
<para>
</para>
-@dialog: the object which received the signal.
+@dialog:
+@widget:
+@Returns:
-<!-- ##### SIGNAL GtkDialog::response ##### -->
+
+<!-- ##### FUNCTION gtk_dialog_get_widget_for_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
-was clicked.
+
</para>
-@dialog: the object which received the signal.
-@arg1: the response ID
+@dialog:
+@response_id:
+@Returns:
-<!-- ##### ARG GtkDialog:has-separator ##### -->
+
+<!-- ##### FUNCTION gtk_dialog_get_action_area ##### -->
<para>
</para>
-<!-- ##### ARG GtkDialog:action-area-border ##### -->
+@dialog:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_dialog_get_content_area ##### -->
<para>
</para>
-<!-- ##### ARG GtkDialog:button-spacing ##### -->
+@dialog:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_alternative_dialog_button_order ##### -->
<para>
</para>
-<!-- ##### ARG GtkDialog:content-area-border ##### -->
+@screen:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_dialog_set_alternative_button_order ##### -->
<para>
</para>
+@dialog:
+@first_response_id:
+@Varargs:
+
+
+<!-- ##### FUNCTION gtk_dialog_set_alternative_button_order_from_array ##### -->
+<para>
+
+</para>
+
+@dialog:
+@n_params:
+@new_order:
+
+