menu.c

Go to the documentation of this file.

/*
    This file is part of the Ansel project.
    Copyright (C) 2023, 2025 Aurélien PIERRE.
    Copyright (C) 2023 Luca Zulberti.
    Copyright (C) 2026 Guillaume Stutin.
    
    Ansel 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.
    
    Ansel 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 Ansel.  If not, see <http://www.gnu.org/licenses/>.
*/
 
#include "common/act_on.h"
#include "common/selection.h"
#include "gui/application.h"
#include "widgets/accelerators.h"
#include "views/view.h"
#include "math.h"
#include "menu.h"
#include "widgets/label.h"
#include "widgets/widget_settings.h"
#include "widgets/widget_style.h"
 
#ifdef GDK_WINDOWING_QUARTZ
#endif
 
// Wrapper to match menuitem "activate" signal to our generic accel callback
static void _activate_callback_to_action_callback(GtkMenuItem* menu_item, gpointer user_data)
{
  dt_menu_entry_t *entry = (dt_menu_entry_t *)user_data;
  GtkWindow *window = GTK_WINDOW(gtk_widget_get_ancestor(GTK_WIDGET(menu_item), GTK_TYPE_WINDOW));
  entry->action_callback(entry->accel_group, G_OBJECT(window), 0, 0, menu_item);
}
 
static gboolean _menu_icon_draw(GtkWidget *widget, cairo_t *cr, gpointer user_data)
{
  dt_menu_icon_data_t *data = (dt_menu_icon_data_t *)user_data;
  if(IS_NULL_PTR(data) || data->shape == DT_MENU_ICON_NONE) return FALSE;
 
  GtkStyleContext *context = gtk_widget_get_style_context(widget);
  GdkRGBA color;
  gtk_style_context_get_color(context, GTK_STATE_FLAG_NORMAL, &color);
  cairo_set_source_rgba(cr, color.red, color.green, color.blue, color.alpha);
  cairo_set_line_width(cr, 1.2);
 
  GtkAllocation alloc;
  gtk_widget_get_allocation(widget, &alloc);
  const double pad = 1.0;
  const double w = MAX(0.0, (double)alloc.width - 2.0 * pad);
  const double h = MAX(0.0, (double)alloc.height - 2.0 * pad);
  const double size = fmin(w, h);
  const double x = ((double)alloc.width - size) * 0.5;
  const double y = ((double)alloc.height - size) * 0.5;
 
  if(data->shape == DT_MENU_ICON_CIRCLE)
  {
    cairo_arc(cr, x + size * 0.5, y + size * 0.5, MAX(0.0, size * 0.5 - 0.5), 0.0, 2.0 * M_PI);
    cairo_stroke(cr);
  }
  else if(data->shape == DT_MENU_ICON_SQUARE)
  {
    cairo_rectangle(cr, x, y, size, size);
    cairo_stroke(cr);
  }
 
  return FALSE;
}
 
static void _menu_entry_destroy(GtkWidget *widget, gpointer user_data)
{
  dt_menu_entry_t *entry = (dt_menu_entry_t *)user_data;
  dt_free(entry->accel_path);
  dt_free(entry);
}
 
GtkWidget *ctx_gtk_menu_item_new_with_icon(const char *label, GtkWidget *menu,
                                             void (*activate_callback)(GtkWidget *widget, gpointer user_data),
                                             gpointer user_data, dt_menu_icon_t icon)
{
  GtkWidget *menu_item = gtk_menu_item_new();
  GtkWidget *box = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, DT_GUI_BOX_SPACING);
  GtkWidget *icon_widget = gtk_drawing_area_new();
  GtkWidget *label_widget = gtk_label_new(NULL);
 
  gtk_widget_set_size_request(icon_widget, 10, 10);
  gtk_label_set_markup(GTK_LABEL(label_widget), label);
 
  if(icon != DT_MENU_ICON_NONE)
  {
    dt_menu_icon_data_t *data = g_malloc0(sizeof(dt_menu_icon_data_t));
    data->shape = icon;
    g_signal_connect_data(icon_widget, "draw", G_CALLBACK(_menu_icon_draw), data, (GClosureNotify)g_free, 0);
  }
 
  gtk_label_set_xalign(GTK_LABEL(label_widget), 0.0f);
  gtk_box_pack_start(GTK_BOX(box), label_widget, FALSE, FALSE, 0);
  gtk_box_pack_start(GTK_BOX(box), icon_widget, FALSE, FALSE, 2);
  gtk_container_add(GTK_CONTAINER(menu_item), box);
  gtk_menu_shell_append(GTK_MENU_SHELL(menu), menu_item);
 
  if(activate_callback) g_signal_connect(G_OBJECT(menu_item), "activate", G_CALLBACK(activate_callback), user_data);
 
  return menu_item;
}
 
GtkWidget *ctx_gtk_menu_item_new_with_icon_and_shortcut(const char *label, const char *shortcut,
                                                           GtkWidget *menu,
                                                           void (*activate_callback)(GtkWidget *widget, gpointer user_data),
                                                           gpointer user_data, dt_menu_icon_t icon)
{
  GtkWidget *menu_item = gtk_menu_item_new();
  GtkWidget *box = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, DT_GUI_BOX_SPACING);
  GtkWidget *left_box = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, DT_GUI_BOX_SPACING);
  GtkWidget *icon_widget = gtk_drawing_area_new();
  GtkWidget *label_widget = gtk_label_new(NULL);
  GtkWidget *shortcut_widget = gtk_label_new(shortcut);
 
  gtk_widget_set_size_request(icon_widget, 10, 10);
  gtk_label_set_markup(GTK_LABEL(label_widget), label);
  gtk_label_set_xalign(GTK_LABEL(label_widget), 0.0f);
  gtk_widget_set_halign(label_widget, GTK_ALIGN_START);
  gtk_widget_set_hexpand(label_widget, TRUE);
 
  if(icon != DT_MENU_ICON_NONE)
  {
    dt_menu_icon_data_t *data = g_malloc0(sizeof(dt_menu_icon_data_t));
    data->shape = icon;
    g_signal_connect_data(icon_widget, "draw", G_CALLBACK(_menu_icon_draw), data, (GClosureNotify)g_free, 0);
  }
 
  gtk_label_set_xalign(GTK_LABEL(shortcut_widget), 1.0f);
  gtk_widget_set_halign(shortcut_widget, GTK_ALIGN_END);
  gtk_style_context_add_class(gtk_widget_get_style_context(shortcut_widget), "accelerator");
 
  gtk_box_pack_start(GTK_BOX(left_box), label_widget, TRUE, TRUE, 0);
  gtk_box_pack_start(GTK_BOX(left_box), icon_widget, FALSE, FALSE, 2);
  gtk_box_pack_start(GTK_BOX(box), left_box, TRUE, TRUE, 0);
  gtk_box_pack_end(GTK_BOX(box), shortcut_widget, FALSE, FALSE, 0);
 
  gtk_container_add(GTK_CONTAINER(menu_item), box);
  gtk_menu_item_set_reserve_indicator(GTK_MENU_ITEM(menu_item), FALSE);
  gtk_menu_shell_append(GTK_MENU_SHELL(menu), menu_item);
 
  if(activate_callback) g_signal_connect(G_OBJECT(menu_item), "activate", G_CALLBACK(activate_callback), user_data);
 
  return menu_item;
}
 
GtkWidget *ctx_gtk_menu_item_new_with_markup(const char *label, GtkWidget *menu,
                                               void (*activate_callback)(GtkWidget *widget, gpointer user_data),
                                               gpointer user_data)
{
  GtkWidget *menu_item = gtk_menu_item_new_with_label("");
  GtkWidget *child = gtk_bin_get_child(GTK_BIN(menu_item));
  gtk_label_set_markup(GTK_LABEL(child), label);
  gtk_menu_item_set_reserve_indicator(GTK_MENU_ITEM(menu_item), FALSE);
  gtk_menu_shell_append(GTK_MENU_SHELL(menu), menu_item);
 
  if(activate_callback) g_signal_connect(G_OBJECT(menu_item), "activate", G_CALLBACK(activate_callback), user_data);
 
  return menu_item;
}
 
GtkWidget *ctx_gtk_menu_item_new_with_markup_and_shortcut(const char *label, const char *shortcut,
                                                             GtkWidget *menu,
                                                             void (*activate_callback)(GtkWidget *widget, gpointer user_data),
                                                             gpointer user_data)
{
  GtkWidget *menu_item = gtk_menu_item_new();
  GtkWidget *box = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, DT_GUI_BOX_SPACING);
  GtkWidget *label_widget = gtk_label_new(NULL);
  GtkWidget *shortcut_widget = gtk_label_new(shortcut);
 
  gtk_label_set_markup(GTK_LABEL(label_widget), label);
  gtk_label_set_xalign(GTK_LABEL(label_widget), 0.0f);
  gtk_widget_set_halign(label_widget, GTK_ALIGN_START);
  gtk_widget_set_hexpand(label_widget, TRUE);
 
  gtk_label_set_xalign(GTK_LABEL(shortcut_widget), 1.0f);
  gtk_widget_set_halign(shortcut_widget, GTK_ALIGN_END);
  gtk_style_context_add_class(gtk_widget_get_style_context(shortcut_widget), "accelerator");
 
  gtk_box_pack_start(GTK_BOX(box), label_widget, TRUE, TRUE, 0);
  gtk_box_pack_end(GTK_BOX(box), shortcut_widget, FALSE, FALSE, 0);
  gtk_container_add(GTK_CONTAINER(menu_item), box);
  gtk_menu_item_set_reserve_indicator(GTK_MENU_ITEM(menu_item), FALSE);
  gtk_menu_shell_append(GTK_MENU_SHELL(menu), menu_item);
 
  if(activate_callback) g_signal_connect(G_OBJECT(menu_item), "activate", G_CALLBACK(activate_callback), user_data);
 
  return menu_item;
}
 
GtkWidget *ctx_gtk_menu_item_new_with_markup_and_pixbuf(const char *label, GdkPixbuf *icon,
                                                           GtkWidget *menu,
                                                           void (*activate_callback)(GtkWidget *widget, gpointer user_data),
                                                           gpointer user_data)
{
  GtkWidget *menu_item = gtk_menu_item_new();
  GtkWidget *box = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, DT_GUI_BOX_SPACING);
  GtkWidget *image_widget = icon ? gtk_image_new_from_pixbuf(icon) : gtk_image_new();
  GtkWidget *label_widget = gtk_label_new(NULL);
 
  gtk_label_set_markup(GTK_LABEL(label_widget), label);
  gtk_label_set_xalign(GTK_LABEL(label_widget), 0.0f);
  gtk_widget_set_halign(label_widget, GTK_ALIGN_START);
  gtk_widget_set_hexpand(label_widget, TRUE);
 
  gtk_box_pack_start(GTK_BOX(box), label_widget, TRUE, TRUE, 0);
  gtk_box_pack_end(GTK_BOX(box), image_widget, FALSE, FALSE, 0);
  gtk_container_add(GTK_CONTAINER(menu_item), box);
  gtk_menu_item_set_reserve_indicator(GTK_MENU_ITEM(menu_item), FALSE);
  gtk_menu_shell_append(GTK_MENU_SHELL(menu), menu_item);
 
  if(activate_callback) g_signal_connect(G_OBJECT(menu_item), "activate", G_CALLBACK(activate_callback), user_data);
 
  return menu_item;
}
 
GtkWidget *ctx_gtk_check_menu_item_new_with_markup(const char *label,
                                                   GtkWidget *menu,
                                                   void (*activate_callback)(GtkWidget *widget, gpointer user_data),
                                                   gpointer user_data,
                                                   const gboolean checked,
                                                   const gboolean show_checkbox)
{
  GtkWidget *menu_item = gtk_check_menu_item_new();
  GtkWidget *box = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, DT_GUI_BOX_SPACING);
  GtkWidget *label_widget = gtk_label_new(NULL);
 
  gtk_label_set_markup(GTK_LABEL(label_widget), label);
  gtk_label_set_xalign(GTK_LABEL(label_widget), 0.0f);
  gtk_widget_set_halign(label_widget, GTK_ALIGN_START);
  gtk_widget_set_hexpand(label_widget, TRUE);
  gtk_widget_set_hexpand(box, TRUE);
  gtk_widget_set_halign(box, GTK_ALIGN_FILL);
 
  gtk_box_pack_start(GTK_BOX(box), label_widget, TRUE, TRUE, 0);
  gtk_container_add(GTK_CONTAINER(menu_item), box);
  gtk_check_menu_item_set_active(GTK_CHECK_MENU_ITEM(menu_item), checked);
  if(show_checkbox)
    gtk_style_context_add_class(gtk_widget_get_style_context(menu_item), "dt-masks-inverse-item");
  else
    gtk_style_context_add_class(gtk_widget_get_style_context(menu_item), "dt-masks-hide-check");
 
  if(checked)
  {
    gtk_style_context_add_class(gtk_widget_get_style_context(menu_item), "dt-masks-checked");
    gtk_style_context_add_class(gtk_widget_get_style_context(label_widget), "dt-masks-checked-label");
  }
  gtk_menu_item_set_reserve_indicator(GTK_MENU_ITEM(menu_item), FALSE);
  gtk_menu_shell_append(GTK_MENU_SHELL(menu), menu_item);
 
  if(activate_callback) g_signal_connect(G_OBJECT(menu_item), "activate", G_CALLBACK(activate_callback), user_data);
 
  return menu_item;
}
 
GtkWidget *ctx_gtk_check_menu_item_new_with_markup_and_pixbuf(const char *label, GdkPixbuf *icon,
                                                                 GtkWidget *menu,
                                                                 void (*activate_callback)(GtkWidget *widget, gpointer user_data),
                                                                 gpointer user_data,
                                                                 const gboolean checked,
                                                                 const gboolean show_checkbox)
{
  GtkWidget *menu_item = gtk_check_menu_item_new();
  GtkWidget *box = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, DT_GUI_BOX_SPACING);
  GtkWidget *left_box = gtk_box_new(GTK_ORIENTATION_HORIZONTAL, DT_GUI_BOX_SPACING);
  GtkWidget *image_widget = icon ? gtk_image_new_from_pixbuf(icon) : gtk_image_new();
  GtkWidget *label_widget = gtk_label_new(NULL);
 
  gtk_label_set_markup(GTK_LABEL(label_widget), label);
  gtk_label_set_xalign(GTK_LABEL(label_widget), 0.0f);
  gtk_widget_set_halign(label_widget, GTK_ALIGN_START);
  gtk_widget_set_hexpand(label_widget, TRUE);
  gtk_widget_set_hexpand(left_box, TRUE);
  gtk_widget_set_halign(left_box, GTK_ALIGN_FILL);
  gtk_widget_set_hexpand(box, TRUE);
  gtk_widget_set_halign(box, GTK_ALIGN_FILL);
  gtk_widget_set_halign(image_widget, GTK_ALIGN_END);
 
  gtk_box_pack_start(GTK_BOX(left_box), label_widget, TRUE, TRUE, 0);
  gtk_box_pack_start(GTK_BOX(box), left_box, TRUE, TRUE, 0);
  gtk_box_pack_end(GTK_BOX(box), image_widget, FALSE, FALSE, 0);
  gtk_container_add(GTK_CONTAINER(menu_item), box);
  gtk_check_menu_item_set_active(GTK_CHECK_MENU_ITEM(menu_item), checked);
  if(show_checkbox)
    gtk_style_context_add_class(gtk_widget_get_style_context(menu_item), "dt-masks-inverse-item");
  else
    gtk_style_context_add_class(gtk_widget_get_style_context(menu_item), "dt-masks-hide-check");
 
  if(checked)
  {
    gtk_style_context_add_class(gtk_widget_get_style_context(menu_item), "dt-masks-checked");
    gtk_style_context_add_class(gtk_widget_get_style_context(label_widget), "dt-masks-checked-label");
  }
  gtk_menu_item_set_reserve_indicator(GTK_MENU_ITEM(menu_item), FALSE);
  gtk_menu_shell_append(GTK_MENU_SHELL(menu), menu_item);
 
  if(activate_callback) g_signal_connect(G_OBJECT(menu_item), "activate", G_CALLBACK(activate_callback), user_data);
 
  return menu_item;
}
 
 
dt_menu_entry_t *set_menu_entry(GtkWidget **menus, GList **items_list,
                                const gchar *label, dt_menus_t menu_index,
                                GtkMenu *parent,
                                void *data,
                                gboolean (*action_callback)(GtkAccelGroup *group, GObject *acceleratable, guint keyval, GdkModifierType mods, gpointer user_data),
                                gboolean (*checked_callback)(GtkWidget *widget),
                                gboolean (*active_callback)(GtkWidget *widget),
                                gboolean (*sensitive_callback)(GtkWidget *widget), guint key_val,
                                GdkModifierType mods, GtkAccelGroup *accel_group)
{
  if(IS_NULL_PTR(label)) label = "";
 
  // Alloc and set to 0
  dt_menu_entry_t *entry = calloc(1, sizeof(dt_menu_entry_t));
 
  // Main widget
  if(checked_callback)
  {
    entry->widget = gtk_check_menu_item_new_with_label("");
    entry->style = DT_MENU_ENTRY_CHECKBUTTON;
  }
  else
  {
    entry->widget = gtk_menu_item_new_with_label("");
    entry->style = DT_MENU_ENTRY_DEFAULT;
  }
 
  // Set the text label allowing markup
  GtkWidget *child = gtk_bin_get_child(GTK_BIN(entry->widget));
  gtk_label_set_markup(GTK_LABEL(child), label);
 
  // Store arbitrary data in the GtkWidget if needed
  if(data)
    g_object_set_data(G_OBJECT(entry->widget), "custom-data", data);
 
  gtk_widget_show_all(GTK_WIDGET(entry->widget));
 
  entry->menu = menu_index;
  entry->accel_group = accel_group;
  entry->action_callback = action_callback;
  entry->checked_callback = checked_callback;
  entry->sensitive_callback = sensitive_callback;
  entry->active_callback = active_callback;
 
  // Wire the accelerator
  // Publish a new accel to the global map and attach it to the menu entry widget
  if(!IS_NULL_PTR(action_callback))
  {    
    // Register accel only if requested
    if(!IS_NULL_PTR(accel_group))
    {
      gchar *clean_label = strip_markup(label);
 
      const gchar *parent_path = gtk_menu_get_accel_path(parent);
 
      dt_accels_new_action_shortcut(
          dt_gui_get_accels(), action_callback, entry->widget, entry->widget, accel_group,
          parent_path, clean_label,
          key_val, mods, FALSE, _("Triggers the action"));
 
      gchar *path = dt_accels_build_path(parent_path, clean_label);
      gtk_widget_set_accel_path(entry->widget, path, (!IS_NULL_PTR(action_callback)) ? accel_group : NULL);
 
      // GtkAccelLabel would otherwise read the accel path's live GtkAccelMap entry itself, but
      // that entry must keep GDK_MOD2_MASK (needed for gtk_accel_map_save() to collapse it to
      // the portable "<Primary>" token -- see widgets/accelerators.h's DT_PRIMARY_MASK doc
      // comment), and GTK only ever renders the "⌘" glyph for GDK_META_MASK, never
      // GDK_MOD2_MASK. update_entry() re-asserts the display-swapped accel on every menu open
      // (gtk_accel_label_set_accel() overrides the accel-path-driven value), so this is just
      // the initial value shown before the menu is ever opened.
      GtkAccelKey initial_key = { 0 };
      if(gtk_accel_map_lookup_entry(path, &initial_key) && initial_key.accel_key)
        gtk_accel_label_set_accel(GTK_ACCEL_LABEL(child), initial_key.accel_key,
                                  dt_accels_display_mods(initial_key.accel_mods));
 
      entry->accel_path = path; // transfer ownership, see update_entry()
      dt_free(clean_label);
    }
    else
    {
      // Show a fake shortcut
      gtk_accel_label_set_accel(GTK_ACCEL_LABEL(child), key_val, dt_accels_display_mods(mods));
    }
 
    g_signal_connect(G_OBJECT(entry->widget), "activate", G_CALLBACK(_activate_callback_to_action_callback), entry);
  }
 
  // Add it to the list of menus items for easy sequential access later
  *items_list = g_list_append(*items_list, entry);
  g_signal_connect(G_OBJECT(entry->widget), "destroy", G_CALLBACK(_menu_entry_destroy), entry);
  //fprintf(stdout, "menu %s, ref is at %p, list it as %p\n", label, items_list, *items_list);
 
  return entry;
}
 
 
void update_entry(dt_menu_entry_t *entry)
{
  // Use the callbacks functions to update the visual properties of the menu entry
  if(entry->style > DT_MENU_ENTRY_DEFAULT)
  {
    // Set the visible state of the checkbox without actually triggering the callback running on activation
    // Gtk has no concept of "set costmetic active state" for checkboxes.
    g_signal_handlers_block_matched(G_OBJECT(entry->widget), G_SIGNAL_MATCH_FUNC, 0, 0, NULL, _activate_callback_to_action_callback, entry);
    gtk_check_menu_item_set_active(GTK_CHECK_MENU_ITEM(entry->widget), entry->checked_callback(entry->widget));
    g_signal_handlers_unblock_matched(G_OBJECT(entry->widget), G_SIGNAL_MATCH_FUNC, 0, 0, NULL, _activate_callback_to_action_callback, entry);
  }
 
  if(entry->sensitive_callback)
    gtk_widget_set_sensitive(entry->widget, entry->sensitive_callback(entry->widget));
 
  if(entry->active_callback)
  {
    if(entry->active_callback(entry->widget))
      dt_gui_add_class(entry->widget, "menu-active");
    else
      dt_gui_remove_class(entry->widget, "menu-active");
  }
 
  // Re-assert the display-swapped accelerator (see set_menu_entry()'s doc comment) every time
  // the menu is opened, since the user may have rebound this shortcut since the last open, and
  // gtk_accel_label_set_accel() does not itself track the live GtkAccelMap entry.
  if(entry->accel_path)
  {
    GtkAccelKey key = { 0 };
    GtkWidget *child = gtk_bin_get_child(GTK_BIN(entry->widget));
    if(gtk_accel_map_lookup_entry(entry->accel_path, &key) && key.accel_key)
      gtk_accel_label_set_accel(GTK_ACCEL_LABEL(child), key.accel_key, dt_accels_display_mods(key.accel_mods));
    else
      gtk_accel_label_set_accel(GTK_ACCEL_LABEL(child), 0, 0);
  }
}
 
void update_menu_entries(GtkWidget *widget, gpointer user_data)
{
  // Update the graphic state of all sub-menu entries from the current top-level menu
  // but only when it is opened.
  GList **lists = (GList **)user_data;
  //fprintf(stdout, "ref is at %p, list it at %p\n", lists, *lists);
 
  if(lists && *lists)
  {
    GList *entries = *lists;
    for(GList *entry_iter = g_list_first(entries); entry_iter; entry_iter = g_list_next(entry_iter))
    {
      dt_menu_entry_t *entry = (dt_menu_entry_t *)(entry_iter->data);
      if(entry) update_entry(entry);
    }
  }
}
 
// Use for first-level entries in any menubar
void add_generic_top_menu_entry(GtkWidget *menu_bar, GtkWidget **menus, GList **lists, const dt_menus_t index,
                                gchar *label, GtkAccelGroup *accel_group, const char *accel_path_prefix)
{
  // Top menus belong to menu bar : file, edit, display, etc.
  menus[index] = gtk_menu_new();
  gtk_menu_set_accel_group(GTK_MENU(menus[index]), accel_group);
 
  gchar *clean_label = strip_markup(label);
 
  gchar *accel_path = dt_accels_build_path(accel_path_prefix, clean_label);
  gtk_menu_set_accel_path(GTK_MENU(menus[index]), accel_path);
  dt_free(clean_label);
  dt_free(accel_path);
 
  GtkWidget *menu_label = gtk_menu_item_new_with_mnemonic(label);
  gtk_menu_item_set_submenu(GTK_MENU_ITEM(menu_label), menus[index]);
  gtk_menu_shell_append(GTK_MENU_SHELL(menu_bar), menu_label);
  dt_gui_add_class(menu_label, "top-level-item");
  g_signal_connect(G_OBJECT(menu_label), "activate", G_CALLBACK(update_menu_entries), lists);
}
 
 
// Use for first-level entries in the global menubar
void add_top_menu_entry(GtkWidget *menu_bar, GtkWidget **menus, GList **lists, const dt_menus_t index, gchar *label)
{
  // Top menus belong to menu bar : file, edit, display, etc.
  add_generic_top_menu_entry(menu_bar, menus, lists, index, label, dt_gui_get_accels()->global_accels, "Global/Menu");
}
 
// Special submenus entries that only open a sub-submenu
void add_generic_top_submenu_entry(GtkWidget **menus, GList **lists, const gchar *label, const dt_menus_t index, GtkAccelGroup *accel_group)
{
  GtkWidget *submenu = gtk_menu_new();
  gtk_menu_set_accel_group(GTK_MENU(submenu), accel_group);
 
  gchar *clean_label = strip_markup(label);
 
  gchar *accel_path = dt_accels_build_path(gtk_menu_get_accel_path(GTK_MENU(menus[index])), clean_label);
  gtk_menu_set_accel_path(GTK_MENU(submenu), accel_path);
  dt_free(clean_label);
  dt_free(accel_path);
 
  dt_menu_entry_t *entry = set_menu_entry(menus, lists, label, index, GTK_MENU(menus[index]), NULL, NULL, NULL, NULL, NULL, 0, 0, accel_group);
  gtk_menu_item_set_submenu(GTK_MENU_ITEM(entry->widget), submenu);
  gtk_menu_shell_append(GTK_MENU_SHELL(menus[index]), entry->widget);
  // We don't take callbacks for top submenus, they do nothing more than opening sub-submenues.
}
 
// Global menu only
void add_top_submenu_entry(GtkWidget **menus, GList **lists, const gchar *label, const dt_menus_t index)
{
  add_generic_top_submenu_entry(menus, lists, label, index, dt_gui_get_accels()->global_accels);
}
 
 
void add_generic_sub_menu_entry(GtkWidget **menus, GList **lists, const gchar *label, const dt_menus_t index,
                                void *data,
                                gboolean (*action_callback)(GtkAccelGroup *group, GObject *acceleratable,
                                                            guint keyval, GdkModifierType mods, gpointer user_data),
                                gboolean (*checked_callback)(GtkWidget *widget),
                                gboolean (*active_callback)(GtkWidget *widget),
                                gboolean (*sensitive_callback)(GtkWidget *widget), guint key_val,
                                GdkModifierType mods, GtkAccelGroup *accel_group)
{
  // Default submenu entries
  dt_menu_entry_t *entry = set_menu_entry(menus, lists, label, index, GTK_MENU(menus[index]),
                                          data,
                                          action_callback, checked_callback,
                                          active_callback, sensitive_callback,
                                          key_val, mods, accel_group);
 
  gtk_menu_shell_append(GTK_MENU_SHELL(menus[index]), entry->widget);
  gtk_menu_item_set_reserve_indicator(GTK_MENU_ITEM(entry->widget), TRUE);
}
 
 
void add_sub_menu_entry(GtkWidget **menus, GList **lists, const gchar *label, const dt_menus_t index, void *data,
                        gboolean (*action_callback)(GtkAccelGroup *group, GObject *acceleratable, guint keyval,
                                                    GdkModifierType mods, gpointer user_data),
                        gboolean (*checked_callback)(GtkWidget *widget),
                        gboolean (*active_callback)(GtkWidget *widget),
                        gboolean (*sensitive_callback)(GtkWidget *widget), guint key_val, GdkModifierType mods)
{
  add_generic_sub_menu_entry(menus, lists, label, index, data, action_callback, checked_callback, active_callback,
                             sensitive_callback, key_val, mods, dt_gui_get_accels()->global_accels);
}
 
void add_no_accel_sub_menu_entry(GtkWidget **menus, GList **lists, const gchar *label, const dt_menus_t index,
                                void *data,
                                gboolean (*action_callback)(GtkAccelGroup *group, GObject *acceleratable,
                                                            guint keyval, GdkModifierType mods, gpointer user_data),
                                gboolean (*checked_callback)(GtkWidget *widget),
                                gboolean (*active_callback)(GtkWidget *widget),
                                gboolean (*sensitive_callback)(GtkWidget *widget), guint key_val,
                                GdkModifierType mods)
{
  add_generic_sub_menu_entry(menus, lists, label, index, data, action_callback, checked_callback, active_callback,
                             sensitive_callback, key_val, mods, NULL);
}
 
void add_generic_sub_sub_menu_entry(GtkWidget **menus, GtkWidget *parent, GList **lists, const gchar *label,
                                    const dt_menus_t index, void *data,
                                    gboolean (*action_callback)(GtkAccelGroup *group, GObject *acceleratable,
                                                                guint keyval, GdkModifierType mods,
                                                                gpointer user_data),
                                    gboolean (*checked_callback)(GtkWidget *widget),
                                    gboolean (*active_callback)(GtkWidget *widget),
                                    gboolean (*sensitive_callback)(GtkWidget *widget), guint key_val,
                                    GdkModifierType mods, GtkAccelGroup *accel_group)
{
  // Submenu of submenus entries
  dt_menu_entry_t *entry = set_menu_entry(
      menus, lists, label, index, GTK_MENU(gtk_menu_item_get_submenu(GTK_MENU_ITEM(parent))), data,
      action_callback, checked_callback, active_callback, sensitive_callback, key_val, mods, accel_group);
 
  gtk_menu_shell_append(GTK_MENU_SHELL(gtk_menu_item_get_submenu(GTK_MENU_ITEM(parent))), entry->widget);
}
 
void add_sub_sub_menu_entry(GtkWidget **menus, GtkWidget *parent, GList **lists, const gchar *label,
                            const dt_menus_t index, void *data,
                            gboolean (*action_callback)(GtkAccelGroup *group, GObject *acceleratable, guint keyval,
                                                        GdkModifierType mods, gpointer user_data),
                            gboolean (*checked_callback)(GtkWidget *widget),
                            gboolean (*active_callback)(GtkWidget *widget),
                            gboolean (*sensitive_callback)(GtkWidget *widget), guint key_val, GdkModifierType mods)
{
  add_generic_sub_sub_menu_entry(menus, parent, lists, label, index, data, action_callback, checked_callback,
                                 active_callback, sensitive_callback, key_val, mods, dt_gui_get_accels()->global_accels);
}
 
// We don't go further than 3 levels of menus. This is not a Dassault Systems software.
 
void add_menu_separator(GtkWidget *menu)
{
  GtkWidget *sep = gtk_separator_menu_item_new();
  gtk_menu_shell_append(GTK_MENU_SHELL(menu), sep);
  gtk_widget_show(sep);
}
 
void add_sub_menu_separator(GtkWidget *parent)
{
  GtkWidget *sep = gtk_separator_menu_item_new();
  gtk_menu_shell_append(GTK_MENU_SHELL(gtk_menu_item_get_submenu(GTK_MENU_ITEM(parent))), sep);
  gtk_widget_show(sep);
}
 
void * get_custom_data(GtkWidget *widget)
{
  // Grab custom data optionnaly passed by pointer to the menuitem widget
  return g_object_get_data(G_OBJECT(widget), "custom-data");
}
 
GtkWidget * get_last_widget(GList **list)
{
  GList *last_entry = g_list_last(*list);
  GtkWidget *w = NULL;
  if(last_entry)
  {
    dt_menu_entry_t *entry = (dt_menu_entry_t *)(last_entry)->data;
    if(entry && entry->widget) w = entry->widget;
  }
  return w;
}
 
gboolean has_selection()
{
  // Can be used to set menu items sensitivity when image(s) is/are selected
  return dt_selection_get_length(dt_selection_get_global()) > 0;
}
 
gboolean has_active_images()
{
  return dt_act_on_get_images_nb(FALSE, FALSE) > 0;
}
 
gboolean _is_lighttable()
{
  const dt_view_t *cv = dt_view_manager_get_current_view(dt_view_manager_get_global());
  return cv && !g_strcmp0(cv->module_name, "lighttable");
}
 
gboolean _is_darkroom()
{
  const dt_view_t *cv = dt_view_manager_get_current_view(dt_view_manager_get_global());
  return cv && !g_strcmp0(cv->module_name, "darkroom");
}
 
gboolean has_active_image_in_lighttable()
{
  const gboolean image = has_active_images();
  const gboolean lighttable = _is_lighttable();
  return image && lighttable;
}
 
// dt_menu_is_image_in_dev() / dt_apply_dev_history_update() now live in
// develop/dev_history.c -- they are develop/darkroom concerns, not menu concerns, and are
// shared with common/history_actions.c and gui/actions/styles.c.