gtkmenuitem.c 33 KB
Newer Older
Elliot Lee's avatar
Elliot Lee committed
1 2 3 4
/* GTK - The GIMP Toolkit
 * 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 11
 * 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
 * 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
15 16 17
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
Elliot Lee's avatar
Elliot Lee committed
18
 */
19 20

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

27 28
#define GTK_MENU_INTERNALS

Elliot Lee's avatar
Elliot Lee committed
29
#include <string.h>
Tim Janik's avatar
Tim Janik committed
30
#include "gtkaccellabel.h"
Elliot Lee's avatar
Elliot Lee committed
31
#include "gtkmain.h"
32
#include "gtkmarshalers.h"
Elliot Lee's avatar
Elliot Lee committed
33
#include "gtkmenu.h"
34
#include "gtkmenubar.h"
Elliot Lee's avatar
Elliot Lee committed
35
#include "gtkmenuitem.h"
36
#include "gtkseparatormenuitem.h"
Elliot Lee's avatar
Elliot Lee committed
37 38 39 40
#include "gtksignal.h"


#define BORDER_SPACING  3
41
#define SELECT_TIMEOUT  75
Elliot Lee's avatar
Elliot Lee committed
42 43 44 45 46 47

#define MENU_ITEM_CLASS(w)  GTK_MENU_ITEM_CLASS (GTK_OBJECT (w)->klass)


enum {
  ACTIVATE,
48
  ACTIVATE_ITEM,
49 50
  TOGGLE_SIZE_REQUEST,
  TOGGLE_SIZE_ALLOCATE,
Elliot Lee's avatar
Elliot Lee committed
51 52 53 54 55 56 57
  LAST_SIGNAL
};


static void gtk_menu_item_class_init     (GtkMenuItemClass *klass);
static void gtk_menu_item_init           (GtkMenuItem      *menu_item);
static void gtk_menu_item_destroy        (GtkObject        *object);
58
static void gtk_menu_item_finalize       (GObject          *object);
Elliot Lee's avatar
Elliot Lee committed
59 60 61 62
static void gtk_menu_item_size_request   (GtkWidget        *widget,
					  GtkRequisition   *requisition);
static void gtk_menu_item_size_allocate  (GtkWidget        *widget,
					  GtkAllocation    *allocation);
63 64 65 66
static void gtk_menu_item_realize        (GtkWidget        *widget);
static void gtk_menu_item_unrealize      (GtkWidget        *widget);
static void gtk_menu_item_map            (GtkWidget        *widget);
static void gtk_menu_item_unmap          (GtkWidget        *widget);
Elliot Lee's avatar
Elliot Lee committed
67 68 69 70
static void gtk_menu_item_paint          (GtkWidget        *widget,
					  GdkRectangle     *area);
static gint gtk_menu_item_expose         (GtkWidget        *widget,
					  GdkEventExpose   *event);
71 72
static void gtk_menu_item_parent_set     (GtkWidget        *widget,
					  GtkWidget        *previous_parent);
73

74

75 76 77 78
static void gtk_real_menu_item_select               (GtkItem     *item);
static void gtk_real_menu_item_deselect             (GtkItem     *item);
static void gtk_real_menu_item_activate_item        (GtkMenuItem *item);
static void gtk_real_menu_item_toggle_size_request  (GtkMenuItem *menu_item,
79
						     gint        *requisition);
80
static void gtk_real_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
81
						     gint         allocation);
82
static gboolean gtk_menu_item_mnemonic_activate     (GtkWidget   *widget,
83
						     gboolean     group_cycling);
84

Elliot Lee's avatar
Elliot Lee committed
85
static gint gtk_menu_item_select_timeout (gpointer          data);
86
static void gtk_menu_item_popup_submenu  (gpointer     data);
Elliot Lee's avatar
Elliot Lee committed
87 88 89
static void gtk_menu_item_position_menu  (GtkMenu          *menu,
					  gint             *x,
					  gint             *y,
90
					  gboolean         *push_in,
Elliot Lee's avatar
Elliot Lee committed
91
					  gpointer          user_data);
92 93
static void gtk_menu_item_show_all       (GtkWidget        *widget);
static void gtk_menu_item_hide_all       (GtkWidget        *widget);
94 95 96 97
static void gtk_menu_item_forall         (GtkContainer    *container,
					  gboolean         include_internals,
					  GtkCallback      callback,
					  gpointer         callback_data);
Elliot Lee's avatar
Elliot Lee committed
98

99

Elliot Lee's avatar
Elliot Lee committed
100
static GtkItemClass *parent_class;
101
static guint menu_item_signals[LAST_SIGNAL] = { 0 };
102 103
static guint32	last_submenu_deselect_time = 0;

Elliot Lee's avatar
Elliot Lee committed
104 105


Tim Janik's avatar
Tim Janik committed
106
GtkType
107
gtk_menu_item_get_type (void)
Elliot Lee's avatar
Elliot Lee committed
108
{
Tim Janik's avatar
Tim Janik committed
109
  static GtkType menu_item_type = 0;
Elliot Lee's avatar
Elliot Lee committed
110 111 112

  if (!menu_item_type)
    {
113
      static const GTypeInfo menu_item_info =
Elliot Lee's avatar
Elliot Lee committed
114 115
      {
	sizeof (GtkMenuItemClass),
116 117 118 119 120 121 122 123
	NULL,           /* base_init */
	NULL,           /* base_finalize */
	(GClassInitFunc) gtk_menu_item_class_init,
	NULL,           /* class_finalize */
	NULL,           /* class_data */
	sizeof (GtkMenuItem),
	16,             /* n_preallocs */
	(GInstanceInitFunc) gtk_menu_item_init,
Elliot Lee's avatar
Elliot Lee committed
124 125
      };

126
      menu_item_type = g_type_register_static (GTK_TYPE_ITEM, "GtkMenuItem", &menu_item_info, 0);
Elliot Lee's avatar
Elliot Lee committed
127 128 129 130 131 132 133 134
    }

  return menu_item_type;
}

static void
gtk_menu_item_class_init (GtkMenuItemClass *klass)
{
135 136 137 138 139
  GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
  GtkObjectClass *object_class = GTK_OBJECT_CLASS (klass);
  GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
  GtkContainerClass *container_class = GTK_CONTAINER_CLASS (klass);
  GtkItemClass *item_class = GTK_ITEM_CLASS (klass);
Elliot Lee's avatar
Elliot Lee committed
140

141
  parent_class = g_type_class_peek_parent (klass);
Elliot Lee's avatar
Elliot Lee committed
142

143
  gobject_class->finalize = gtk_menu_item_finalize;
144 145 146 147 148 149

  object_class->destroy = gtk_menu_item_destroy;

  widget_class->size_request = gtk_menu_item_size_request;
  widget_class->size_allocate = gtk_menu_item_size_allocate;
  widget_class->expose_event = gtk_menu_item_expose;
150 151 152 153
  widget_class->realize = gtk_menu_item_realize;
  widget_class->unrealize = gtk_menu_item_unrealize;
  widget_class->map = gtk_menu_item_map;
  widget_class->unmap = gtk_menu_item_unmap;
154 155
  widget_class->show_all = gtk_menu_item_show_all;
  widget_class->hide_all = gtk_menu_item_hide_all;
156
  widget_class->mnemonic_activate = gtk_menu_item_mnemonic_activate;
157
  widget_class->parent_set = gtk_menu_item_parent_set;
158
  
159 160 161 162 163 164 165 166 167 168 169 170
  container_class->forall = gtk_menu_item_forall;

  item_class->select = gtk_real_menu_item_select;
  item_class->deselect = gtk_real_menu_item_deselect;

  klass->activate = NULL;
  klass->activate_item = gtk_real_menu_item_activate_item;
  klass->toggle_size_request = gtk_real_menu_item_toggle_size_request;
  klass->toggle_size_allocate = gtk_real_menu_item_toggle_size_allocate;

  klass->hide_on_activate = TRUE;

Elliot Lee's avatar
Elliot Lee committed
171 172
  menu_item_signals[ACTIVATE] =
    gtk_signal_new ("activate",
173
                    GTK_RUN_FIRST | GTK_RUN_ACTION,
174
                    GTK_CLASS_TYPE (object_class),
Elliot Lee's avatar
Elliot Lee committed
175
                    GTK_SIGNAL_OFFSET (GtkMenuItemClass, activate),
176
                    _gtk_marshal_VOID__VOID,
Elliot Lee's avatar
Elliot Lee committed
177
		    GTK_TYPE_NONE, 0);
178
  widget_class->activate_signal = menu_item_signals[ACTIVATE];
Elliot Lee's avatar
Elliot Lee committed
179

180 181 182
  menu_item_signals[ACTIVATE_ITEM] =
    gtk_signal_new ("activate_item",
                    GTK_RUN_FIRST,
183
                    GTK_CLASS_TYPE (object_class),
184 185 186 187
                    GTK_SIGNAL_OFFSET (GtkMenuItemClass, activate_item),
                    gtk_signal_default_marshaller,
		    GTK_TYPE_NONE, 0);

188 189 190 191 192
  menu_item_signals[TOGGLE_SIZE_REQUEST] =
    gtk_signal_new ("toggle_size_request",
                    GTK_RUN_FIRST,
                    GTK_CLASS_TYPE (object_class),
                    GTK_SIGNAL_OFFSET (GtkMenuItemClass, toggle_size_request),
193
                    _gtk_marshal_VOID__POINTER,
194
		    GTK_TYPE_NONE, 1,
195
		    GTK_TYPE_POINTER);
196 197 198 199 200 201

  menu_item_signals[TOGGLE_SIZE_ALLOCATE] =
    gtk_signal_new ("toggle_size_allocate",
                    GTK_RUN_FIRST,
                    GTK_CLASS_TYPE (object_class),
                    GTK_SIGNAL_OFFSET (GtkMenuItemClass, toggle_size_allocate),
202
                    _gtk_marshal_NONE__INT,
203
		    GTK_TYPE_NONE, 1,
204
		    GTK_TYPE_INT);
205 206 207 208 209 210 211 212 213

  gtk_widget_class_install_style_property_parser (widget_class,
						  g_param_spec_enum ("selected_shadow_type",
								     "Selected Shadow Type",
								     "Shadow type when item is selected",
								     GTK_TYPE_SHADOW_TYPE,
								     GTK_SHADOW_OUT,
								     G_PARAM_READABLE),
						  gtk_rc_property_parse_enum);
Elliot Lee's avatar
Elliot Lee committed
214 215 216 217 218
}

static void
gtk_menu_item_init (GtkMenuItem *menu_item)
{
219 220
  GTK_WIDGET_SET_FLAGS (menu_item, GTK_NO_WINDOW);
  
Elliot Lee's avatar
Elliot Lee committed
221 222
  menu_item->submenu = NULL;
  menu_item->toggle_size = 0;
223
  menu_item->accelerator_width = 0;
Elliot Lee's avatar
Elliot Lee committed
224 225 226 227 228 229 230 231 232
  menu_item->show_submenu_indicator = FALSE;
  menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
  menu_item->submenu_placement = GTK_TOP_BOTTOM;
  menu_item->right_justify = FALSE;

  menu_item->timer = 0;
}

GtkWidget*
233
gtk_menu_item_new (void)
Elliot Lee's avatar
Elliot Lee committed
234 235 236 237 238 239 240 241
{
  return GTK_WIDGET (gtk_type_new (gtk_menu_item_get_type ()));
}

GtkWidget*
gtk_menu_item_new_with_label (const gchar *label)
{
  GtkWidget *menu_item;
Tim Janik's avatar
Tim Janik committed
242
  GtkWidget *accel_label;
Elliot Lee's avatar
Elliot Lee committed
243 244

  menu_item = gtk_menu_item_new ();
Tim Janik's avatar
Tim Janik committed
245 246
  accel_label = gtk_accel_label_new (label);
  gtk_misc_set_alignment (GTK_MISC (accel_label), 0.0, 0.5);
Elliot Lee's avatar
Elliot Lee committed
247

Tim Janik's avatar
Tim Janik committed
248 249 250
  gtk_container_add (GTK_CONTAINER (menu_item), accel_label);
  gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (accel_label), menu_item);
  gtk_widget_show (accel_label);
Elliot Lee's avatar
Elliot Lee committed
251 252 253 254

  return menu_item;
}

255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283

/**
 * gtk_menu_item_new_with_mnemonic:
 * @label: The text of the button, with an underscore in front of the
 *         mnemonic character
 * @returns: a new #GtkMenuItem
 *
 * Creates a new #GtkMenuItem containing a label. The label
 * will be created using gtk_label_new_with_mnemonic(), so underscores
 * in @label indicate the mnemonic for the menu item.
 **/
GtkWidget*
gtk_menu_item_new_with_mnemonic (const gchar *label)
{
  GtkWidget *menu_item;
  GtkWidget *accel_label;

  menu_item = gtk_menu_item_new ();
  accel_label = gtk_type_new (GTK_TYPE_ACCEL_LABEL);
  gtk_label_set_text_with_mnemonic (GTK_LABEL (accel_label), label);
  gtk_misc_set_alignment (GTK_MISC (accel_label), 0.0, 0.5);

  gtk_container_add (GTK_CONTAINER (menu_item), accel_label);
  gtk_accel_label_set_accel_widget (GTK_ACCEL_LABEL (accel_label), menu_item);
  gtk_widget_show (accel_label);

  return menu_item;
}

Elliot Lee's avatar
Elliot Lee committed
284 285 286 287 288 289 290 291 292 293
static void
gtk_menu_item_destroy (GtkObject *object)
{
  GtkMenuItem *menu_item;

  g_return_if_fail (GTK_IS_MENU_ITEM (object));

  menu_item = GTK_MENU_ITEM (object);

  if (menu_item->submenu)
294
    gtk_widget_destroy (menu_item->submenu);
Elliot Lee's avatar
Elliot Lee committed
295

296 297 298 299 300 301 302 303 304 305 306
  GTK_OBJECT_CLASS (parent_class)->destroy (object);
}

static void
gtk_menu_item_finalize (GObject *object)
{
  GtkMenuItem *menu_item = GTK_MENU_ITEM (object);

  g_free (menu_item->accel_path);

  G_OBJECT_CLASS (parent_class)->finalize (object);
Elliot Lee's avatar
Elliot Lee committed
307 308
}

309 310 311 312 313 314 315 316 317 318 319 320 321 322
static void
gtk_menu_item_detacher (GtkWidget     *widget,
			GtkMenu       *menu)
{
  GtkMenuItem *menu_item;

  g_return_if_fail (GTK_IS_MENU_ITEM (widget));

  menu_item = GTK_MENU_ITEM (widget);
  g_return_if_fail (menu_item->submenu == (GtkWidget*) menu);

  menu_item->submenu = NULL;
}

Elliot Lee's avatar
Elliot Lee committed
323 324 325 326 327
void
gtk_menu_item_set_submenu (GtkMenuItem *menu_item,
			   GtkWidget   *submenu)
{
  g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
328
  
329
  if (menu_item->submenu != submenu)
Elliot Lee's avatar
Elliot Lee committed
330
    {
331 332
      gtk_menu_item_remove_submenu (menu_item);
      
333
      menu_item->submenu = submenu;
334 335 336 337
      gtk_menu_attach_to_widget (GTK_MENU (submenu),
				 GTK_WIDGET (menu_item),
				 gtk_menu_item_detacher);
      
338 339
      if (GTK_WIDGET (menu_item)->parent)
	gtk_widget_queue_resize (GTK_WIDGET (menu_item));
Elliot Lee's avatar
Elliot Lee committed
340 341 342
    }
}

343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359
/**
 * gtk_menu_item_get_submenu:
 * @menu_item: a #GtkMenuItem
 *
 * Gets the submenu underneath this menu item, if any. See
 * gtk_menu_item_set_submenu().
 *
 * Return value: submenu for this menu item, or %NULL if none.
 **/
GtkWidget *
gtk_menu_item_get_submenu (GtkMenuItem *menu_item)
{
  g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), NULL);

  return menu_item->submenu;
}

360 361 362 363 364 365 366 367 368
void
gtk_menu_item_remove_submenu (GtkMenuItem         *menu_item)
{
  g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
      
  if (menu_item->submenu)
    gtk_menu_detach (GTK_MENU (menu_item->submenu));
}

369 370 371
void _gtk_menu_item_set_placement (GtkMenuItem         *menu_item,
				   GtkSubmenuPlacement  placement);

Elliot Lee's avatar
Elliot Lee committed
372
void
Owen Taylor's avatar
Owen Taylor committed
373
_gtk_menu_item_set_placement (GtkMenuItem         *menu_item,
Elliot Lee's avatar
Elliot Lee committed
374 375 376 377 378 379 380 381 382 383
			     GtkSubmenuPlacement  placement)
{
  g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));

  menu_item->submenu_placement = placement;
}

void
gtk_menu_item_select (GtkMenuItem *menu_item)
{
384 385
  g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
  
Elliot Lee's avatar
Elliot Lee committed
386 387 388 389 390 391
  gtk_item_select (GTK_ITEM (menu_item));
}

void
gtk_menu_item_deselect (GtkMenuItem *menu_item)
{
392 393
  g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
  
Elliot Lee's avatar
Elliot Lee committed
394 395 396 397 398 399
  gtk_item_deselect (GTK_ITEM (menu_item));
}

void
gtk_menu_item_activate (GtkMenuItem *menu_item)
{
400 401
  g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
  
Elliot Lee's avatar
Elliot Lee committed
402 403 404
  gtk_signal_emit (GTK_OBJECT (menu_item), menu_item_signals[ACTIVATE]);
}

405 406
void
gtk_menu_item_toggle_size_request (GtkMenuItem *menu_item,
407
				   gint        *requisition)
408 409 410 411 412 413 414 415
{
  g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));

  gtk_signal_emit (GTK_OBJECT (menu_item), menu_item_signals[TOGGLE_SIZE_REQUEST], requisition);
}

void
gtk_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
416
				    gint         allocation)
417 418 419 420 421 422
{
  g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));

  gtk_signal_emit (GTK_OBJECT (menu_item), menu_item_signals[TOGGLE_SIZE_ALLOCATE], allocation);
}

423 424 425 426 427 428 429 430 431 432
static void
gtk_menu_item_accel_width_foreach (GtkWidget *widget,
				   gpointer data)
{
  guint *width = data;

  if (GTK_IS_ACCEL_LABEL (widget))
    {
      guint w;

433
      w = gtk_accel_label_get_accel_width (GTK_ACCEL_LABEL (widget));
434 435 436 437 438 439 440
      *width = MAX (*width, w);
    }
  else if (GTK_IS_CONTAINER (widget))
    gtk_container_foreach (GTK_CONTAINER (widget),
			   gtk_menu_item_accel_width_foreach,
			   data);
}
Elliot Lee's avatar
Elliot Lee committed
441 442 443 444 445

static void
gtk_menu_item_size_request (GtkWidget      *widget,
			    GtkRequisition *requisition)
{
Tim Janik's avatar
Tim Janik committed
446
  GtkMenuItem *menu_item;
Elliot Lee's avatar
Elliot Lee committed
447
  GtkBin *bin;
448
  guint accel_width;
Elliot Lee's avatar
Elliot Lee committed
449 450 451 452 453

  g_return_if_fail (GTK_IS_MENU_ITEM (widget));
  g_return_if_fail (requisition != NULL);

  bin = GTK_BIN (widget);
Tim Janik's avatar
Tim Janik committed
454
  menu_item = GTK_MENU_ITEM (widget);
Elliot Lee's avatar
Elliot Lee committed
455 456

  requisition->width = (GTK_CONTAINER (widget)->border_width +
457
			widget->style->xthickness +
Elliot Lee's avatar
Elliot Lee committed
458 459
			BORDER_SPACING) * 2;
  requisition->height = (GTK_CONTAINER (widget)->border_width +
460
			 widget->style->ythickness) * 2;
Elliot Lee's avatar
Elliot Lee committed
461 462 463

  if (bin->child && GTK_WIDGET_VISIBLE (bin->child))
    {
464 465 466
      GtkRequisition child_requisition;
      
      gtk_widget_size_request (bin->child, &child_requisition);
Elliot Lee's avatar
Elliot Lee committed
467

468 469
      requisition->width += child_requisition.width;
      requisition->height += child_requisition.height;
470

471 472 473
      if (menu_item->submenu && menu_item->show_submenu_indicator)
	requisition->width += child_requisition.height;
    }
474 475 476 477 478 479

  accel_width = 0;
  gtk_container_foreach (GTK_CONTAINER (menu_item),
			 gtk_menu_item_accel_width_foreach,
			 &accel_width);
  menu_item->accelerator_width = accel_width;
Elliot Lee's avatar
Elliot Lee committed
480 481 482 483 484 485
}

static void
gtk_menu_item_size_allocate (GtkWidget     *widget,
			     GtkAllocation *allocation)
{
Tim Janik's avatar
Tim Janik committed
486
  GtkMenuItem *menu_item;
Elliot Lee's avatar
Elliot Lee committed
487 488 489 490 491 492
  GtkBin *bin;
  GtkAllocation child_allocation;

  g_return_if_fail (GTK_IS_MENU_ITEM (widget));
  g_return_if_fail (allocation != NULL);

Tim Janik's avatar
Tim Janik committed
493
  menu_item = GTK_MENU_ITEM (widget);
Elliot Lee's avatar
Elliot Lee committed
494
  bin = GTK_BIN (widget);
Tim Janik's avatar
Tim Janik committed
495 496
  
  widget->allocation = *allocation;
Elliot Lee's avatar
Elliot Lee committed
497 498 499 500

  if (bin->child)
    {
      child_allocation.x = (GTK_CONTAINER (widget)->border_width +
501
                            widget->style->xthickness +
Elliot Lee's avatar
Elliot Lee committed
502
			    BORDER_SPACING);
Owen Taylor's avatar
Owen Taylor committed
503
      child_allocation.y = (GTK_CONTAINER (widget)->border_width +
504
			    widget->style->ythickness);
505 506
      child_allocation.width = MAX (1, (gint)allocation->width - child_allocation.x * 2);
      child_allocation.height = MAX (1, (gint)allocation->height - child_allocation.y * 2);
Elliot Lee's avatar
Elliot Lee committed
507
      child_allocation.x += GTK_MENU_ITEM (widget)->toggle_size;
Tim Janik's avatar
Tim Janik committed
508
      child_allocation.width -= GTK_MENU_ITEM (widget)->toggle_size;
509 510 511
      child_allocation.x += widget->allocation.x;
      child_allocation.y += widget->allocation.y;
      
Tim Janik's avatar
Tim Janik committed
512
      if (menu_item->submenu && menu_item->show_submenu_indicator)
513 514
	child_allocation.width -= child_allocation.height;

Elliot Lee's avatar
Elliot Lee committed
515 516 517
      gtk_widget_size_allocate (bin->child, &child_allocation);
    }

Tim Janik's avatar
Tim Janik committed
518
  if (GTK_WIDGET_REALIZED (widget))
519
    gdk_window_move_resize (menu_item->event_window,
Tim Janik's avatar
Tim Janik committed
520 521
                            allocation->x, allocation->y,
                            allocation->width, allocation->height);
Elliot Lee's avatar
Elliot Lee committed
522

Tim Janik's avatar
Tim Janik committed
523 524
  if (menu_item->submenu)
    gtk_menu_reposition (GTK_MENU (menu_item->submenu));
Elliot Lee's avatar
Elliot Lee committed
525 526
}

527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578
static void
gtk_menu_item_realize (GtkWidget *widget)
{
  GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
  GdkWindowAttr attributes;
  gint attributes_mask;

  GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);

  widget->window = gtk_widget_get_parent_window (widget);
  gdk_window_ref (widget->window);
  
  attributes.x = widget->allocation.x;
  attributes.y = widget->allocation.y;
  attributes.width = widget->allocation.width;
  attributes.height = widget->allocation.height;
  attributes.window_type = GDK_WINDOW_CHILD;
  attributes.wclass = GDK_INPUT_ONLY;
  attributes.event_mask = (gtk_widget_get_events (widget) |
			   GDK_EXPOSURE_MASK |
			   GDK_BUTTON_PRESS_MASK |
			   GDK_BUTTON_RELEASE_MASK |
			   GDK_ENTER_NOTIFY_MASK |
			   GDK_LEAVE_NOTIFY_MASK |
			   GDK_POINTER_MOTION_MASK);

  attributes_mask = GDK_WA_X | GDK_WA_Y;
  menu_item->event_window = gdk_window_new (gtk_widget_get_parent_window (widget), &attributes, attributes_mask);
  gdk_window_set_user_data (menu_item->event_window, widget);

  widget->style = gtk_style_attach (widget->style, widget->window);
}

static void
gtk_menu_item_unrealize (GtkWidget *widget)
{
  GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);

  gdk_window_set_user_data (menu_item->event_window, NULL);
  gdk_window_destroy (menu_item->event_window);
  menu_item->event_window = NULL;
  
  if (GTK_WIDGET_CLASS (parent_class)->unrealize)
    (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
}

static void
gtk_menu_item_map (GtkWidget *widget)
{
  GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
  
  GTK_WIDGET_CLASS (parent_class)->map (widget);
579 580

  gdk_window_show (menu_item->event_window);
581 582 583 584 585 586 587 588 589 590 591 592
}

static void
gtk_menu_item_unmap (GtkWidget *widget)
{
  GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
    
  gdk_window_hide (menu_item->event_window);

  GTK_WIDGET_CLASS (parent_class)->unmap (widget);
}

Elliot Lee's avatar
Elliot Lee committed
593 594 595 596 597 598
static void
gtk_menu_item_paint (GtkWidget    *widget,
		     GdkRectangle *area)
{
  GtkMenuItem *menu_item;
  GtkStateType state_type;
599
  GtkShadowType shadow_type, selected_shadow_type;
Elliot Lee's avatar
Elliot Lee committed
600 601
  gint width, height;
  gint x, y;
602
  gint border_width = GTK_CONTAINER (widget)->border_width;
Elliot Lee's avatar
Elliot Lee committed
603 604 605 606 607 608 609

  if (GTK_WIDGET_DRAWABLE (widget))
    {
      menu_item = GTK_MENU_ITEM (widget);

      state_type = widget->state;

610 611 612 613
      x = widget->allocation.x + border_width;
      y = widget->allocation.y + border_width;
      width = widget->allocation.width - border_width * 2;
      height = widget->allocation.height - border_width * 2;
614
      
Elliot Lee's avatar
Elliot Lee committed
615 616
      if ((state_type == GTK_STATE_PRELIGHT) &&
	  (GTK_BIN (menu_item)->child))
617 618 619 620 621 622 623 624 625 626 627 628
	{
	  gtk_widget_style_get (widget,
				"selected_shadow_type", &selected_shadow_type,
				NULL);
	  gtk_paint_box (widget->style,
			 widget->window,
			 GTK_STATE_PRELIGHT,
			 selected_shadow_type,
			 area, widget, "menuitem",
			 x, y, width, height);
	}
  
Tim Janik's avatar
Tim Janik committed
629
      if (menu_item->submenu && menu_item->show_submenu_indicator)
Elliot Lee's avatar
Elliot Lee committed
630
	{
631
	  GtkRequisition child_requisition;
632
	  gint arrow_x, arrow_y;
633 634 635 636 637 638 639 640
	  gint arrow_size;
	  gint arrow_extent;

	  gtk_widget_get_child_requisition (GTK_BIN (menu_item)->child,
					    &child_requisition);

	  arrow_size = child_requisition.height - 2 * widget->style->ythickness;
	  arrow_extent = arrow_size * 0.6;
641
	  
Elliot Lee's avatar
Elliot Lee committed
642 643 644 645
	  shadow_type = GTK_SHADOW_OUT;
	  if (state_type == GTK_STATE_PRELIGHT)
	    shadow_type = GTK_SHADOW_IN;

646 647 648
	  arrow_x = x + width - 1 - arrow_size + (arrow_size - arrow_extent) / 2;
	  arrow_y = y + (height - arrow_extent) / 2;

649 650 651 652
	  gtk_paint_arrow (widget->style, widget->window,
			   state_type, shadow_type, 
			   area, widget, "menuitem", 
			   GTK_ARROW_RIGHT, TRUE,
653 654
			   arrow_x, arrow_y,
			   arrow_extent, arrow_extent);
Elliot Lee's avatar
Elliot Lee committed
655 656 657
	}
      else if (!GTK_BIN (menu_item)->child)
	{
658 659 660 661
	  gtk_paint_hline (widget->style, widget->window, GTK_STATE_NORMAL,
			   area, widget, "menuitem",
			   widget->allocation.x, widget->allocation.width,
			   widget->allocation.y);
Elliot Lee's avatar
Elliot Lee committed
662 663 664 665 666 667 668 669 670 671 672 673 674 675 676
	}
    }
}

static gint
gtk_menu_item_expose (GtkWidget      *widget,
		      GdkEventExpose *event)
{
  g_return_val_if_fail (GTK_IS_MENU_ITEM (widget), FALSE);
  g_return_val_if_fail (event != NULL, FALSE);

  if (GTK_WIDGET_DRAWABLE (widget))
    {
      gtk_menu_item_paint (widget, &event->area);

677
      (* GTK_WIDGET_CLASS (parent_class)->expose_event) (widget, event);
Elliot Lee's avatar
Elliot Lee committed
678 679 680 681 682 683 684 685 686 687 688 689 690 691
    }

  return FALSE;
}

static void
gtk_real_menu_item_select (GtkItem *item)
{
  GtkMenuItem *menu_item;

  g_return_if_fail (GTK_IS_MENU_ITEM (item));

  menu_item = GTK_MENU_ITEM (item);

692 693 694
  /*  if (menu_item->submenu && !GTK_WIDGET_VISIBLE (menu_item->submenu))*/
  if (menu_item->submenu)
    {
695 696 697 698
      guint32 etime;
      GdkEvent *event = gtk_get_current_event ();

      etime = event ? gdk_event_get_time (event) : GDK_CURRENT_TIME;
699 700
      if (event &&
	  etime >= last_submenu_deselect_time &&
701
	  last_submenu_deselect_time + SELECT_TIMEOUT > etime)
702 703 704 705 706 707 708 709 710 711 712 713
	{
	  if (!menu_item->timer)
	    menu_item->timer = gtk_timeout_add (SELECT_TIMEOUT - (etime - last_submenu_deselect_time),
						gtk_menu_item_select_timeout,
						menu_item);
	  if (event &&
	      event->type != GDK_BUTTON_PRESS &&
	      event->type != GDK_ENTER_NOTIFY)
	    menu_item->timer_from_keypress = TRUE;
	  else
	    menu_item->timer_from_keypress = FALSE;
	}
714
      else
715
	gtk_menu_item_popup_submenu (menu_item);
716 717
      if (event)
	gdk_event_free(event);
718
    }
719
  
Elliot Lee's avatar
Elliot Lee committed
720 721 722 723 724 725 726 727 728 729 730 731 732 733 734
  gtk_widget_set_state (GTK_WIDGET (menu_item), GTK_STATE_PRELIGHT);
  gtk_widget_draw (GTK_WIDGET (menu_item), NULL);
}

static void
gtk_real_menu_item_deselect (GtkItem *item)
{
  GtkMenuItem *menu_item;

  g_return_if_fail (GTK_IS_MENU_ITEM (item));

  menu_item = GTK_MENU_ITEM (item);

  if (menu_item->submenu)
    {
735 736 737
      guint32 etime;
      GdkEvent *event = gtk_get_current_event ();

Elliot Lee's avatar
Elliot Lee committed
738
      if (menu_item->timer)
739 740 741 742
	{
	  gtk_timeout_remove (menu_item->timer);
	  menu_item->timer = 0;
	}
Elliot Lee's avatar
Elliot Lee committed
743 744
      else
	gtk_menu_popdown (GTK_MENU (menu_item->submenu));
745 746 747 748

      etime = event ? gdk_event_get_time (event) : GDK_CURRENT_TIME;
      if (etime > last_submenu_deselect_time)
	last_submenu_deselect_time = etime;
749 750
      if (event)
	gdk_event_free(event);
Elliot Lee's avatar
Elliot Lee committed
751 752 753 754 755 756
    }

  gtk_widget_set_state (GTK_WIDGET (menu_item), GTK_STATE_NORMAL);
  gtk_widget_draw (GTK_WIDGET (menu_item), NULL);
}

757
static gboolean
758
gtk_menu_item_mnemonic_activate (GtkWidget *widget,
759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775
				 gboolean   group_cycling)
{
  if (group_cycling)
    {
      if (widget->parent &&
	  GTK_IS_MENU_SHELL (widget->parent))
	gtk_menu_shell_select_item (GTK_MENU_SHELL (widget->parent),
				    widget);

    }
  else
    gtk_signal_emit (GTK_OBJECT (widget), menu_item_signals[ACTIVATE_ITEM]);
  
  return TRUE;
}


776 777 778 779
static void
gtk_real_menu_item_activate_item (GtkMenuItem *menu_item)
{
  GtkWidget *widget;
780
  GtkMenuShell *submenu; 
781 782 783 784 785 786 787 788 789 790 791 792 793 794 795

  g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));

  widget = GTK_WIDGET (menu_item);
  
  if (widget->parent &&
      GTK_IS_MENU_SHELL (widget->parent))
    {
      if (menu_item->submenu == NULL)
	gtk_menu_shell_activate_item (GTK_MENU_SHELL (widget->parent),
				      widget, TRUE);
      else
	{
	  GtkMenuShell *menu_shell = GTK_MENU_SHELL (widget->parent);

796
	  _gtk_menu_shell_activate (menu_shell);
797

798 799 800
	  gtk_menu_shell_select_item (GTK_MENU_SHELL (widget->parent), widget); 
	  gtk_menu_item_popup_submenu (widget); 

801
	  _gtk_menu_shell_select_first (GTK_MENU_SHELL (menu_item->submenu));
802
	  submenu = GTK_MENU_SHELL (menu_item->submenu);
803 804 805
	}
    }
}
806 807
static void
gtk_real_menu_item_toggle_size_request (GtkMenuItem *menu_item,
808
					gint        *requisition)
809 810 811 812 813 814 815 816
{
  g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));

  *requisition = 0;
}

static void
gtk_real_menu_item_toggle_size_allocate (GtkMenuItem *menu_item,
817
					 gint         allocation)
818 819 820 821 822
{
  g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));

  menu_item->toggle_size = allocation;
}
823

Elliot Lee's avatar
Elliot Lee committed
824 825 826
static gint
gtk_menu_item_select_timeout (gpointer data)
{
827
  GtkMenuItem *menu_item;
828
  GtkWidget *parent;
829
  
830
  GDK_THREADS_ENTER ();
831

832
  menu_item = GTK_MENU_ITEM (data);
833 834 835 836 837 838 839 840 841

  parent = GTK_WIDGET (menu_item)->parent;

  if (parent && GTK_IS_MENU_SHELL (parent) && GTK_MENU_SHELL (parent)->active)
    {
      gtk_menu_item_popup_submenu (data);
      if (menu_item->timer_from_keypress && menu_item->submenu)
	GTK_MENU_SHELL (menu_item->submenu)->ignore_enter = TRUE;
    }
842 843 844 845 846 847 848

  GDK_THREADS_LEAVE ();

  return FALSE;  
}

static void
849
gtk_menu_item_popup_submenu (gpointer data)
850 851 852
{
  GtkMenuItem *menu_item;

Elliot Lee's avatar
Elliot Lee committed
853 854 855
  menu_item = GTK_MENU_ITEM (data);
  menu_item->timer = 0;

856
  if (GTK_WIDGET_IS_SENSITIVE (menu_item->submenu))
857
    {
858 859 860 861 862 863 864
      gtk_menu_popup (GTK_MENU (menu_item->submenu),
		      GTK_WIDGET (menu_item)->parent,
		      GTK_WIDGET (menu_item),
		      gtk_menu_item_position_menu,
		      menu_item,
		      GTK_MENU_SHELL (GTK_WIDGET (menu_item)->parent)->button,
		      0);
865
    }
Elliot Lee's avatar
Elliot Lee committed
866 867 868 869 870 871
}

static void
gtk_menu_item_position_menu (GtkMenu  *menu,
			     gint     *x,
			     gint     *y,
872
			     gboolean *push_in,
Elliot Lee's avatar
Elliot Lee committed
873 874 875
			     gpointer  user_data)
{
  GtkMenuItem *menu_item;
876
  GtkWidget *widget;
Tim Janik's avatar
Tim Janik committed
877
  GtkWidget *parent_menu_item;
Elliot Lee's avatar
Elliot Lee committed
878 879 880 881 882 883 884 885 886 887
  gint screen_width;
  gint screen_height;
  gint twidth, theight;
  gint tx, ty;

  g_return_if_fail (menu != NULL);
  g_return_if_fail (x != NULL);
  g_return_if_fail (y != NULL);

  menu_item = GTK_MENU_ITEM (user_data);
888
  widget = GTK_WIDGET (user_data);
Elliot Lee's avatar
Elliot Lee committed
889 890 891 892 893 894 895

  twidth = GTK_WIDGET (menu)->requisition.width;
  theight = GTK_WIDGET (menu)->requisition.height;

  screen_width = gdk_screen_width ();
  screen_height = gdk_screen_height ();

896
  if (!gdk_window_get_origin (widget->window, &tx, &ty))
Owen Taylor's avatar
Owen Taylor committed
897 898 899 900
    {
      g_warning ("Menu not on screen");
      return;
    }
Elliot Lee's avatar
Elliot Lee committed
901

902 903 904
  tx += widget->allocation.x;
  ty += widget->allocation.y;

Elliot Lee's avatar
Elliot Lee committed
905 906 907
  switch (menu_item->submenu_placement)
    {
    case GTK_TOP_BOTTOM:
908 909
      if ((ty + widget->allocation.height + theight) <= screen_height)
	ty += widget->allocation.height;
Elliot Lee's avatar
Elliot Lee committed
910 911
      else if ((ty - theight) >= 0)
	ty -= theight;
912 913
      else if (screen_height - (ty + widget->allocation.height) > ty)
	ty += widget->allocation.height;
914 915
      else
	ty -= theight;
Elliot Lee's avatar
Elliot Lee committed
916 917 918 919
      break;

    case GTK_LEFT_RIGHT:
      menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
920
      parent_menu_item = GTK_MENU (widget->parent)->parent_menu_item;
Elliot Lee's avatar
Elliot Lee committed
921
      if (parent_menu_item)
Tim Janik's avatar
Tim Janik committed
922
	menu_item->submenu_direction = GTK_MENU_ITEM (parent_menu_item)->submenu_direction;
Elliot Lee's avatar
Elliot Lee committed
923 924 925 926 927 928 929 930 931

      switch (menu_item->submenu_direction)
	{
	case GTK_DIRECTION_LEFT:
	  if ((tx - twidth) >= 0)
	    tx -= twidth;
	  else
	    {
	      menu_item->submenu_direction = GTK_DIRECTION_RIGHT;
932
	      tx += widget->allocation.width - 5;
Elliot Lee's avatar
Elliot Lee committed
933 934 935 936
	    }
	  break;

	case GTK_DIRECTION_RIGHT:
937 938
	  if ((tx + widget->allocation.width + twidth - 5) <= screen_width)
	    tx += widget->allocation.width - 5;
Elliot Lee's avatar
Elliot Lee committed
939 940 941 942 943 944 945 946
	  else
	    {
	      menu_item->submenu_direction = GTK_DIRECTION_LEFT;
	      tx -= twidth;
	    }
	  break;
	}

947
      ty += widget->allocation.height / 4;
948

949 950
      /* If the height of the menu doesn't fit we move it upward. */
      ty = CLAMP (ty, 0, MAX (0, screen_height - theight));
Elliot Lee's avatar
Elliot Lee committed
951 952 953
      break;
    }

954 955
  /* If we have negative, tx, here it is because we can't get
   * the menu all the way on screen. Favor the left portion.
956 957
   */
  *x = CLAMP (tx, 0, MAX (0, screen_width - twidth));
958
  *y = ty;
Elliot Lee's avatar
Elliot Lee committed
959 960
}

961 962 963 964 965 966 967 968 969 970 971 972
/**
 * gtk_menu_item_set_right_justified:
 * @menu_item: a #GtkMenuItem.
 * @right_justified: if %TRUE the menu item will appear at the 
 *   far right if added to a menu bar.
 * 
 * Sets whether the menu item appears justified at the right
 * side of a menu bar. This was traditionally done for "Help" menu
 * items, but is now considered a bad idea. (If the widget
 * layout is reversed for a right-to-left language like Hebrew
 * or Arabic, right-justified-menu-items appear at the left.)
 **/
Elliot Lee's avatar
Elliot Lee committed
973
void
974 975
gtk_menu_item_set_right_justified (GtkMenuItem *menu_item,
				   gboolean     right_justified)
Elliot Lee's avatar
Elliot Lee committed
976
{
977 978 979
  g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));

  right_justified = right_justified != FALSE;
Elliot Lee's avatar
Elliot Lee committed
980

981 982 983
  if (right_justified != menu_item->right_justify)
    {
      menu_item->right_justify = right_justified;
984
      gtk_widget_queue_resize (GTK_WIDGET (menu_item));
985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003
    }
}

/**
 * gtk_menu_item_get_right_justified:
 * @menu_item: a #GtkMenuItem
 * 
 * Gets whether the menu item appears justified at the right
 * side of the menu bar.
 * 
 * Return value: %TRUE if the menu item will appear at the
 *   far right if added to a menu bar.
 **/
gboolean
gtk_menu_item_get_right_justified (GtkMenuItem *menu_item)
{
  g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), FALSE);
  
  return menu_item->right_justify;
Elliot Lee's avatar
Elliot Lee committed
1004
}
1005

1006

1007 1008 1009
static void
gtk_menu_item_show_all (GtkWidget *widget)
{
1010
  GtkMenuItem *menu_item;
1011 1012

  g_return_if_fail (GTK_IS_MENU_ITEM (widget));
1013

1014 1015
  menu_item = GTK_MENU_ITEM (widget);

1016
  /* show children including submenu */
1017 1018
  if (menu_item->submenu)
    gtk_widget_show_all (menu_item->submenu);
1019 1020
  gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_show_all, NULL);

1021 1022 1023 1024 1025 1026
  gtk_widget_show (widget);
}

static void
gtk_menu_item_hide_all (GtkWidget *widget)
{
1027
  GtkMenuItem *menu_item;
1028 1029 1030 1031

  g_return_if_fail (GTK_IS_MENU_ITEM (widget));

  gtk_widget_hide (widget);
1032 1033 1034 1035 1036

  menu_item = GTK_MENU_ITEM (widget);

  /* hide children including submenu */
  gtk_container_foreach (GTK_CONTAINER (widget), (GtkCallback) gtk_widget_hide_all, NULL);
1037 1038
  if (menu_item->submenu)
    gtk_widget_hide_all (menu_item->submenu);
1039 1040
}

1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061
static void
gtk_menu_item_accel_name_foreach (GtkWidget *widget,
				  gpointer data)
{
  const gchar **path_p = data;

  if (!*path_p)
    {
      if (GTK_IS_LABEL (widget))
	{
	  *path_p = gtk_label_get_text (GTK_LABEL (widget));
	  if (*path_p && (*path_p)[0] == 0)
	    *path_p = NULL;
	}
      else if (GTK_IS_CONTAINER (widget))
	gtk_container_foreach (GTK_CONTAINER (widget),
			       gtk_menu_item_accel_name_foreach,
			       data);
    }
}

1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078
static void
gtk_menu_item_parent_set (GtkWidget *widget,
			  GtkWidget *previous_parent)
{
  GtkMenuItem *menu_item = GTK_MENU_ITEM (widget);
  GtkMenu *menu = GTK_IS_MENU (widget->parent) ? GTK_MENU (widget->parent) : NULL;

  if (menu)
    _gtk_menu_item_refresh_accel_path (menu_item,
				       menu->accel_path,
				       menu->accel_group,
				       TRUE);

  if (GTK_WIDGET_CLASS (parent_class)->parent_set)
    GTK_WIDGET_CLASS (parent_class)->parent_set (widget, previous_parent);
}

1079 1080 1081 1082 1083 1084 1085 1086 1087 1088
void
_gtk_menu_item_refresh_accel_path (GtkMenuItem   *menu_item,
				   const gchar   *prefix,
				   GtkAccelGroup *accel_group,
				   gboolean       group_changed)
{
  const gchar *path;
  GtkWidget *widget;

  g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
1089
  g_return_if_fail (!accel_group || GTK_IS_ACCEL_GROUP (accel_group));
1090 1091 1092

  widget = GTK_WIDGET (menu_item);

1093 1094
  if (!accel_group)
    {
1095
      gtk_widget_set_accel_path (widget, NULL, NULL);
1096 1097 1098
      return;
    }

1099
  path = _gtk_widget_get_accel_path (widget, NULL);
1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114
  if (!path)					/* no active accel_path yet */
    {
      path = menu_item->accel_path;
      if (!path && prefix)
	{
	  gchar *postfix = NULL;

	  /* try to construct one from label text */
	  gtk_container_foreach (GTK_CONTAINER (menu_item),
				 gtk_menu_item_accel_name_foreach,
				 &postfix);
	  menu_item->accel_path = postfix ? g_strconcat (prefix, "/", postfix, NULL) : NULL;
	  path = menu_item->accel_path;
	}
      if (path)
1115
	gtk_widget_set_accel_path (widget, path, accel_group);
1116 1117
    }
  else if (group_changed)			/* reinstall accelerators */
1118
    gtk_widget_set_accel_path (widget, path, accel_group);
1119 1120 1121 1122 1123
}

/**
 * gtk_menu_item_set_accel_path
 * @menu_item:  a valid #GtkMenuItem
Matthias Clasen's avatar
Matthias Clasen committed
1124
 * @accel_path: accelerator path, corresponding to this menu item's functionality
1125 1126 1127 1128 1129 1130 1131 1132
 *
 * Set the accelerator path on @menu_item, through which runtime changes of the
 * menu item's accelerator caused by the user can be identified and saved to
 * persistant storage (see gtk_accel_map_save() on this).
 * To setup a default accelerator for this menu item, call
 * gtk_accel_map_add_entry() with the same @accel_path.
 * See also gtk_accel_map_add_entry() on the specifics of accelerator paths,
 * and gtk_menu_set_accel_path() for a more convenient variant of this function.
1133 1134 1135 1136
 *
 * This function is basically a convenience wrapper that handles calling
 * gtk_widget_set_accel_path() with the appropriate accelerator group for
 * the menu item.
1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153
 */
void
gtk_menu_item_set_accel_path (GtkMenuItem *menu_item,
			      const gchar *accel_path)
{
  GtkWidget *widget;

  g_return_if_fail (GTK_IS_MENU_ITEM (menu_item));
  g_return_if_fail (accel_path && accel_path[0] == '<' && strchr (accel_path, '/'));

  widget = GTK_WIDGET (menu_item);

  /* store new path */
  g_free (menu_item->accel_path);
  menu_item->accel_path = g_strdup (accel_path);

  /* forget accelerators associated with old path */
1154
  gtk_widget_set_accel_path (widget, NULL, NULL);
1155 1156

  /* install accelerators associated with new path */
1157
  if (widget->parent && GTK_IS_MENU (widget->parent))
1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168
    {
      GtkMenu *menu = GTK_MENU (widget->parent);

      if (menu->accel_group)
	_gtk_menu_item_refresh_accel_path (GTK_MENU_ITEM (widget),
					   NULL,
					   menu->accel_group,
					   FALSE);
    }
}

1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184
static void
gtk_menu_item_forall (GtkContainer *container,
		      gboolean      include_internals,
		      GtkCallback   callback,
		      gpointer      callback_data)
{
  GtkBin *bin;
  GtkMenuItem *menu_item;

  g_return_if_fail (GTK_IS_MENU_ITEM (container));
  g_return_if_fail (callback != NULL);

  bin = GTK_BIN (container);
  menu_item = GTK_MENU_ITEM (container);

  if (bin->child)
1185
    callback (bin->child, callback_data);
1186
}
1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199

gboolean
_gtk_menu_item_is_selectable (GtkWidget *menu_item)
{
  if ((!GTK_BIN (menu_item)->child &&
       G_OBJECT_TYPE (menu_item) == GTK_TYPE_MENU_ITEM) ||
      GTK_IS_SEPARATOR_MENU_ITEM (menu_item) ||
      !GTK_WIDGET_IS_SENSITIVE (menu_item) ||
      !GTK_WIDGET_VISIBLE (menu_item))
    return FALSE;

  return TRUE;
}