diff options
Diffstat (limited to 'libgimpwidgets/gimphintbox.c')
| -rw-r--r-- | libgimpwidgets/gimphintbox.c | 246 |
1 files changed, 246 insertions, 0 deletions
diff --git a/libgimpwidgets/gimphintbox.c b/libgimpwidgets/gimphintbox.c new file mode 100644 index 0000000..f1e2291 --- /dev/null +++ b/libgimpwidgets/gimphintbox.c @@ -0,0 +1,246 @@ +/* LIBGIMP - The GIMP Library + * Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball + * + * gimphintbox.c + * Copyright (C) 2006 Sven Neumann <sven@gimp.org> + * + * This library is free software: you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 3 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 + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library. If not, see + * <https://www.gnu.org/licenses/>. + */ + +#include "config.h" + +#include <gegl.h> +#include <gtk/gtk.h> + +#include "gimpwidgets.h" + + +/** + * SECTION: gimphintbox + * @title: GimpHintBox + * @short_description: Displays a wilber icon and a text. + * + * Displays a wilber icon and a text. + **/ + + +enum +{ + PROP_0, + PROP_ICON_NAME, + PROP_STOCK_ID, + PROP_HINT +}; + +struct _GimpHintBoxPrivate +{ + gchar *icon_name; + gchar *stock_id; + gchar *hint; +}; + + +static void gimp_hint_box_constructed (GObject *object); +static void gimp_hint_box_finalize (GObject *object); +static void gimp_hint_box_set_property (GObject *object, + guint property_id, + const GValue *value, + GParamSpec *pspec); +static void gimp_hint_box_get_property (GObject *object, + guint property_id, + GValue *value, + GParamSpec *pspec); + + +G_DEFINE_TYPE_WITH_PRIVATE (GimpHintBox, gimp_hint_box, GTK_TYPE_BOX) + +#define parent_class gimp_hint_box_parent_class + + +static void +gimp_hint_box_class_init (GimpHintBoxClass *klass) +{ + GObjectClass *object_class = G_OBJECT_CLASS (klass); + + object_class->constructed = gimp_hint_box_constructed; + object_class->finalize = gimp_hint_box_finalize; + object_class->set_property = gimp_hint_box_set_property; + object_class->get_property = gimp_hint_box_get_property; + + g_object_class_install_property (object_class, PROP_ICON_NAME, + g_param_spec_string ("icon-name", + "Icon Name", + "The icon to show next to the hint", + GIMP_ICON_DIALOG_INFORMATION, + G_PARAM_CONSTRUCT_ONLY | + GIMP_PARAM_READWRITE)); + + g_object_class_install_property (object_class, PROP_STOCK_ID, + g_param_spec_string ("stock-id", + "Stock ID", + "Deprecated: use icon-name instead", + GIMP_ICON_DIALOG_INFORMATION, + G_PARAM_CONSTRUCT_ONLY | + GIMP_PARAM_READWRITE)); + + g_object_class_install_property (object_class, PROP_HINT, + g_param_spec_string ("hint", + "Hint", + "The hint to display", + NULL, + G_PARAM_CONSTRUCT_ONLY | + GIMP_PARAM_READWRITE)); +} + +static void +gimp_hint_box_init (GimpHintBox *box) +{ + box->priv = gimp_hint_box_get_instance_private (box); + + gtk_orientable_set_orientation (GTK_ORIENTABLE (box), + GTK_ORIENTATION_HORIZONTAL); +} + +static void +gimp_hint_box_constructed (GObject *object) +{ + GimpHintBox *box = GIMP_HINT_BOX (object); + GtkWidget *image = NULL; + GtkWidget *label; + + G_OBJECT_CLASS (parent_class)->constructed (object); + + gtk_box_set_spacing (GTK_BOX (box), 12); + + if (box->priv->icon_name) + { + image = gtk_image_new_from_icon_name (box->priv->icon_name, + GTK_ICON_SIZE_DIALOG); + } + else if (box->priv->stock_id) + { + image = gtk_image_new_from_stock (box->priv->stock_id, + GTK_ICON_SIZE_DIALOG); + } + + if (image) + { + gtk_box_pack_start (GTK_BOX (box), image, FALSE, FALSE, 0); + gtk_widget_show (image); + } + + label = g_object_new (GTK_TYPE_LABEL, + "label", box->priv->hint, + "wrap", TRUE, + "justify", GTK_JUSTIFY_LEFT, + "xalign", 0.0, + "yalign", 0.5, + NULL); + + gimp_label_set_attributes (GTK_LABEL (label), + PANGO_ATTR_STYLE, PANGO_STYLE_ITALIC, + -1); + gtk_box_pack_start (GTK_BOX (box), label, FALSE, FALSE, 0); + gtk_widget_show (label); +} + +static void +gimp_hint_box_finalize (GObject *object) +{ + GimpHintBox *box = GIMP_HINT_BOX (object); + + g_clear_pointer (&box->priv->icon_name, g_free); + g_clear_pointer (&box->priv->stock_id, g_free); + g_clear_pointer (&box->priv->hint, g_free); + + G_OBJECT_CLASS (parent_class)->finalize (object); +} + +static void +gimp_hint_box_set_property (GObject *object, + guint property_id, + const GValue *value, + GParamSpec *pspec) +{ + GimpHintBox *box = GIMP_HINT_BOX (object); + + switch (property_id) + { + case PROP_ICON_NAME: + box->priv->icon_name = g_value_dup_string (value); + break; + + case PROP_STOCK_ID: + box->priv->stock_id = g_value_dup_string (value); + break; + + case PROP_HINT: + box->priv->hint = g_value_dup_string (value); + break; + + default: + G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec); + break; + } +} + +static void +gimp_hint_box_get_property (GObject *object, + guint property_id, + GValue *value, + GParamSpec *pspec) +{ + GimpHintBox *box = GIMP_HINT_BOX (object); + + switch (property_id) + { + case PROP_ICON_NAME: + g_value_set_string (value, box->priv->icon_name); + break; + + case PROP_STOCK_ID: + g_value_set_string (value, box->priv->stock_id); + break; + + case PROP_HINT: + g_value_set_string (value, box->priv->hint); + break; + + default: + G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec); + break; + } +} + +/** + * gimp_hint_box_new: + * @hint: text to display as a user hint + * + * Creates a new widget that shows a text label showing @hint, + * decorated with a GIMP_ICON_DIALOG_INFORMATION wilber icon. + * + * Return value: a new widget + * + * Since GIMP 2.4 + **/ +GtkWidget * +gimp_hint_box_new (const gchar *hint) +{ + g_return_val_if_fail (hint != NULL, NULL); + + return g_object_new (GIMP_TYPE_HINT_BOX, + "hint", hint, + NULL); +} |