src/ui-menu.h

   1 /*
   2  * Copyright (C) 2004 John Ellis
   3  * Copyright (C) 2008 - 2016 The Geeqie Team
   4  *
   5  * Author: John Ellis
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 2 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License along
  18  * with this program; if not, write to the Free Software Foundation, Inc.,
  19  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  20  */
  21
  22 #ifndef UI_MENU_H
  23 #define UI_MENU_H
  24
  25
  26 #include <gtk/gtk.h>
  27
  28 /**
  29  * @struct hard_coded_window_keys
  30  * @brief hard coded window shortcut keys
  31  *
  32  * Used for two purposes:\n
  33  * to display the shortcuts keys in popup menus\n
  34  * used by ./doc/create-shortcuts-xml.sh to generate shortcut documentation in the Help files
  35  *
  36  */
  37 struct hard_coded_window_keys {
  38         GdkModifierType mask; /**< modifier key mask */
  39         guint key_value;  /**< GDK_keyval */
  40         const gchar *text;  /**< menu item label - NULL if end of list */
  41 };
  42
  43 GtkWidget *menu_item_add(GtkWidget *menu, const gchar *label,
  44                          GCallback func, gpointer data);
  45 GtkWidget *menu_item_add_stock(GtkWidget *menu, const gchar *label, const gchar *stock_id,
  46                                GCallback func, gpointer data);
  47 GtkWidget *menu_item_add_icon(GtkWidget *menu, const gchar *label, const gchar *icon_name,
  48                                GCallback func, gpointer data);
  49 GtkWidget *menu_item_add_sensitive(GtkWidget *menu, const gchar *label, gboolean sensitive,
  50                                    GCallback func, gpointer data);
  51 GtkWidget *menu_item_add_icon_sensitive(GtkWidget *menu, const gchar *label, const gchar *icon_name, gboolean sensitive,
  52                                          GCallback func, gpointer data);
  53 GtkWidget *menu_item_add_stock_sensitive(GtkWidget *menu, const gchar *label, const gchar *stock_id, gboolean sensitive,
  54                                          GCallback func, gpointer data);
  55 GtkWidget *menu_item_add_check(GtkWidget *menu, const gchar *label, gboolean active,
  56                                GCallback func, gpointer data);
  57 GtkWidget *menu_item_add_radio(GtkWidget *menu, const gchar *label, gpointer item_data, gboolean active,
  58                                GCallback func, gpointer data);
  59 void menu_item_add_divider(GtkWidget *menu);
  60
  61 /**
  62  * @headerfile menu_item_add_simple
  63  * use to avoid mnemonics, for example filenames
  64  */
  65 GtkWidget *menu_item_add_simple(GtkWidget *menu, const gchar *label,
  66                                 GCallback func, gpointer data);
  67
  68 GtkWidget *popup_menu_short_lived();
  69
  70 /**
  71  * @headerfile popup_menu_position_clamp
  72  * clamp a menu's position to within the screen
  73  * if menu will attempt to stay out of region y to y+height
  74  */
  75 gboolean popup_menu_position_clamp(GtkMenu *menu, gint *x, gint *y, gint height);
  76
  77
  78 #endif
  79 /* vim: set shiftwidth=8 softtabstop=0 cindent cinoptions={1s: */