/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 2 -*- */

/* GTK - The GIMP Toolkit

 * Copyright (C) 2000 Red Hat, Inc.

 *

 * This library is free software; you can redistribute it and/or

 * modify it under the terms of the GNU Library General Public

 * License as published by the Free Software Foundation; either

 * version 2 of the License, or (at your option) any later version.

 *

 * This library is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

 * Library General Public License for more details.

 *

 * You should have received a copy of the GNU Library General Public

 * License along with this library; if not, write to the

 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,

 * Boston, MA 02111-1307, USA.

 */

/*

 * Modified by the GTK+ Team and others 1997-2003.  See the AUTHORS

 * file for a list of people on the GTK+ Team.  See the ChangeLog

 * files for a list of changes.  These files are distributed with

 * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 

 */

#include "config.h"

#include <string.h>

#include "gtkmessagedialog.h"

#include "gtkaccessible.h"

#include "gtkbuildable.h"

#include "gtklabel.h"

#include "gtkhbox.h"

#include "gtkvbox.h"

#include "gtkimage.h"

#include "gtkstock.h"

#include "gtkiconfactory.h"

#include "gtkintl.h"

#include "gtkprivate.h"

#include "gtkalias.h"

/**

 * SECTION:gtkmessagedialog

 * @Short_description: A convenient message window

 * @Title: GtkMessageDialog

 * @See_also:#GtkDialog

 *

 * #GtkMessageDialog presents a dialog with an image representing the type of

 * message (Error, Question, etc.) alongside some message text. It's simply a

 * convenience widget; you could construct the equivalent of #GtkMessageDialog

 * from #GtkDialog without too much effort, but #GtkMessageDialog saves typing.

 *

 * The easiest way to do a modal message dialog is to use gtk_dialog_run(), though

 * you can also pass in the %GTK_DIALOG_MODAL flag, gtk_dialog_run() automatically

 * makes the dialog modal and waits for the user to respond to it. gtk_dialog_run()

 * returns when any dialog button is clicked.

 * <example>

 * <title>A modal dialog.</title>

 * <programlisting>

 *  dialog = gtk_message_dialog_new (main_application_window,

 *                                   GTK_DIALOG_DESTROY_WITH_PARENT,

 *                                   GTK_MESSAGE_ERROR,

 *                                   GTK_BUTTONS_CLOSE,

 *                                   "Error loading file '%s': %s",

 *                                   filename, g_strerror (errno));

 *  gtk_dialog_run (GTK_DIALOG (dialog));

 *  gtk_widget_destroy (dialog);

 * </programlisting>

 * </example>

 * You might do a non-modal #GtkMessageDialog as follows:

 * <example>

 * <title>A non-modal dialog.</title>

 * <programlisting>

 *  dialog = gtk_message_dialog_new (main_application_window,

 *                                   GTK_DIALOG_DESTROY_WITH_PARENT,

 *                                   GTK_MESSAGE_ERROR,

 *                                   GTK_BUTTONS_CLOSE,

 *                                   "Error loading file '%s': %s",

 *                                   filename, g_strerror (errno));

 *

 *  /* Destroy the dialog when the user responds to it (e.g. clicks a button) */

 *  g_signal_connect_swapped (dialog, "response",

 *                            G_CALLBACK (gtk_widget_destroy),

 *                            dialog);

 * </programlisting>

 * </example>

 *

 * <refsect2 id="GtkMessageDialog-BUILDER-UI">

 * <title>GtkMessageDialog as GtkBuildable</title>

 * <para>

 * The GtkMessageDialog implementation of the GtkBuildable interface exposes

 * the message area as an internal child with the name "message_area".

 * </para>

 * </refsect2>

 */

#define GTK_MESSAGE_DIALOG_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_MESSAGE_DIALOG, GtkMessageDialogPrivate))

typedef struct _GtkMessageDialogPrivate GtkMessageDialogPrivate;

struct _GtkMessageDialogPrivate

{

  GtkWidget *message_area; /* vbox for the primary and secondary labels, and any extra content from the caller */

  GtkWidget *secondary_label;

  guint message_type : 3;

  guint has_primary_markup : 1;

  guint has_secondary_text : 1;

};

static void gtk_message_dialog_style_set  (GtkWidget             *widget,

                                           GtkStyle              *prev_style);

static void gtk_message_dialog_set_property (GObject          *object,

					     guint             prop_id,

					     const GValue     *value,

					     GParamSpec       *pspec);

static void gtk_message_dialog_get_property (GObject          *object,

					     guint             prop_id,

					     GValue           *value,

					     GParamSpec       *pspec);

static void gtk_message_dialog_add_buttons  (GtkMessageDialog *message_dialog,

					     GtkButtonsType    buttons);

static void      gtk_message_dialog_buildable_interface_init     (GtkBuildableIface *iface);

static GObject * gtk_message_dialog_buildable_get_internal_child (GtkBuildable  *buildable,

                                                                  GtkBuilder    *builder,

                                                                  const gchar   *childname);

enum {

  PROP_0,

  PROP_MESSAGE_TYPE,

  PROP_BUTTONS,

  PROP_TEXT,

  PROP_USE_MARKUP,

  PROP_SECONDARY_TEXT,

  PROP_SECONDARY_USE_MARKUP,

  PROP_IMAGE,

  PROP_MESSAGE_AREA

};

G_DEFINE_TYPE_WITH_CODE (GtkMessageDialog, gtk_message_dialog, GTK_TYPE_DIALOG,

                         G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,

                                                gtk_message_dialog_buildable_interface_init))

static GtkBuildableIface *parent_buildable_iface;

static void

gtk_message_dialog_buildable_interface_init (GtkBuildableIface *iface)

{

  parent_buildable_iface = g_type_interface_peek_parent (iface);

  iface->get_internal_child = gtk_message_dialog_buildable_get_internal_child;

  iface->custom_tag_start = parent_buildable_iface->custom_tag_start;

  iface->custom_finished = parent_buildable_iface->custom_finished;

}

static GObject *

gtk_message_dialog_buildable_get_internal_child (GtkBuildable *buildable,

                                                 GtkBuilder   *builder,

                                                 const gchar  *childname)

{

  if (strcmp (childname, "message_area") == 0)

    return G_OBJECT (gtk_message_dialog_get_message_area (GTK_MESSAGE_DIALOG (buildable)));

  return parent_buildable_iface->get_internal_child (buildable, builder, childname);

}

static void

gtk_message_dialog_class_init (GtkMessageDialogClass *class)

{

  GtkWidgetClass *widget_class;

  GObjectClass *gobject_class;

  widget_class = GTK_WIDGET_CLASS (class);

  gobject_class = G_OBJECT_CLASS (class);

  widget_class->style_set = gtk_message_dialog_style_set;

  gobject_class->set_property = gtk_message_dialog_set_property;

  gobject_class->get_property = gtk_message_dialog_get_property;

  gtk_widget_class_install_style_property (widget_class,

					   g_param_spec_int ("message-border",

                                                             P_("Image/label border"),

                                                             P_("Width of border around the label and image in the message dialog"),

                                                             0,

                                                             G_MAXINT,

                                                             12,

                                                             GTK_PARAM_READABLE));

  /**

   * GtkMessageDialog:use-separator:

   *

   * Whether to draw a separator line between the message label and the buttons

   * in the dialog.

   *

   * Since: 2.4

   *

   * Deprecated: 2.22: This style property will be removed in GTK+ 3

   */

  gtk_widget_class_install_style_property (widget_class,

					   g_param_spec_boolean ("use-separator",

								 P_("Use separator"),

								 P_("Whether to put a separator between the message dialog's text and the buttons"),

								 FALSE,

								 GTK_PARAM_READABLE));

  /**

   * GtkMessageDialog:message-type:

   *

   * The type of the message. The type is used to determine

   * the image that is shown in the dialog, unless the image is 

   * explicitly set by the ::image property.

   */

  g_object_class_install_property (gobject_class,

                                   PROP_MESSAGE_TYPE,

                                   g_param_spec_enum ("message-type",

						      P_("Message Type"),

						      P_("The type of message"),

						      GTK_TYPE_MESSAGE_TYPE,

                                                      GTK_MESSAGE_INFO,

                                                      GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT));

  g_object_class_install_property (gobject_class,

                                   PROP_BUTTONS,

                                   g_param_spec_enum ("buttons",

						      P_("Message Buttons"),

						      P_("The buttons shown in the message dialog"),

						      GTK_TYPE_BUTTONS_TYPE,

                                                      GTK_BUTTONS_NONE,

                                                      GTK_PARAM_WRITABLE | G_PARAM_CONSTRUCT_ONLY));

  /**

   * GtkMessageDialog:text:

   * 

   * The primary text of the message dialog. If the dialog has 

   * a secondary text, this will appear as the title.

   *

   * Since: 2.10

   */

  g_object_class_install_property (gobject_class,

                                   PROP_TEXT,

                                   g_param_spec_string ("text",

                                                        P_("Text"),

                                                        P_("The primary text of the message dialog"),

                                                        "",

                                                        GTK_PARAM_READWRITE));

  /**

   * GtkMessageDialog:use-markup:

   * 

   * %TRUE if the primary text of the dialog includes Pango markup. 

   * See pango_parse_markup(). 

   *

   * Since: 2.10

   */

  g_object_class_install_property (gobject_class,

				   PROP_USE_MARKUP,

				   g_param_spec_boolean ("use-markup",

							 P_("Use Markup"),

							 P_("The primary text of the title includes Pango markup."),

							 FALSE,

							 GTK_PARAM_READWRITE));

  /**

   * GtkMessageDialog:secondary-text:

   * 

   * The secondary text of the message dialog. 

   *

   * Since: 2.10

   */

  g_object_class_install_property (gobject_class,

                                   PROP_SECONDARY_TEXT,

                                   g_param_spec_string ("secondary-text",

                                                        P_("Secondary Text"),

                                                        P_("The secondary text of the message dialog"),

                                                        NULL,

                                                        GTK_PARAM_READWRITE));

  /**

   * GtkMessageDialog:secondary-use-markup:

   * 

   * %TRUE if the secondary text of the dialog includes Pango markup. 

   * See pango_parse_markup(). 

   *

   * Since: 2.10

   */

  g_object_class_install_property (gobject_class,

				   PROP_SECONDARY_USE_MARKUP,

				   g_param_spec_boolean ("secondary-use-markup",

							 P_("Use Markup in secondary"),

							 P_("The secondary text includes Pango markup."),

							 FALSE,

							 GTK_PARAM_READWRITE));

  /**

   * GtkMessageDialog:image:

   * 

   * The image for this dialog.

   *

   * Since: 2.10

   */

  g_object_class_install_property (gobject_class,

                                   PROP_IMAGE,

                                   g_param_spec_object ("image",

                                                        P_("Image"),

                                                        P_("The image"),

                                                        GTK_TYPE_WIDGET,

                                                        GTK_PARAM_READWRITE));

  /**

   * GtkMessageDialog:message-area

   *

   * The #GtkVBox that corresponds to the message area of this dialog.  See

   * gtk_message_dialog_get_message_area() for a detailed description of this

   * area.

   *

   * Since: 2.22

   */

  g_object_class_install_property (gobject_class,

				   PROP_MESSAGE_AREA,

				   g_param_spec_object ("message-area",

							P_("Message area"),

							P_("GtkVBox that holds the dialog's primary and secondary labels"),

							GTK_TYPE_WIDGET,

							GTK_PARAM_READABLE));

  g_type_class_add_private (gobject_class,

			    sizeof (GtkMessageDialogPrivate));

}

static void

gtk_message_dialog_init (GtkMessageDialog *dialog)

{

  GtkWidget *hbox;

  GtkMessageDialogPrivate *priv;

  priv = GTK_MESSAGE_DIALOG_GET_PRIVATE (dialog);

  gtk_window_set_resizable (GTK_WINDOW (dialog), FALSE);

  gtk_window_set_title (GTK_WINDOW (dialog), "");

  gtk_window_set_skip_taskbar_hint (GTK_WINDOW (dialog), TRUE);

  priv->has_primary_markup = FALSE;

  priv->has_secondary_text = FALSE;

  priv->secondary_label = gtk_label_new (NULL);

  gtk_widget_set_no_show_all (priv->secondary_label, TRUE);

  dialog->label = gtk_label_new (NULL);

  dialog->image = gtk_image_new_from_stock (NULL, GTK_ICON_SIZE_DIALOG);

  gtk_misc_set_alignment (GTK_MISC (dialog->image), 0.5, 0.0);

  gtk_label_set_line_wrap  (GTK_LABEL (dialog->label), TRUE);

  gtk_label_set_selectable (GTK_LABEL (dialog->label), TRUE);

  gtk_misc_set_alignment   (GTK_MISC  (dialog->label), 0.0, 0.0);

  gtk_label_set_line_wrap  (GTK_LABEL (priv->secondary_label), TRUE);

  gtk_label_set_selectable (GTK_LABEL (priv->secondary_label), TRUE);

  gtk_misc_set_alignment   (GTK_MISC  (priv->secondary_label), 0.0, 0.0);

  hbox = gtk_hbox_new (FALSE, 12);

  priv->message_area = gtk_vbox_new (FALSE, 12);

  gtk_box_pack_start (GTK_BOX (priv->message_area), dialog->label,

                      FALSE, FALSE, 0);

  gtk_box_pack_start (GTK_BOX (priv->message_area), priv->secondary_label,

                      TRUE, TRUE, 0);

  gtk_box_pack_start (GTK_BOX (hbox), dialog->image,

                      FALSE, FALSE, 0);

  gtk_box_pack_start (GTK_BOX (hbox), priv->message_area,

                      TRUE, TRUE, 0);

  gtk_box_pack_start (GTK_BOX (GTK_DIALOG (dialog)->vbox),

                      hbox,

                      FALSE, FALSE, 0);

  gtk_container_set_border_width (GTK_CONTAINER (dialog), 5);

  gtk_container_set_border_width (GTK_CONTAINER (hbox), 5);

  gtk_box_set_spacing (GTK_BOX (GTK_DIALOG (dialog)->vbox), 14); /* 14 + 2 * 5 = 24 */

  gtk_container_set_border_width (GTK_CONTAINER (GTK_DIALOG (dialog)->action_area), 5);

  gtk_box_set_spacing (GTK_BOX (GTK_DIALOG (dialog)->action_area), 6);

  gtk_widget_show_all (hbox);

  _gtk_dialog_set_ignore_separator (GTK_DIALOG (dialog), TRUE);

}

static void

setup_primary_label_font (GtkMessageDialog *dialog)

{

  gint size;

  PangoFontDescription *font_desc;

  GtkMessageDialogPrivate *priv;

  priv = GTK_MESSAGE_DIALOG_GET_PRIVATE (dialog);

  /* unset the font settings */

  gtk_widget_modify_font (dialog->label, NULL);

  if (priv->has_secondary_text && !priv->has_primary_markup)

    {

      size = pango_font_description_get_size (dialog->label->style->font_desc);

      font_desc = pango_font_description_new ();

      pango_font_description_set_weight (font_desc, PANGO_WEIGHT_BOLD);

      pango_font_description_set_size (font_desc, size * PANGO_SCALE_LARGE);

      gtk_widget_modify_font (dialog->label, font_desc);

      pango_font_description_free (font_desc);

    }

}

static void

setup_type (GtkMessageDialog *dialog,

	    GtkMessageType    type)

{

  GtkMessageDialogPrivate *priv = GTK_MESSAGE_DIALOG_GET_PRIVATE (dialog);

  const gchar *stock_id = NULL;

  AtkObject *atk_obj;

  priv->message_type = type;

  switch (type)

    {

    case GTK_MESSAGE_INFO:

      stock_id = GTK_STOCK_DIALOG_INFO;

      break;

    case GTK_MESSAGE_QUESTION:

      stock_id = GTK_STOCK_DIALOG_QUESTION;

      break;

    case GTK_MESSAGE_WARNING:

      stock_id = GTK_STOCK_DIALOG_WARNING;

      break;

    case GTK_MESSAGE_ERROR:

      stock_id = GTK_STOCK_DIALOG_ERROR;

      break;

    case GTK_MESSAGE_OTHER:

      break;

    default:

      g_warning ("Unknown GtkMessageType %u", type);

      break;

    }

  if (stock_id)

    gtk_image_set_from_stock (GTK_IMAGE (dialog->image), stock_id,

                              GTK_ICON_SIZE_DIALOG);

  atk_obj = gtk_widget_get_accessible (GTK_WIDGET (dialog));

  if (GTK_IS_ACCESSIBLE (atk_obj))

    {

      atk_object_set_role (atk_obj, ATK_ROLE_ALERT);

      if (stock_id)

        {

          GtkStockItem item;

          gtk_stock_lookup (stock_id, &item);

          atk_object_set_name (atk_obj, item.label);

        }

    }

}

static void 

gtk_message_dialog_set_property (GObject      *object,

				 guint         prop_id,

				 const GValue *value,

				 GParamSpec   *pspec)

{

  GtkMessageDialog *dialog;

  GtkMessageDialogPrivate *priv;

  dialog = GTK_MESSAGE_DIALOG (object);

  priv = GTK_MESSAGE_DIALOG_GET_PRIVATE (dialog);

  switch (prop_id)

    {

    case PROP_MESSAGE_TYPE:

      setup_type (dialog, g_value_get_enum (value));

      break;

    case PROP_BUTTONS:

      gtk_message_dialog_add_buttons (dialog, g_value_get_enum (value));

      break;

    case PROP_TEXT:

      if (priv->has_primary_markup)

	gtk_label_set_markup (GTK_LABEL (dialog->label), 

			      g_value_get_string (value));

      else

	gtk_label_set_text (GTK_LABEL (dialog->label), 

			    g_value_get_string (value));

      break;

    case PROP_USE_MARKUP:

      priv->has_primary_markup = g_value_get_boolean (value) != FALSE;

      gtk_label_set_use_markup (GTK_LABEL (dialog->label), 

				priv->has_primary_markup);

      setup_primary_label_font (dialog);

      break;

    case PROP_SECONDARY_TEXT:

      {

	const gchar *txt = g_value_get_string (value);

	if (gtk_label_get_use_markup (GTK_LABEL (priv->secondary_label)))

	  gtk_label_set_markup (GTK_LABEL (priv->secondary_label), txt);

	else

	  gtk_label_set_text (GTK_LABEL (priv->secondary_label), txt);

	if (txt)

	  {

	    priv->has_secondary_text = TRUE;

	    gtk_widget_show (priv->secondary_label);

	  }

	else

	  {

	    priv->has_secondary_text = FALSE;

	    gtk_widget_hide (priv->secondary_label);

	  }

	setup_primary_label_font (dialog);

      }

      break;

    case PROP_SECONDARY_USE_MARKUP:

      gtk_label_set_use_markup (GTK_LABEL (priv->secondary_label), 

				g_value_get_boolean (value));

      break;

    case PROP_IMAGE:

      gtk_message_dialog_set_image (dialog, g_value_get_object (value));

      break;

    default:

      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);

      break;

    }

}

static void 

gtk_message_dialog_get_property (GObject     *object,

				 guint        prop_id,

				 GValue      *value,

				 GParamSpec  *pspec)

{

  GtkMessageDialog *dialog;

  GtkMessageDialogPrivate *priv;

  dialog = GTK_MESSAGE_DIALOG (object);

  priv = GTK_MESSAGE_DIALOG_GET_PRIVATE (dialog);

  switch (prop_id)

    {

    case PROP_MESSAGE_TYPE:

      g_value_set_enum (value, (GtkMessageType) priv->message_type);

      break;

    case PROP_TEXT:

      g_value_set_string (value, gtk_label_get_label (GTK_LABEL (dialog->label)));

      break;

    case PROP_USE_MARKUP:

      g_value_set_boolean (value, priv->has_primary_markup);

      break;

    case PROP_SECONDARY_TEXT:

      if (priv->has_secondary_text)

      g_value_set_string (value, 

			  gtk_label_get_label (GTK_LABEL (priv->secondary_label)));

      else

	g_value_set_string (value, NULL);

      break;

    case PROP_SECONDARY_USE_MARKUP:

      if (priv->has_secondary_text)

	g_value_set_boolean (value, 

			     gtk_label_get_use_markup (GTK_LABEL (priv->secondary_label)));

      else

	g_value_set_boolean (value, FALSE);

      break;

    case PROP_IMAGE:

      g_value_set_object (value, dialog->image);

      break;

    case PROP_MESSAGE_AREA:

      g_value_set_object (value, priv->message_area);

      break;

    default:

      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);

      break;

    }

}

/**

 * gtk_message_dialog_new:

 * @parent: (allow-none): transient parent, or %NULL for none

 * @flags: flags

 * @type: type of message

 * @buttons: set of buttons to use

 * @message_format: (allow-none): printf()-style format string, or %NULL

 * @Varargs: arguments for @message_format

 *

 * Creates a new message dialog, which is a simple dialog with an icon

 * indicating the dialog type (error, warning, etc.) and some text the

 * user may want to see. When the user clicks a button a "response"

 * signal is emitted with response IDs from #GtkResponseType. See

 * #GtkDialog for more details.

 *

 * Return value: (transfer none): a new #GtkMessageDialog

 **/

GtkWidget*

gtk_message_dialog_new (GtkWindow     *parent,

                        GtkDialogFlags flags,

                        GtkMessageType type,

                        GtkButtonsType buttons,

                        const gchar   *message_format,

                        ...)

{

  GtkWidget *widget;

  GtkDialog *dialog;

  gchar* msg = NULL;

  va_list args;

  g_return_val_if_fail (parent == NULL || GTK_IS_WINDOW (parent), NULL);

  widget = g_object_new (GTK_TYPE_MESSAGE_DIALOG,

			 "message-type", type,

			 "buttons", buttons,

			 NULL);

  dialog = GTK_DIALOG (widget);

  if (flags & GTK_DIALOG_NO_SEPARATOR)

    {

      g_warning ("The GTK_DIALOG_NO_SEPARATOR flag cannot be used for GtkMessageDialog");

      flags &= ~GTK_DIALOG_NO_SEPARATOR;

    }

  if (message_format)

    {

      va_start (args, message_format);

      msg = g_strdup_vprintf (message_format, args);

      va_end (args);

      gtk_label_set_text (GTK_LABEL (GTK_MESSAGE_DIALOG (widget)->label),

                          msg);

      g_free (msg);

    }

  if (parent != NULL)

    gtk_window_set_transient_for (GTK_WINDOW (widget),

                                  GTK_WINDOW (parent));

  if (flags & GTK_DIALOG_MODAL)

    gtk_window_set_modal (GTK_WINDOW (dialog), TRUE);

  if (flags & GTK_DIALOG_DESTROY_WITH_PARENT)

    gtk_window_set_destroy_with_parent (GTK_WINDOW (dialog), TRUE);

  return widget;

}

/**

 * gtk_message_dialog_new_with_markup:

 * @parent: (allow-none): transient parent, or %NULL for none 

 * @flags: flags

 * @type: type of message

 * @buttons: set of buttons to use

 * @message_format: (allow-none): printf()-style format string, or %NULL

 * @Varargs: arguments for @message_format

 * 

 * Creates a new message dialog, which is a simple dialog with an icon

 * indicating the dialog type (error, warning, etc.) and some text which

 * is marked up with the <link linkend="PangoMarkupFormat">Pango text markup language</link>.

 * When the user clicks a button a "response" signal is emitted with

 * response IDs from #GtkResponseType. See #GtkDialog for more details.

 *

 * Special XML characters in the printf() arguments passed to this

 * function will automatically be escaped as necessary.

 * (See g_markup_printf_escaped() for how this is implemented.)

 * Usually this is what you want, but if you have an existing

 * Pango markup string that you want to use literally as the

 * label, then you need to use gtk_message_dialog_set_markup()

 * instead, since you can't pass the markup string either

 * as the format (it might contain '%' characters) or as a string

 * argument.

 * |[

 *  GtkWidget *dialog;

 *  dialog = gtk_message_dialog_new (main_application_window,

 *                                   GTK_DIALOG_DESTROY_WITH_PARENT,

 *                                   GTK_MESSAGE_ERROR,

 *                                   GTK_BUTTONS_CLOSE,

 *                                   NULL);

 *  gtk_message_dialog_set_markup (GTK_MESSAGE_DIALOG (dialog),

 *                                 markup);

 * ]|

 * 

 * Return value: a new #GtkMessageDialog

 *

 * Since: 2.4

 **/

GtkWidget*

gtk_message_dialog_new_with_markup (GtkWindow     *parent,

                                    GtkDialogFlags flags,

                                    GtkMessageType type,

                                    GtkButtonsType buttons,

                                    const gchar   *message_format,

                                    ...)

{

  GtkWidget *widget;

  va_list args;

  gchar *msg = NULL;

  g_return_val_if_fail (parent == NULL || GTK_IS_WINDOW (parent), NULL);

  widget = gtk_message_dialog_new (parent, flags, type, buttons, NULL);

  if (message_format)

    {

      va_start (args, message_format);

      msg = g_markup_vprintf_escaped (message_format, args);

      va_end (args);

      gtk_message_dialog_set_markup (GTK_MESSAGE_DIALOG (widget), msg);

      g_free (msg);

    }

  return widget;

}

/**

 * gtk_message_dialog_set_image:

 * @dialog: a #GtkMessageDialog

 * @image: the image

 * 

 * Sets the dialog's image to @image.

 *

 * Since: 2.10

 **/

void

gtk_message_dialog_set_image (GtkMessageDialog *dialog,

			      GtkWidget        *image)

{

  GtkMessageDialogPrivate *priv;

  GtkWidget *parent;

  g_return_if_fail (GTK_IS_MESSAGE_DIALOG (dialog));

  g_return_if_fail (image == NULL || GTK_IS_WIDGET (image));

  if (image == NULL)

    {

      image = gtk_image_new_from_stock (NULL, GTK_ICON_SIZE_DIALOG);

      gtk_misc_set_alignment (GTK_MISC (image), 0.5, 0.0);

    }

  priv = GTK_MESSAGE_DIALOG_GET_PRIVATE (dialog);

  priv->message_type = GTK_MESSAGE_OTHER;

  parent = dialog->image->parent;

  gtk_container_add (GTK_CONTAINER (parent), image);

  gtk_container_remove (GTK_CONTAINER (parent), dialog->image);

  gtk_box_reorder_child (GTK_BOX (parent), image, 0);

  dialog->image = image;

  g_object_notify (G_OBJECT (dialog), "image");

}

/**

 * gtk_message_dialog_get_image:

 * @dialog: a #GtkMessageDialog

 *

 * Gets the dialog's image.

 *

 * Return value: (transfer none): the dialog's image

 *

 * Since: 2.14

 **/

GtkWidget *

gtk_message_dialog_get_image (GtkMessageDialog *dialog)

{

  g_return_val_if_fail (GTK_IS_MESSAGE_DIALOG (dialog), NULL);

  return dialog->image;

}

/**

 * gtk_message_dialog_set_markup:

 * @message_dialog: a #GtkMessageDialog

 * @str: markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>)

 * 

 * Sets the text of the message dialog to be @str, which is marked

 * up with the <link linkend="PangoMarkupFormat">Pango text markup

 * language</link>.

 *

 * Since: 2.4

 **/

void

gtk_message_dialog_set_markup (GtkMessageDialog *message_dialog,

                               const gchar      *str)

{

  GtkMessageDialogPrivate *priv;

  g_return_if_fail (GTK_IS_MESSAGE_DIALOG (message_dialog));

  priv = GTK_MESSAGE_DIALOG_GET_PRIVATE (message_dialog);

  priv->has_primary_markup = TRUE;

  gtk_label_set_markup (GTK_LABEL (message_dialog->label), str);

}

/**

 * gtk_message_dialog_format_secondary_text:

 * @message_dialog: a #GtkMessageDialog

 * @message_format: (allow-none): printf()-style format string, or %NULL

 * @Varargs: arguments for @message_format

 * 

 * Sets the secondary text of the message dialog to be @message_format 

 * (with printf()-style).

 *

 * Note that setting a secondary text makes the primary text become

 * bold, unless you have provided explicit markup.

 *

 * Since: 2.6

 **/

void

gtk_message_dialog_format_secondary_text (GtkMessageDialog *message_dialog,

                                          const gchar      *message_format,

                                          ...)

{

  va_list args;

  gchar *msg = NULL;

  GtkMessageDialogPrivate *priv;

  g_return_if_fail (GTK_IS_MESSAGE_DIALOG (message_dialog));

  priv = GTK_MESSAGE_DIALOG_GET_PRIVATE (message_dialog);

  if (message_format)

    {

      priv->has_secondary_text = TRUE;

      va_start (args, message_format);

      msg = g_strdup_vprintf (message_format, args);

      va_end (args);

      gtk_widget_show (priv->secondary_label);

      gtk_label_set_text (GTK_LABEL (priv->secondary_label), msg);

      g_free (msg);

    }

  else

    {

      priv->has_secondary_text = FALSE;

      gtk_widget_hide (priv->secondary_label);

    }

  setup_primary_label_font (message_dialog);

}

/**

 * gtk_message_dialog_format_secondary_markup:

 * @message_dialog: a #GtkMessageDialog

 * @message_format: printf()-style markup string (see 

     <link linkend="PangoMarkupFormat">Pango markup format</link>), or %NULL

 * @Varargs: arguments for @message_format

 * 

 * Sets the secondary text of the message dialog to be @message_format (with 

 * printf()-style), which is marked up with the 

 * <link linkend="PangoMarkupFormat">Pango text markup language</link>.

 *

 * Note that setting a secondary text makes the primary text become

 * bold, unless you have provided explicit markup.

 *

 * Due to an oversight, this function does not escape special XML characters

 * like gtk_message_dialog_new_with_markup() does. Thus, if the arguments 

 * may contain special XML characters, you should use g_markup_printf_escaped()

 * to escape it.

 * <informalexample><programlisting>

 * gchar *msg;

 *  

 * msg = g_markup_printf_escaped (message_format, ...);

 * gtk_message_dialog_format_secondary_markup (message_dialog, "%s", msg);

 * g_free (msg);

 * </programlisting></informalexample>

 *