X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gtk%2Fgtkmessagedialog.c;h=709fcfef0c86cf9710d6bf328bda3e0f398e24e0;hb=bda5987335b8c7828ebf1d289a91accfe2e74dbe;hp=ca5ad21c74f90b01486dec3dc2785f4bc373c83b;hpb=cca8dd63475ab582d8592039f1f69d7f22a3b928;p=~andy%2Fgtk diff --git a/gtk/gtkmessagedialog.c b/gtk/gtkmessagedialog.c index ca5ad21c7..709fcfef0 100644 --- a/gtk/gtkmessagedialog.c +++ b/gtk/gtkmessagedialog.c @@ -13,9 +13,7 @@ * 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. + * License along with this library. If not, see . */ /* @@ -25,33 +23,94 @@ * GTK+ at ftp://ftp.gtk.org/pub/gtk/. */ -#include +#include "config.h" + +#include + #include "gtkmessagedialog.h" +#include "gtkaccessible.h" +#include "gtkbuildable.h" #include "gtklabel.h" -#include "gtkhbox.h" -#include "gtkvbox.h" +#include "gtkbox.h" #include "gtkimage.h" #include "gtkstock.h" #include "gtkiconfactory.h" #include "gtkintl.h" -#include -#include "gtkalias.h" - -#define GTK_MESSAGE_DIALOG_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_MESSAGE_DIALOG, GtkMessageDialogPrivate)) +#include "gtkprivate.h" +#include "gtktypebuiltins.h" -typedef struct _GtkMessageDialogPrivate GtkMessageDialogPrivate; +/** + * 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. + * + * One difference from #GtkDialog is that #GtkMessageDialog sets the + * #GtkWindow:skip-taskbar-hint property to %TRUE, so that the dialog is hidden + * from the taskbar by default. + * + * 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. + * + * A modal dialog. + * + * 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); + * + * + * You might do a non-modal #GtkMessageDialog as follows: + * + * A non-modal dialog. + * + * 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); + * + * + * + * + * GtkMessageDialog as GtkBuildable + * + * The GtkMessageDialog implementation of the GtkBuildable interface exposes + * the message area as an internal child with the name "message_area". + * + * + */ struct _GtkMessageDialogPrivate { - GtkWidget *secondary_label; - gboolean has_primary_markup; - gboolean has_secondary_text; + GtkWidget *image; + GtkWidget *label; + GtkWidget *message_area; /* vbox for the primary and secondary labels, and any extra content from the caller */ + GtkWidget *secondary_label; + + guint has_primary_markup : 1; + guint has_secondary_text : 1; + guint message_type : 3; }; -static void gtk_message_dialog_class_init (GtkMessageDialogClass *klass); -static void gtk_message_dialog_init (GtkMessageDialog *dialog); -static void gtk_message_dialog_style_set (GtkWidget *widget, - GtkStyle *prev_style); +static void gtk_message_dialog_style_updated (GtkWidget *widget); static void gtk_message_dialog_set_property (GObject *object, guint prop_id, @@ -63,46 +122,51 @@ static void gtk_message_dialog_get_property (GObject *object, 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); -static void gtk_message_dialog_font_size_change (GtkWidget *widget, - GtkStyle *prev_style, - gpointer data); enum { PROP_0, PROP_MESSAGE_TYPE, - PROP_BUTTONS + PROP_BUTTONS, + PROP_TEXT, + PROP_USE_MARKUP, + PROP_SECONDARY_TEXT, + PROP_SECONDARY_USE_MARKUP, + PROP_IMAGE, + PROP_MESSAGE_AREA }; -static gpointer parent_class; +G_DEFINE_TYPE_WITH_CODE (GtkMessageDialog, gtk_message_dialog, GTK_TYPE_DIALOG, + G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE, + gtk_message_dialog_buildable_interface_init)) -GType -gtk_message_dialog_get_type (void) +static GtkBuildableIface *parent_buildable_iface; + +static void +gtk_message_dialog_buildable_interface_init (GtkBuildableIface *iface) { - static GType dialog_type = 0; + 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; +} - if (!dialog_type) - { - static const GTypeInfo dialog_info = - { - sizeof (GtkMessageDialogClass), - NULL, /* base_init */ - NULL, /* base_finalize */ - (GClassInitFunc) gtk_message_dialog_class_init, - NULL, /* class_finalize */ - NULL, /* class_data */ - sizeof (GtkMessageDialog), - 0, /* n_preallocs */ - (GInstanceInitFunc) gtk_message_dialog_init, - }; - - dialog_type = g_type_register_static (GTK_TYPE_DIALOG, "GtkMessageDialog", - &dialog_info, 0); - } +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 dialog_type; + return parent_buildable_iface->get_internal_child (buildable, builder, childname); } + static void gtk_message_dialog_class_init (GtkMessageDialogClass *class) { @@ -111,10 +175,10 @@ gtk_message_dialog_class_init (GtkMessageDialogClass *class) widget_class = GTK_WIDGET_CLASS (class); gobject_class = G_OBJECT_CLASS (class); - - parent_class = g_type_class_peek_parent (class); - widget_class->style_set = gtk_message_dialog_style_set; + widget_class->style_updated = gtk_message_dialog_style_updated; + + gtk_widget_class_set_accessible_role (widget_class, ATK_ROLE_ALERT); gobject_class->set_property = gtk_message_dialog_set_property; gobject_class->get_property = gtk_message_dialog_get_property; @@ -126,21 +190,15 @@ gtk_message_dialog_class_init (GtkMessageDialogClass *class) 0, G_MAXINT, 12, - G_PARAM_READABLE)); + GTK_PARAM_READABLE)); + /** - * GtkMessageDialog::use_separator - * - * Whether to draw a separator line between the message label and the buttons - * in the dialog. + * GtkMessageDialog:message-type: * - * Since: 2.4 + * 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. */ - 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, - G_PARAM_READABLE)); g_object_class_install_property (gobject_class, PROP_MESSAGE_TYPE, g_param_spec_enum ("message-type", @@ -148,7 +206,7 @@ gtk_message_dialog_class_init (GtkMessageDialogClass *class) P_("The type of message"), GTK_TYPE_MESSAGE_TYPE, GTK_MESSAGE_INFO, - G_PARAM_READABLE | G_PARAM_WRITABLE | G_PARAM_CONSTRUCT)); + GTK_PARAM_READWRITE | G_PARAM_CONSTRUCT)); g_object_class_install_property (gobject_class, PROP_BUTTONS, g_param_spec_enum ("buttons", @@ -156,117 +214,208 @@ gtk_message_dialog_class_init (GtkMessageDialogClass *class) P_("The buttons shown in the message dialog"), GTK_TYPE_BUTTONS_TYPE, GTK_BUTTONS_NONE, - G_PARAM_WRITABLE | G_PARAM_CONSTRUCT_ONLY)); - g_type_class_add_private (gobject_class, - sizeof (GtkMessageDialogPrivate)); + 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, *vbox; + GtkWidget *hbox; + GtkDialog *message_dialog = GTK_DIALOG (dialog); + GtkWidget *action_area, *content_area; GtkMessageDialogPrivate *priv; - priv = GTK_MESSAGE_DIALOG_GET_PRIVATE (dialog); + dialog->priv = G_TYPE_INSTANCE_GET_PRIVATE (dialog, + GTK_TYPE_MESSAGE_DIALOG, + GtkMessageDialogPrivate); + priv = dialog->priv; + + content_area = gtk_dialog_get_content_area (message_dialog); + action_area = gtk_dialog_get_action_area (message_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); - + + priv->label = gtk_label_new (NULL); + priv->image = gtk_image_new_from_stock (NULL, GTK_ICON_SIZE_DIALOG); + g_object_set (priv->image, "use-fallback", TRUE, NULL); + gtk_widget_set_halign (priv->image, GTK_ALIGN_CENTER); + gtk_widget_set_valign (priv->image, GTK_ALIGN_START); + + gtk_label_set_line_wrap (GTK_LABEL (priv->label), TRUE); + gtk_label_set_selectable (GTK_LABEL (priv->label), TRUE); + gtk_widget_set_halign (priv->label, GTK_ALIGN_START); + gtk_widget_set_valign (priv->label, GTK_ALIGN_START); + 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); + gtk_widget_set_halign (priv->secondary_label, GTK_ALIGN_START); + gtk_widget_set_valign (priv->secondary_label, GTK_ALIGN_START); - hbox = gtk_hbox_new (FALSE, 12); - vbox = gtk_vbox_new (FALSE, 12); + gtk_misc_set_alignment (GTK_MISC (priv->label), 0.0, 0.0); + gtk_misc_set_alignment (GTK_MISC (priv->secondary_label), 0.0, 0.0); - gtk_box_pack_start (GTK_BOX (vbox), dialog->label, + hbox = gtk_box_new (GTK_ORIENTATION_HORIZONTAL, 12); + priv->message_area = gtk_box_new (GTK_ORIENTATION_VERTICAL, 12); + + gtk_box_pack_start (GTK_BOX (priv->message_area), priv->label, FALSE, FALSE, 0); - gtk_box_pack_start (GTK_BOX (vbox), priv->secondary_label, + gtk_box_pack_start (GTK_BOX (priv->message_area), priv->secondary_label, TRUE, TRUE, 0); - gtk_box_pack_start (GTK_BOX (hbox), dialog->image, + gtk_box_pack_start (GTK_BOX (hbox), priv->image, FALSE, FALSE, 0); - gtk_box_pack_start (GTK_BOX (hbox), vbox, + gtk_box_pack_start (GTK_BOX (hbox), priv->message_area, TRUE, TRUE, 0); - gtk_box_pack_start (GTK_BOX (GTK_DIALOG (dialog)->vbox), + gtk_box_pack_start (GTK_BOX (content_area), hbox, FALSE, FALSE, 0); - gtk_widget_show_all (hbox); - - _gtk_dialog_set_ignore_separator (GTK_DIALOG (dialog), TRUE); + gtk_container_set_border_width (GTK_CONTAINER (dialog), 5); + gtk_container_set_border_width (GTK_CONTAINER (hbox), 5); + gtk_box_set_spacing (GTK_BOX (content_area), 14); /* 14 + 2 * 5 = 24 */ + gtk_container_set_border_width (GTK_CONTAINER (action_area), 5); + gtk_box_set_spacing (GTK_BOX (action_area), 6); - g_signal_connect (G_OBJECT (dialog), "style-set", - G_CALLBACK (gtk_message_dialog_font_size_change), NULL); -} - -static GtkMessageType -gtk_message_dialog_get_message_type (GtkMessageDialog *dialog) -{ - const gchar* stock_id = NULL; + gtk_message_dialog_style_updated (GTK_WIDGET (dialog)); - g_return_val_if_fail (GTK_IS_MESSAGE_DIALOG (dialog), GTK_MESSAGE_INFO); - g_return_val_if_fail (GTK_IS_IMAGE(dialog->image), GTK_MESSAGE_INFO); - - stock_id = GTK_IMAGE(dialog->image)->data.stock.stock_id; - - /* Look at the stock id of the image to guess the - * GtkMessageType value that was used to choose it - * in setup_type() - */ - if (strcmp (stock_id, GTK_STOCK_DIALOG_INFO) == 0) - return GTK_MESSAGE_INFO; - else if (strcmp (stock_id, GTK_STOCK_DIALOG_QUESTION) == 0) - return GTK_MESSAGE_QUESTION; - else if (strcmp (stock_id, GTK_STOCK_DIALOG_WARNING) == 0) - return GTK_MESSAGE_WARNING; - else if (strcmp (stock_id, GTK_STOCK_DIALOG_ERROR) == 0) - return GTK_MESSAGE_ERROR; - else - { - g_assert_not_reached (); - return GTK_MESSAGE_INFO; - } + gtk_widget_show_all (hbox); } static void setup_primary_label_font (GtkMessageDialog *dialog) { - gint size; - PangoFontDescription *font_desc; - GtkMessageDialogPrivate *priv; + GtkMessageDialogPrivate *priv = dialog->priv; + + if (!priv->has_primary_markup) + { + PangoAttrList *attributes; + PangoAttribute *attr; - priv = GTK_MESSAGE_DIALOG_GET_PRIVATE (dialog); + attributes = pango_attr_list_new (); - if (priv->has_primary_markup) - return; + attr = pango_attr_weight_new (PANGO_WEIGHT_BOLD); + pango_attr_list_insert (attributes, attr); - /* unset the font settings */ - gtk_widget_modify_font (dialog->label, NULL); + if (priv->has_secondary_text) + { + attr = pango_attr_scale_new (PANGO_SCALE_LARGE); + pango_attr_list_insert (attributes, attr); + } - if (priv->has_secondary_text) + gtk_label_set_attributes (GTK_LABEL (priv->label), attributes); + pango_attr_list_unref (attributes); + } + else { - 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); + /* unset the font settings */ + gtk_label_set_attributes (GTK_LABEL (priv->label), NULL); } } @@ -274,44 +423,59 @@ static void setup_type (GtkMessageDialog *dialog, GtkMessageType type) { + GtkMessageDialogPrivate *priv = dialog->priv; const gchar *stock_id = NULL; - GtkStockItem item; - + AtkObject *atk_obj; + GIcon *gicon = NULL; + + priv->message_type = type; + switch (type) { case GTK_MESSAGE_INFO: stock_id = GTK_STOCK_DIALOG_INFO; + gicon = g_themed_icon_new_with_default_fallbacks ("dialog-information-symbolic"); break; case GTK_MESSAGE_QUESTION: stock_id = GTK_STOCK_DIALOG_QUESTION; + gicon = g_themed_icon_new_with_default_fallbacks ("dialog-question-symbolic"); break; case GTK_MESSAGE_WARNING: stock_id = GTK_STOCK_DIALOG_WARNING; + gicon = g_themed_icon_new_with_default_fallbacks ("dialog-warning-symbolic"); break; - + case GTK_MESSAGE_ERROR: stock_id = GTK_STOCK_DIALOG_ERROR; + gicon = g_themed_icon_new_with_default_fallbacks ("dialog-error-symbolic"); + break; + + case GTK_MESSAGE_OTHER: break; default: - g_warning ("Unknown GtkMessageType %d", type); + g_warning ("Unknown GtkMessageType %u", type); break; } - if (stock_id == NULL) - stock_id = GTK_STOCK_DIALOG_INFO; + gtk_image_set_from_gicon (GTK_IMAGE (priv->image), gicon, GTK_ICON_SIZE_DIALOG); + if (gicon) + g_object_unref (gicon); - if (gtk_stock_lookup (stock_id, &item)) + atk_obj = gtk_widget_get_accessible (GTK_WIDGET (dialog)); + if (GTK_IS_ACCESSIBLE (atk_obj)) { - gtk_image_set_from_stock (GTK_IMAGE (dialog->image), stock_id, - GTK_ICON_SIZE_DIALOG); - - gtk_window_set_title (GTK_WINDOW (dialog), item.label); + 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); + } } - else - g_warning ("Stock dialog ID doesn't exist?"); } static void @@ -320,10 +484,9 @@ gtk_message_dialog_set_property (GObject *object, const GValue *value, GParamSpec *pspec) { - GtkMessageDialog *dialog; - - dialog = GTK_MESSAGE_DIALOG (object); - + GtkMessageDialog *dialog = GTK_MESSAGE_DIALOG (object); + GtkMessageDialogPrivate *priv = dialog->priv; + switch (prop_id) { case PROP_MESSAGE_TYPE: @@ -332,6 +495,50 @@ gtk_message_dialog_set_property (GObject *object, 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 (priv->label), + g_value_get_string (value)); + else + gtk_label_set_text (GTK_LABEL (priv->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 (priv->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; @@ -344,14 +551,39 @@ gtk_message_dialog_get_property (GObject *object, GValue *value, GParamSpec *pspec) { - GtkMessageDialog *dialog; - - dialog = GTK_MESSAGE_DIALOG (object); - + GtkMessageDialog *dialog = GTK_MESSAGE_DIALOG (object); + GtkMessageDialogPrivate *priv = dialog->priv; + switch (prop_id) { case PROP_MESSAGE_TYPE: - g_value_set_enum (value, gtk_message_dialog_get_message_type (dialog)); + g_value_set_enum (value, (GtkMessageType) priv->message_type); + break; + case PROP_TEXT: + g_value_set_string (value, gtk_label_get_label (GTK_LABEL (priv->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, priv->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); @@ -359,32 +591,23 @@ gtk_message_dialog_get_property (GObject *object, } } -static void -gtk_message_dialog_font_size_change (GtkWidget *widget, - GtkStyle *prev_style, - gpointer data) -{ - setup_primary_label_font (GTK_MESSAGE_DIALOG (widget)); -} - - /** * gtk_message_dialog_new: - * @parent: transient parent, or NULL for none + * @parent: (allow-none): transient parent, or %NULL for none * @flags: flags * @type: type of message * @buttons: set of buttons to use - * @message_format: printf()-style format string, or NULL - * @Varargs: arguments for @message_format - * + * @message_format: (allow-none): printf()-style format string, or %NULL + * @...: 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: a new #GtkMessageDialog - **/ + * + * Return value: (transfer none): a new #GtkMessageDialog + */ GtkWidget* gtk_message_dialog_new (GtkWindow *parent, GtkDialogFlags flags, @@ -401,24 +624,18 @@ gtk_message_dialog_new (GtkWindow *parent, g_return_val_if_fail (parent == NULL || GTK_IS_WINDOW (parent), NULL); widget = g_object_new (GTK_TYPE_MESSAGE_DIALOG, - "message_type", type, + "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), + gtk_label_set_text (GTK_LABEL (GTK_MESSAGE_DIALOG (widget)->priv->label), msg); g_free (msg); @@ -434,21 +651,18 @@ gtk_message_dialog_new (GtkWindow *parent, if (flags & GTK_DIALOG_DESTROY_WITH_PARENT) gtk_window_set_destroy_with_parent (GTK_WINDOW (dialog), TRUE); - if (flags & GTK_DIALOG_NO_SEPARATOR) - gtk_dialog_set_has_separator (dialog, FALSE); - return widget; } /** * gtk_message_dialog_new_with_markup: - * @parent: transient parent, or %NULL for none + * @parent: (allow-none): transient parent, or %NULL for none * @flags: flags * @type: type of message * @buttons: set of buttons to use - * @message_format: printf()-style format string, or %NULL - * @Varargs: arguments for @message_format - * + * @message_format: (allow-none): printf()-style format string, or %NULL + * @...: 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 Pango text markup language. @@ -464,17 +678,16 @@ gtk_message_dialog_new (GtkWindow *parent, * 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_BUTTON_CLOSE, + * GTK_BUTTONS_CLOSE, * NULL); * gtk_message_dialog_set_markup (GTK_MESSAGE_DIALOG (dialog), * markup); - * + * ]| * * Return value: a new #GtkMessageDialog * @@ -510,6 +723,64 @@ gtk_message_dialog_new_with_markup (GtkWindow *parent, 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)); + + priv = dialog->priv; + + if (image == NULL) + { + image = gtk_image_new_from_stock (NULL, GTK_ICON_SIZE_DIALOG); + gtk_widget_set_halign (image, GTK_ALIGN_CENTER); + gtk_widget_set_valign (image, GTK_ALIGN_START); + } + + priv->message_type = GTK_MESSAGE_OTHER; + + parent = gtk_widget_get_parent (priv->image); + gtk_container_add (GTK_CONTAINER (parent), image); + gtk_container_remove (GTK_CONTAINER (parent), priv->image); + gtk_box_reorder_child (GTK_BOX (parent), image, 0); + + priv->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->priv->image; +} + /** * gtk_message_dialog_set_markup: * @message_dialog: a #GtkMessageDialog @@ -529,25 +800,23 @@ gtk_message_dialog_set_markup (GtkMessageDialog *message_dialog, g_return_if_fail (GTK_IS_MESSAGE_DIALOG (message_dialog)); - priv = GTK_MESSAGE_DIALOG_GET_PRIVATE (message_dialog); + priv = message_dialog->priv; + priv->has_primary_markup = TRUE; - gtk_label_set_markup (GTK_LABEL (message_dialog->label), str); + gtk_label_set_markup (GTK_LABEL (priv->label), str); } /** * gtk_message_dialog_format_secondary_text: * @message_dialog: a #GtkMessageDialog - * @message_format: 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). + * @message_format: (allow-none): printf()-style format string, or %NULL + * @...: arguments for @message_format * - * Note that setting a secondary text makes the primary text become - * bold, unless you have provided explicit markup. + * Sets the secondary text of the message dialog to be @message_format + * (with printf()-style). * * Since: 2.6 - **/ + */ void gtk_message_dialog_format_secondary_text (GtkMessageDialog *message_dialog, const gchar *message_format, @@ -559,7 +828,7 @@ gtk_message_dialog_format_secondary_text (GtkMessageDialog *message_dialog, g_return_if_fail (GTK_IS_MESSAGE_DIALOG (message_dialog)); - priv = GTK_MESSAGE_DIALOG_GET_PRIVATE (message_dialog); + priv = message_dialog->priv; if (message_format) { @@ -586,19 +855,29 @@ gtk_message_dialog_format_secondary_text (GtkMessageDialog *message_dialog, /** * gtk_message_dialog_format_secondary_markup: * @message_dialog: a #GtkMessageDialog - * @message_format: printf()-style markup string (see + * @message_format: printf()-style markup string (see Pango markup format), 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 + * @...: 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 * Pango text markup language. * - * 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. + + * + * gchar *msg; + * + * msg = g_markup_printf_escaped (message_format, ...); + * gtk_message_dialog_format_secondary_markup (message_dialog, "%s", msg); + * g_free (msg); + * * * Since: 2.6 - **/ + */ void gtk_message_dialog_format_secondary_markup (GtkMessageDialog *message_dialog, const gchar *message_format, @@ -610,7 +889,7 @@ gtk_message_dialog_format_secondary_markup (GtkMessageDialog *message_dialog, g_return_if_fail (GTK_IS_MESSAGE_DIALOG (message_dialog)); - priv = GTK_MESSAGE_DIALOG_GET_PRIVATE (message_dialog); + priv = message_dialog->priv; if (message_format) { @@ -634,6 +913,30 @@ gtk_message_dialog_format_secondary_markup (GtkMessageDialog *message_dialog, setup_primary_label_font (message_dialog); } +/** + * gtk_message_dialog_get_message_area: + * @message_dialog: a #GtkMessageDialog + * + * Returns the message area of the dialog. This is the box where the + * dialog's primary and secondary labels are packed. You can add your + * own extra content to that box and it will appear below those labels, + * on the right side of the dialog's image (or on the left for right-to-left + * languages). See gtk_dialog_get_content_area() for the corresponding + * function in the parent #GtkDialog. + * + * Return value: (transfer none): A #GtkVBox corresponding to the + * "message area" in the @message_dialog. + * + * Since: 2.22 + **/ +GtkWidget * +gtk_message_dialog_get_message_area (GtkMessageDialog *message_dialog) +{ + g_return_val_if_fail (GTK_IS_MESSAGE_DIALOG (message_dialog), NULL); + + return message_dialog->priv->message_area; +} + static void gtk_message_dialog_add_buttons (GtkMessageDialog* message_dialog, GtkButtonsType buttons) @@ -699,34 +1002,22 @@ gtk_message_dialog_add_buttons (GtkMessageDialog* message_dialog, } static void -gtk_message_dialog_style_set (GtkWidget *widget, - GtkStyle *prev_style) +gtk_message_dialog_style_updated (GtkWidget *widget) { + GtkMessageDialog *dialog = GTK_MESSAGE_DIALOG (widget); GtkWidget *parent; - gint border_width = 0; - gboolean use_separator; + gint border_width; - parent = GTK_WIDGET (GTK_MESSAGE_DIALOG (widget)->image->parent); + parent = gtk_widget_get_parent (gtk_message_dialog_get_image (dialog)); if (parent) { - gtk_widget_style_get (widget, "message_border", + gtk_widget_style_get (widget, "message-border", &border_width, NULL); - + gtk_container_set_border_width (GTK_CONTAINER (parent), - border_width); + MAX (0, border_width - 7)); } - gtk_widget_style_get (widget, - "use_separator", &use_separator, - NULL); - _gtk_dialog_set_ignore_separator (GTK_DIALOG (widget), FALSE); - gtk_dialog_set_has_separator (GTK_DIALOG (widget), use_separator); - _gtk_dialog_set_ignore_separator (GTK_DIALOG (widget), TRUE); - - if (GTK_WIDGET_CLASS (parent_class)->style_set) - (GTK_WIDGET_CLASS (parent_class)->style_set) (widget, prev_style); + GTK_WIDGET_CLASS (gtk_message_dialog_parent_class)->style_updated (widget); } - -#define __GTK_MESSAGE_DIALOG_C__ -#include "gtkaliasdef.c"