Adding upstream version 2.10.22.upstream/2.10.22upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

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);
+}