gtk:dialog, gtk:window, gtk:bin, gtk:container, gtk:widget, gtk:buildable, gobject:object, common-lisp:standard-object, common-lisp:t

None

The gtk:message-dialog widget presents a dialog with some message text. It is simply a convenience widget. You could construct the equivalent of a message dialog from a gtk:dialog widget without too much effort, but the gtk:message-dialog widget saves typing.


Figure: GtkMessageDialog

One difference from the gtk:dialog widget is that the message dialog sets the skip-taskbar-hint property to true, so that the message dialog is hidden from the taskbar by default.

The easiest way to do a modal message dialog is to use the gtk:dialog-run function, though you can also pass in the :modal flag of type gtk:dialog-flags flags, the gtk:dialog-run function automatically makes the message dialog modal and waits for the user to respond to it. The gtk:dialog-run function returns when any message dialog button is clicked. A modal message dialog.

(let ((dialog (gtk:message-dialog-new main-window
                                      '(:destroy-with-parent)
                                      :error
                                      :close
                                      "Error loading file ~s"
                                      filename)))
  (gtk:dialog-run dialog)
  (gtk:widget-destroy dialog))    

You might do a non-modal message dialog as follows.

(let ((dialog (gtk:message-dialog-new main-window
                                      '(:destroy-with-parent)
                                      :error
                                      :close
                                      "Error loading file ~s"
                                      filename)))
  ;; Destroy the dialog when the user responds to it
  (g:signal-connect dialog "response"
                    (lambda (dialog response-id)
                      (declare (ignore response-id))
                      (gtk:widget-destroy dialog)))
  ... )    

The gtk:message-dialog implementation of the gtk:buildable interface exposes the message area as an internal child with the name message_area.