[gimp] app: add gimp_tools_blink_lock_box()

[Ell <ell src gnome org>]

commit 9bdaec3a498305c0186df22b436b3368b940aa2a
Author: Ell <ell_se yahoo com>
Date:   Mon Dec 10 08:00:32 2018 -0500

    app: add gimp_tools_blink_lock_box()
    
    Add gimp_tools_blink_lock_box() utility function, in a new
    gimptools-utils.c file, which takes a GimpItem, and blinks the
    GimpItemTreeView lock-box of the corresponding dockable.  This can
    be used to hint that the item's lock toggles are preventing it from
    being edited.

 app/tools/Makefile.am       |  2 ++
 app/tools/gimptools-utils.c | 79 +++++++++++++++++++++++++++++++++++++++++++++
 app/tools/gimptools-utils.h | 26 +++++++++++++++
 3 files changed, 107 insertions(+)
---
diff --git a/app/tools/Makefile.am b/app/tools/Makefile.am
index 42342440d6..c3308cfbcd 100644
--- a/app/tools/Makefile.am
+++ b/app/tools/Makefile.am
@@ -208,6 +208,8 @@ libapptools_a_sources = \
        gimptoolcontrol.h               \
        gimptooloptions-gui.c           \
        gimptooloptions-gui.h           \
+       gimptools-utils.c               \
+       gimptools-utils.h               \
        gimptransformgridoptions.c      \
        gimptransformgridoptions.h      \
        gimptransformgridtool.c         \
diff --git a/app/tools/gimptools-utils.c b/app/tools/gimptools-utils.c
new file mode 100644
index 0000000000..8aa9188b1a
--- /dev/null
+++ b/app/tools/gimptools-utils.c
@@ -0,0 +1,79 @@
+/* GIMP - The GNU Image Manipulation Program
+ * Copyright (C) 1995-2001 Spencer Kimball, Peter Mattis and others
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+#include "config.h"
+
+#include <gegl.h>
+#include <gtk/gtk.h>
+
+#include "libgimpwidgets/gimpwidgets.h"
+
+#include "tools-types.h"
+
+#include "core/gimp.h"
+#include "core/gimpchannel.h"
+#include "core/gimplayer.h"
+
+#include "vectors/gimpvectors.h"
+
+#include "widgets/gimpdialogfactory.h"
+#include "widgets/gimpitemtreeview.h"
+#include "widgets/gimpwidgets-utils.h"
+#include "widgets/gimpwindowstrategy.h"
+
+#include "gimptools-utils.h"
+
+
+/*  public functions  */
+
+void
+gimp_tools_blink_lock_box (Gimp     *gimp,
+                           GimpItem *item)
+{
+  GtkWidget        *dockable;
+  GimpItemTreeView *view;
+  GdkMonitor       *monitor;
+  const gchar      *identifier;
+
+  g_return_if_fail (GIMP_IS_GIMP (gimp));
+  g_return_if_fail (GIMP_IS_ITEM (item));
+
+  if (GIMP_IS_LAYER (item))
+    identifier = "gimp-layer-list";
+  else if (GIMP_IS_CHANNEL (item))
+    identifier = "gimp-channel-list";
+  else if (GIMP_IS_VECTORS (item))
+    identifier = "gimp-vectors-list";
+  else
+    return;
+
+  monitor = gimp_get_monitor_at_pointer ();
+
+  dockable = gimp_window_strategy_show_dockable_dialog (
+    GIMP_WINDOW_STRATEGY (gimp_get_window_strategy (gimp)),
+    gimp,
+    gimp_dialog_factory_get_singleton (),
+    monitor,
+    identifier);
+
+  if (! dockable)
+    return;
+
+  view = GIMP_ITEM_TREE_VIEW (gtk_bin_get_child (GTK_BIN (dockable)));
+
+  gimp_widget_blink (gimp_item_tree_view_get_lock_box (view));
+}
diff --git a/app/tools/gimptools-utils.h b/app/tools/gimptools-utils.h
new file mode 100644
index 0000000000..5810f19ca6
--- /dev/null
+++ b/app/tools/gimptools-utils.h
@@ -0,0 +1,26 @@
+/* GIMP - The GNU Image Manipulation Program
+ * Copyright (C) 1995-2001 Spencer Kimball, Peter Mattis and others
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program 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 General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+#ifndef __GIMP_TOOLS_UTILS_H__
+#define __GIMP_TOOLS_UTILS_H__
+
+
+void   gimp_tools_blink_lock_box (Gimp     *gimp,
+                                  GimpItem *item);
+
+
+#endif  /* __GIMP_TOOLS_UTILS_H__ */