Package org.gnome.adw

Class MessageDialog

java.lang.Object
io.github.jwharm.javagi.base.ProxyInstance
org.gnome.gobject.TypeInstance
org.gnome.gobject.GObject
org.gnome.gobject.InitiallyUnowned
org.gnome.gtk.Widget
org.gnome.gtk.Window
org.gnome.adw.MessageDialog
All Implemented Interfaces:
Proxy, Accessible, Buildable, ConstraintTarget, Native, Root, ShortcutManager
@Generated("io.github.jwharm.JavaGI") @Deprecated public class MessageDialog extends Window implements Accessible, Buildable, ConstraintTarget, Native, Root, ShortcutManager
Deprecated.
A dialog presenting a message or a question.

message-dialog

Message dialogs have a heading, a body, an optional child widget, and one or multiple responses, each presented as a button.

Each response has a unique string ID, and a button label. Additionally, each response can be enabled or disabled, and can have a suggested or destructive appearance.

When one of the responses is activated, or the dialog is closed, the MessageDialog::response signal will be emitted. This signal is detailed, and the detail, as well as the response parameter will be set to the ID of the activated response, or to the value of the MessageDialog:close-response property if the dialog had been closed without activating any of the responses.

Response buttons can be presented horizontally or vertically depending on available space.

When a response is activated, AdwMessageDialog is closed automatically.

An example of using a message dialog: 

GtkWidget *dialog;

 dialog = adw_message_dialog_new (parent, _("Replace File?"), NULL);

 adw_message_dialog_format_body (ADW_MESSAGE_DIALOG (dialog),
                                 _("A file named “%s” already exists. Do you want to replace it?"),
                                 filename);

 adw_message_dialog_add_responses (ADW_MESSAGE_DIALOG (dialog),
                                   "cancel",  _("_Cancel"),
                                   "replace", _("_Replace"),
                                   NULL);

 adw_message_dialog_set_response_appearance (ADW_MESSAGE_DIALOG (dialog), "replace", ADW_RESPONSE_DESTRUCTIVE);

 adw_message_dialog_set_default_response (ADW_MESSAGE_DIALOG (dialog), "cancel");
 adw_message_dialog_set_close_response (ADW_MESSAGE_DIALOG (dialog), "cancel");

 g_signal_connect (dialog, "response", G_CALLBACK (response_cb), self);

 gtk_window_present (GTK_WINDOW (dialog));

Async API
AdwMessageDialog can also be used via the choose(org.gnome.gio.Cancellable, org.gnome.gio.AsyncReadyCallback) method. This API follows the GIO async pattern, for example: 

static void
 dialog_cb (AdwMessageDialog *dialog,
            GAsyncResult     *result,
            MyWindow         *self)
 {
   const char *response = adw_message_dialog_choose_finish (dialog, result);

   // ...
 }

 static void
 show_dialog (MyWindow *self)
 {
   GtkWidget *dialog;

   dialog = adw_message_dialog_new (GTK_WINDOW (self), _("Replace File?"), NULL);

   adw_message_dialog_format_body (ADW_MESSAGE_DIALOG (dialog),
                                   _("A file named “%s” already exists. Do you want to replace it?"),
                                   filename);

   adw_message_dialog_add_responses (ADW_MESSAGE_DIALOG (dialog),
                                     "cancel",  _("_Cancel"),
                                     "replace", _("_Replace"),
                                     NULL);

   adw_message_dialog_set_response_appearance (ADW_MESSAGE_DIALOG (dialog), "replace", ADW_RESPONSE_DESTRUCTIVE);

   adw_message_dialog_set_default_response (ADW_MESSAGE_DIALOG (dialog), "cancel");
   adw_message_dialog_set_close_response (ADW_MESSAGE_DIALOG (dialog), "cancel");

   adw_message_dialog_choose (ADW_MESSAGE_DIALOG (dialog), NULL, (GAsyncReadyCallback) dialog_cb, self);
 }

AdwMessageDialog as GtkBuildable
AdwMessageDialog supports adding responses in UI definitions by via the <responses> element that may contain multiple <response> elements, each representing a response.

Each of the <response> elements must have the id attribute specifying the response ID. The contents of the element are used as the response label.

Response labels can be translated with the usual translatable, context and comments attributes.

The <response> elements can also have enabled and/or appearance attributes. See setResponseEnabled(java.lang.String, boolean) and setResponseAppearance(java.lang.String, org.gnome.adw.ResponseAppearance) for details.

Example of an AdwMessageDialog UI definition: 

<object class="AdwMessageDialog" id="dialog">
   <property name="heading" translatable="yes">Save Changes?</property>
   <property name="body" translatable="yes">Open documents contain unsaved changes. Changes which are not saved will be permanently lost.</property>
   <property name="default-response">save</property>
   <property name="close-response">cancel</property>
   <signal name="response" handler="response_cb"/>
   <responses>
     <response id="cancel" translatable="yes">_Cancel</response>
     <response id="discard" translatable="yes" appearance="destructive">_Discard</response>
     <response id="save" translatable="yes" appearance="suggested" enabled="false">_Save</response>
   </responses>
 </object>

Accessibility
AdwMessageDialog uses the GTK_ACCESSIBLE_ROLE_DIALOG role.