gtkmenu.h 9.51 KB
Newer Older
Cody Russell's avatar
Cody Russell committed
1
/* GTK - The GIMP Toolkit
Elliot Lee's avatar
Elliot Lee committed
2 3 4
 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
 *
 * This library is free software; you can redistribute it and/or
5
 * modify it under the terms of the GNU Lesser General Public
Elliot Lee's avatar
Elliot Lee committed
6 7 8 9 10
 * License as published by the Free Software Foundation; either
 * version 2 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
Tim Janik's avatar
Tim Janik committed
11
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU
12
 * Lesser General Public License for more details.
Elliot Lee's avatar
Elliot Lee committed
13
 *
14
 * You should have received a copy of the GNU Lesser General Public
Javier Jardon's avatar
Javier Jardon committed
15
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
Elliot Lee's avatar
Elliot Lee committed
16
 */
17 18

/*
19
 * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
20 21
 * file for a list of people on the GTK+ Team.  See the ChangeLog
 * files for a list of changes.  These files are distributed with
22
 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
23 24
 */

Elliot Lee's avatar
Elliot Lee committed
25 26 27 28
#ifndef __GTK_MENU_H__
#define __GTK_MENU_H__


29 30 31 32
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
#error "Only <gtk/gtk.h> can be included directly."
#endif

Tim Janik's avatar
Tim Janik committed
33
#include <gtk/gtkaccelgroup.h>
Elliot Lee's avatar
Elliot Lee committed
34 35 36
#include <gtk/gtkmenushell.h>


37
G_BEGIN_DECLS
Elliot Lee's avatar
Elliot Lee committed
38

Tim Janik's avatar
Tim Janik committed
39
#define GTK_TYPE_MENU			(gtk_menu_get_type ())
Manish Singh's avatar
Manish Singh committed
40 41 42 43 44
#define GTK_MENU(obj)			(G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_MENU, GtkMenu))
#define GTK_MENU_CLASS(klass)		(G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_MENU, GtkMenuClass))
#define GTK_IS_MENU(obj)		(G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_MENU))
#define GTK_IS_MENU_CLASS(klass)	(G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_MENU))
#define GTK_MENU_GET_CLASS(obj)         (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_MENU, GtkMenuClass))
Elliot Lee's avatar
Elliot Lee committed
45 46


47 48 49
typedef struct _GtkMenu        GtkMenu;
typedef struct _GtkMenuClass   GtkMenuClass;
typedef struct _GtkMenuPrivate GtkMenuPrivate;
Elliot Lee's avatar
Elliot Lee committed
50

Matthias Clasen's avatar
Matthias Clasen committed
51 52 53 54 55 56 57 58 59 60 61 62 63 64 65
/**
 * GtkArrowPlacement:
 * @GTK_ARROWS_BOTH: Place one arrow on each end of the menu.
 * @GTK_ARROWS_START: Place both arrows at the top of the menu.
 * @GTK_ARROWS_END: Place both arrows at the bottom of the menu.
 *
 * Used to specify the placement of scroll arrows in scrolling menus.
 */
typedef enum
{
  GTK_ARROWS_BOTH,
  GTK_ARROWS_START,
  GTK_ARROWS_END
} GtkArrowPlacement;

Pavel Holejsovsky's avatar
Pavel Holejsovsky committed
66 67 68 69 70 71 72
/**
 * GtkMenuPositionFunc:
 * @menu: a #GtkMenu.
 * @x: (out): address of the #gint representing the horizontal
 *     position where the menu shall be drawn.
 * @y: (out): address of the #gint representing the vertical position
 *     where the menu shall be drawn.  This is an output parameter.
73
 * @push_in: (out): This parameter controls how menus placed outside
Pavel Holejsovsky's avatar
Pavel Holejsovsky committed
74 75 76 77 78
 *     the monitor are handled.  If this is set to %TRUE and part of
 *     the menu is outside the monitor then GTK+ pushes the window
 *     into the visible area, effectively modifying the popup
 *     position.  Note that moving and possibly resizing the menu
 *     around will alter the scroll position to keep the menu items
William Jon McCann's avatar
William Jon McCann committed
79
 *     “in place”, i.e. at the same monitor position they would have
Pavel Holejsovsky's avatar
Pavel Holejsovsky committed
80 81 82 83 84 85 86 87 88 89 90 91 92 93
 *     been without resizing.  In practice, this behavior is only
 *     useful for combobox popups or option menus and cannot be used
 *     to simply confine a menu to monitor boundaries.  In that case,
 *     changing the scroll offset is not desirable.
 * @user_data: the data supplied by the user in the gtk_menu_popup()
 *     @data parameter.
 *
 * A user function supplied when calling gtk_menu_popup() which
 * controls the positioning of the menu when it is displayed.  The
 * function sets the @x and @y parameters to the coordinates where the
 * menu is to be drawn.  To make the menu appear on a different
 * monitor than the mouse pointer, gtk_menu_set_monitor() must be
 * called.
 */
Tim Janik's avatar
Tim Janik committed
94 95 96
typedef void (*GtkMenuPositionFunc) (GtkMenu   *menu,
				     gint      *x,
				     gint      *y,
97
				     gboolean  *push_in,
Tim Janik's avatar
Tim Janik committed
98
				     gpointer	user_data);
Pavel Holejsovsky's avatar
Pavel Holejsovsky committed
99 100 101 102 103 104 105 106 107

/**
 * GtkMenuDetachFunc:
 * @attach_widget: the #GtkWidget that the menu is being detached from.
 * @menu: the #GtkMenu being detached.
 *
 * A user function supplied when calling gtk_menu_attach_to_widget() which 
 * will be called when the menu is later detached from the widget.
 */
Tim Janik's avatar
Tim Janik committed
108 109
typedef void (*GtkMenuDetachFunc)   (GtkWidget *attach_widget,
				     GtkMenu   *menu);
Elliot Lee's avatar
Elliot Lee committed
110 111 112

struct _GtkMenu
{
113 114 115 116
  GtkMenuShell menu_shell;

  /*< private >*/
  GtkMenuPrivate *priv;
Elliot Lee's avatar
Elliot Lee committed
117 118 119 120 121
};

struct _GtkMenuClass
{
  GtkMenuShellClass parent_class;
122 123 124 125 126 127

  /* Padding for future expansion */
  void (*_gtk_reserved1) (void);
  void (*_gtk_reserved2) (void);
  void (*_gtk_reserved3) (void);
  void (*_gtk_reserved4) (void);
Elliot Lee's avatar
Elliot Lee committed
128 129 130
};


131
GDK_AVAILABLE_IN_ALL
Manish Singh's avatar
Manish Singh committed
132
GType	   gtk_menu_get_type		  (void) G_GNUC_CONST;
133
GDK_AVAILABLE_IN_ALL
Tim Janik's avatar
Tim Janik committed
134
GtkWidget* gtk_menu_new			  (void);
135
GDK_AVAILABLE_IN_3_4
136
GtkWidget* gtk_menu_new_from_model        (GMenuModel *model);
137 138

/* Display the menu onscreen */
139
GDK_AVAILABLE_IN_ALL
Tim Janik's avatar
Tim Janik committed
140 141 142 143 144 145 146
void	   gtk_menu_popup		  (GtkMenu	       *menu,
					   GtkWidget	       *parent_menu_shell,
					   GtkWidget	       *parent_menu_item,
					   GtkMenuPositionFunc	func,
					   gpointer		data,
					   guint		button,
					   guint32		activate_time);
147
GDK_AVAILABLE_IN_ALL
148 149 150 151 152 153
void       gtk_menu_popup_for_device      (GtkMenu             *menu,
                                           GdkDevice           *device,
                                           GtkWidget           *parent_menu_shell,
                                           GtkWidget           *parent_menu_item,
                                           GtkMenuPositionFunc  func,
                                           gpointer             data,
154
                                           GDestroyNotify       destroy,
155 156 157
                                           guint                button,
                                           guint32              activate_time);

158
/* Position the menu according to its position function. Called
159 160
 * from gtkmenuitem.c when a menu-item changes its allocation
 */
161
GDK_AVAILABLE_IN_ALL
Tim Janik's avatar
Tim Janik committed
162
void	   gtk_menu_reposition		  (GtkMenu	       *menu);
163

164
GDK_AVAILABLE_IN_ALL
Tim Janik's avatar
Tim Janik committed
165
void	   gtk_menu_popdown		  (GtkMenu	       *menu);
166 167 168 169

/* Keep track of the last menu item selected. (For the purposes
 * of the option menu
 */
170
GDK_AVAILABLE_IN_ALL
Tim Janik's avatar
Tim Janik committed
171
GtkWidget* gtk_menu_get_active		  (GtkMenu	       *menu);
172
GDK_AVAILABLE_IN_ALL
Tim Janik's avatar
Tim Janik committed
173
void	   gtk_menu_set_active		  (GtkMenu	       *menu,
Pavel Holejsovsky's avatar
Pavel Holejsovsky committed
174
					   guint		index);
175

176
/* set/get the accelerator group that holds global accelerators (should
177 178
 * be added to the corresponding toplevel with gtk_window_add_accel_group().
 */
179
GDK_AVAILABLE_IN_ALL
180
void	       gtk_menu_set_accel_group	  (GtkMenu	       *menu,
Tim Janik's avatar
Tim Janik committed
181
					   GtkAccelGroup       *accel_group);
182
GDK_AVAILABLE_IN_ALL
183
GtkAccelGroup* gtk_menu_get_accel_group	  (GtkMenu	       *menu);
184
GDK_AVAILABLE_IN_ALL
185 186
void           gtk_menu_set_accel_path    (GtkMenu             *menu,
					   const gchar         *accel_path);
187
GDK_AVAILABLE_IN_ALL
Tim Janik's avatar
Tim Janik committed
188
const gchar*   gtk_menu_get_accel_path    (GtkMenu             *menu);
189 190 191 192 193

/* A reference count is kept for a widget when it is attached to
 * a particular widget. This is typically a menu item; it may also
 * be a widget with a popup menu - for instance, the Notebook widget.
 */
194
GDK_AVAILABLE_IN_ALL
Tim Janik's avatar
Tim Janik committed
195 196 197
void	   gtk_menu_attach_to_widget	  (GtkMenu	       *menu,
					   GtkWidget	       *attach_widget,
					   GtkMenuDetachFunc	detacher);
198
GDK_AVAILABLE_IN_ALL
199 200 201 202 203 204
void	   gtk_menu_detach		  (GtkMenu	       *menu);

/* This should be dumped in favor of data set when the menu is popped
 * up - that is currently in the ItemFactory code, but should be
 * in the Menu code.
 */
205
GDK_AVAILABLE_IN_ALL
206
GtkWidget* gtk_menu_get_attach_widget	  (GtkMenu	       *menu);
207

208
GDK_DEPRECATED_IN_3_10
209
void       gtk_menu_set_tearoff_state     (GtkMenu             *menu,
210 211
                                           gboolean             torn_off);
GDK_DEPRECATED_IN_3_10
212
gboolean   gtk_menu_get_tearoff_state     (GtkMenu             *menu);
213 214 215 216

/* This sets the window manager title for the window that
 * appears when a menu is torn off
 */
217
GDK_DEPRECATED_IN_3_10
218 219
void          gtk_menu_set_title          (GtkMenu             *menu,
                                           const gchar         *title);
220
GDK_DEPRECATED_IN_3_10
221
const gchar * gtk_menu_get_title          (GtkMenu             *menu);
Elliot Lee's avatar
Elliot Lee committed
222

223
GDK_AVAILABLE_IN_ALL
224 225 226 227
void       gtk_menu_reorder_child         (GtkMenu             *menu,
                                           GtkWidget           *child,
                                           gint                position);

228
GDK_AVAILABLE_IN_ALL
229 230
void	   gtk_menu_set_screen		  (GtkMenu	       *menu,
					   GdkScreen	       *screen);
231

232
GDK_AVAILABLE_IN_ALL
233 234 235 236 237 238 239
void       gtk_menu_attach                (GtkMenu             *menu,
                                           GtkWidget           *child,
                                           guint                left_attach,
                                           guint                right_attach,
                                           guint                top_attach,
                                           guint                bottom_attach);

240
GDK_AVAILABLE_IN_ALL
241 242
void       gtk_menu_set_monitor           (GtkMenu             *menu,
                                           gint                 monitor_num);
243
GDK_AVAILABLE_IN_ALL
Tim Janik's avatar
Tim Janik committed
244
gint       gtk_menu_get_monitor           (GtkMenu             *menu);
245
GDK_AVAILABLE_IN_ALL
246
GList*     gtk_menu_get_for_attach_widget (GtkWidget           *widget); 
247

248
GDK_AVAILABLE_IN_ALL
249 250
void     gtk_menu_set_reserve_toggle_size (GtkMenu  *menu,
                                          gboolean   reserve_toggle_size);
251
GDK_AVAILABLE_IN_ALL
252
gboolean gtk_menu_get_reserve_toggle_size (GtkMenu  *menu);
Matthias Clasen's avatar
Matthias Clasen committed
253 254


255
G_END_DECLS
Elliot Lee's avatar
Elliot Lee committed
256 257

#endif /* __GTK_MENU_H__ */