1010 lines
		
	
	
		
			31 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			1010 lines
		
	
	
		
			31 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/* 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
 | 
						|
 * modify it under the terms of the GNU Lesser General Public
 | 
						|
 * 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
 | 
						|
 * Lesser General Public License for more details.
 | 
						|
 *
 | 
						|
 * You should have received a copy of the GNU Lesser General Public
 | 
						|
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
 | 
						|
 */
 | 
						|
 | 
						|
/*
 | 
						|
 * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
 | 
						|
 * 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/. 
 | 
						|
 */
 | 
						|
 | 
						|
/**
 | 
						|
 * SECTION:gtkmenubar
 | 
						|
 * @Title: GtkMenuBar
 | 
						|
 * @Short_description: A subclass of GtkMenuShell which holds GtkMenuItem widgets
 | 
						|
 * @See_also: #GtkMenuShell, #GtkMenu, #GtkMenuItem
 | 
						|
 *
 | 
						|
 * The #GtkMenuBar is a subclass of #GtkMenuShell which contains one or
 | 
						|
 * more #GtkMenuItems. The result is a standard menu bar which can hold
 | 
						|
 * many menu items.
 | 
						|
 *
 | 
						|
 * # CSS nodes
 | 
						|
 *
 | 
						|
 * GtkMenuBar has a single CSS node with name menubar.
 | 
						|
 */
 | 
						|
 | 
						|
#include "config.h"
 | 
						|
 | 
						|
#include "gtkmenubar.h"
 | 
						|
 | 
						|
#include "gtkbindings.h"
 | 
						|
#include "gtkcsscustomgadgetprivate.h"
 | 
						|
#include "gtkmain.h"
 | 
						|
#include "gtkmarshalers.h"
 | 
						|
#include "gtkmenuitemprivate.h"
 | 
						|
#include "gtkmenuprivate.h"
 | 
						|
#include "gtkmenushellprivate.h"
 | 
						|
#include "gtkrender.h"
 | 
						|
#include "gtksettings.h"
 | 
						|
#include "gtksizerequest.h"
 | 
						|
#include "gtkwindow.h"
 | 
						|
#include "gtkcontainerprivate.h"
 | 
						|
#include "gtkintl.h"
 | 
						|
#include "gtkprivate.h"
 | 
						|
#include "gtktypebuiltins.h"
 | 
						|
#include "gtkwidgetprivate.h"
 | 
						|
 | 
						|
#define MENU_BAR_POPUP_DELAY 0
 | 
						|
 | 
						|
/* Properties */
 | 
						|
enum {
 | 
						|
  PROP_0,
 | 
						|
  PROP_PACK_DIRECTION,
 | 
						|
  PROP_CHILD_PACK_DIRECTION
 | 
						|
};
 | 
						|
 | 
						|
struct _GtkMenuBarPrivate
 | 
						|
{
 | 
						|
  GtkPackDirection pack_direction;
 | 
						|
  GtkPackDirection child_pack_direction;
 | 
						|
 | 
						|
  GtkCssGadget *gadget;
 | 
						|
};
 | 
						|
 | 
						|
 | 
						|
static void gtk_menu_bar_set_property      (GObject             *object,
 | 
						|
					    guint                prop_id,
 | 
						|
					    const GValue        *value,
 | 
						|
					    GParamSpec          *pspec);
 | 
						|
static void gtk_menu_bar_get_property      (GObject             *object,
 | 
						|
					    guint                prop_id,
 | 
						|
					    GValue              *value,
 | 
						|
					    GParamSpec          *pspec);
 | 
						|
static void gtk_menu_bar_finalize          (GObject             *object);
 | 
						|
static void gtk_menu_bar_get_preferred_width (GtkWidget     *widget,
 | 
						|
					      gint          *minimum,
 | 
						|
					      gint          *natural);
 | 
						|
static void gtk_menu_bar_get_preferred_height (GtkWidget    *widget,
 | 
						|
					       gint         *minimum,
 | 
						|
					       gint         *natural);
 | 
						|
static void gtk_menu_bar_get_preferred_width_for_height (GtkWidget    *widget,
 | 
						|
                                                         gint          height,
 | 
						|
                                                         gint         *minimum,
 | 
						|
                                                         gint         *natural);
 | 
						|
static void gtk_menu_bar_get_preferred_height_for_width (GtkWidget    *widget,
 | 
						|
                                                         gint          width,
 | 
						|
                                                         gint         *minimum,
 | 
						|
                                                         gint         *natural);
 | 
						|
static void gtk_menu_bar_size_allocate     (GtkWidget       *widget,
 | 
						|
					    GtkAllocation   *allocation);
 | 
						|
static gint gtk_menu_bar_draw              (GtkWidget       *widget,
 | 
						|
                                            cairo_t         *cr);
 | 
						|
static void gtk_menu_bar_hierarchy_changed (GtkWidget       *widget,
 | 
						|
					    GtkWidget       *old_toplevel);
 | 
						|
static gint gtk_menu_bar_get_popup_delay   (GtkMenuShell    *menu_shell);
 | 
						|
static void gtk_menu_bar_move_current      (GtkMenuShell     *menu_shell,
 | 
						|
                                            GtkMenuDirectionType direction);
 | 
						|
 | 
						|
static void gtk_menu_bar_measure (GtkCssGadget   *gadget,
 | 
						|
                                  GtkOrientation  orientation,
 | 
						|
                                  int             for_size,
 | 
						|
                                  int            *minimum,
 | 
						|
                                  int            *natural,
 | 
						|
                                  int            *minimum_baseline,
 | 
						|
                                  int            *natural_baseline,
 | 
						|
                                  gpointer        data);
 | 
						|
static void gtk_menu_bar_allocate (GtkCssGadget        *gadget,
 | 
						|
                                   const GtkAllocation *allocation,
 | 
						|
                                   int                  baseline,
 | 
						|
                                   GtkAllocation       *out_clip,
 | 
						|
                                   gpointer             data);
 | 
						|
static gboolean gtk_menu_bar_render (GtkCssGadget *gadget,
 | 
						|
                                     cairo_t      *cr,
 | 
						|
                                     int           x,
 | 
						|
                                     int           y,
 | 
						|
                                     int           width,
 | 
						|
                                     int           height,
 | 
						|
                                     gpointer      data);
 | 
						|
 | 
						|
G_DEFINE_TYPE_WITH_PRIVATE (GtkMenuBar, gtk_menu_bar, GTK_TYPE_MENU_SHELL)
 | 
						|
 | 
						|
static void
 | 
						|
gtk_menu_bar_class_init (GtkMenuBarClass *class)
 | 
						|
{
 | 
						|
  GObjectClass *gobject_class;
 | 
						|
  GtkWidgetClass *widget_class;
 | 
						|
  GtkMenuShellClass *menu_shell_class;
 | 
						|
  GtkContainerClass *container_class;
 | 
						|
 | 
						|
  GtkBindingSet *binding_set;
 | 
						|
 | 
						|
  gobject_class = (GObjectClass*) class;
 | 
						|
  widget_class = (GtkWidgetClass*) class;
 | 
						|
  menu_shell_class = (GtkMenuShellClass*) class;
 | 
						|
  container_class = (GtkContainerClass*) class;
 | 
						|
 | 
						|
  gobject_class->get_property = gtk_menu_bar_get_property;
 | 
						|
  gobject_class->set_property = gtk_menu_bar_set_property;
 | 
						|
  gobject_class->finalize = gtk_menu_bar_finalize;
 | 
						|
 | 
						|
  widget_class->get_preferred_width = gtk_menu_bar_get_preferred_width;
 | 
						|
  widget_class->get_preferred_height = gtk_menu_bar_get_preferred_height;
 | 
						|
  widget_class->get_preferred_width_for_height = gtk_menu_bar_get_preferred_width_for_height;
 | 
						|
  widget_class->get_preferred_height_for_width = gtk_menu_bar_get_preferred_height_for_width;
 | 
						|
  widget_class->size_allocate = gtk_menu_bar_size_allocate;
 | 
						|
  widget_class->draw = gtk_menu_bar_draw;
 | 
						|
  widget_class->hierarchy_changed = gtk_menu_bar_hierarchy_changed;
 | 
						|
 | 
						|
  menu_shell_class->submenu_placement = GTK_TOP_BOTTOM;
 | 
						|
  menu_shell_class->get_popup_delay = gtk_menu_bar_get_popup_delay;
 | 
						|
  menu_shell_class->move_current = gtk_menu_bar_move_current;
 | 
						|
 | 
						|
  binding_set = gtk_binding_set_by_class (class);
 | 
						|
  gtk_binding_entry_add_signal (binding_set,
 | 
						|
				GDK_KEY_Left, 0,
 | 
						|
				"move-current", 1,
 | 
						|
				GTK_TYPE_MENU_DIRECTION_TYPE,
 | 
						|
				GTK_MENU_DIR_PREV);
 | 
						|
  gtk_binding_entry_add_signal (binding_set,
 | 
						|
				GDK_KEY_KP_Left, 0,
 | 
						|
				"move-current", 1,
 | 
						|
				GTK_TYPE_MENU_DIRECTION_TYPE,
 | 
						|
				GTK_MENU_DIR_PREV);
 | 
						|
  gtk_binding_entry_add_signal (binding_set,
 | 
						|
				GDK_KEY_Right, 0,
 | 
						|
				"move-current", 1,
 | 
						|
				GTK_TYPE_MENU_DIRECTION_TYPE,
 | 
						|
				GTK_MENU_DIR_NEXT);
 | 
						|
  gtk_binding_entry_add_signal (binding_set,
 | 
						|
				GDK_KEY_KP_Right, 0,
 | 
						|
				"move-current", 1,
 | 
						|
				GTK_TYPE_MENU_DIRECTION_TYPE,
 | 
						|
				GTK_MENU_DIR_NEXT);
 | 
						|
  gtk_binding_entry_add_signal (binding_set,
 | 
						|
				GDK_KEY_Up, 0,
 | 
						|
				"move-current", 1,
 | 
						|
				GTK_TYPE_MENU_DIRECTION_TYPE,
 | 
						|
				GTK_MENU_DIR_PARENT);
 | 
						|
  gtk_binding_entry_add_signal (binding_set,
 | 
						|
				GDK_KEY_KP_Up, 0,
 | 
						|
				"move-current", 1,
 | 
						|
				GTK_TYPE_MENU_DIRECTION_TYPE,
 | 
						|
				GTK_MENU_DIR_PARENT);
 | 
						|
  gtk_binding_entry_add_signal (binding_set,
 | 
						|
				GDK_KEY_Down, 0,
 | 
						|
				"move-current", 1,
 | 
						|
				GTK_TYPE_MENU_DIRECTION_TYPE,
 | 
						|
				GTK_MENU_DIR_CHILD);
 | 
						|
  gtk_binding_entry_add_signal (binding_set,
 | 
						|
				GDK_KEY_KP_Down, 0,
 | 
						|
				"move-current", 1,
 | 
						|
				GTK_TYPE_MENU_DIRECTION_TYPE,
 | 
						|
				GTK_MENU_DIR_CHILD);
 | 
						|
 | 
						|
  /**
 | 
						|
   * GtkMenuBar:pack-direction:
 | 
						|
   *
 | 
						|
   * The pack direction of the menubar. It determines how
 | 
						|
   * menuitems are arranged in the menubar.
 | 
						|
   *
 | 
						|
   * Since: 2.8
 | 
						|
   */
 | 
						|
  g_object_class_install_property (gobject_class,
 | 
						|
                                   PROP_PACK_DIRECTION,
 | 
						|
                                   g_param_spec_enum ("pack-direction",
 | 
						|
                                                      P_("Pack direction"),
 | 
						|
                                                      P_("The pack direction of the menubar"),
 | 
						|
                                                      GTK_TYPE_PACK_DIRECTION,
 | 
						|
                                                      GTK_PACK_DIRECTION_LTR,
 | 
						|
                                                      GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
 | 
						|
  
 | 
						|
  /**
 | 
						|
   * GtkMenuBar:child-pack-direction:
 | 
						|
   *
 | 
						|
   * The child pack direction of the menubar. It determines how
 | 
						|
   * the widgets contained in child menuitems are arranged.
 | 
						|
   *
 | 
						|
   * Since: 2.8
 | 
						|
   */
 | 
						|
  g_object_class_install_property (gobject_class,
 | 
						|
                                   PROP_CHILD_PACK_DIRECTION,
 | 
						|
                                   g_param_spec_enum ("child-pack-direction",
 | 
						|
                                                      P_("Child Pack direction"),
 | 
						|
                                                      P_("The child pack direction of the menubar"),
 | 
						|
                                                      GTK_TYPE_PACK_DIRECTION,
 | 
						|
                                                      GTK_PACK_DIRECTION_LTR,
 | 
						|
                                                      GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY));
 | 
						|
  
 | 
						|
 | 
						|
  /**
 | 
						|
   * GtkMenuBar:shadow-type:
 | 
						|
   *
 | 
						|
   * The style of the shadow around the menubar.
 | 
						|
   *
 | 
						|
   * Deprecated: 3.20: Use CSS to determine the shadow; the value of
 | 
						|
   *     this style property is ignored.
 | 
						|
   */
 | 
						|
  gtk_widget_class_install_style_property (widget_class,
 | 
						|
					   g_param_spec_enum ("shadow-type",
 | 
						|
                                                              P_("Shadow type"),
 | 
						|
                                                              P_("Style of bevel around the menubar"),
 | 
						|
                                                              GTK_TYPE_SHADOW_TYPE,
 | 
						|
                                                              GTK_SHADOW_OUT,
 | 
						|
                                                              GTK_PARAM_READABLE|G_PARAM_DEPRECATED));
 | 
						|
 | 
						|
  /**
 | 
						|
   * GtkMenuBar:internal-padding:
 | 
						|
   *
 | 
						|
   * Amount of border space between the menubar shadow and the menu items
 | 
						|
   *
 | 
						|
   * Deprecated: 3.8: use the standard padding CSS property (through objects
 | 
						|
   *   like #GtkStyleContext and #GtkCssProvider); the value of this style
 | 
						|
   *   property is ignored.
 | 
						|
   */
 | 
						|
  gtk_widget_class_install_style_property (widget_class,
 | 
						|
					   g_param_spec_int ("internal-padding",
 | 
						|
							     P_("Internal padding"),
 | 
						|
							     P_("Amount of border space between the menubar shadow and the menu items"),
 | 
						|
							     0,
 | 
						|
							     G_MAXINT,
 | 
						|
                                                             0,
 | 
						|
                                                             GTK_PARAM_READABLE|G_PARAM_DEPRECATED));
 | 
						|
 | 
						|
  gtk_container_class_handle_border_width (container_class);
 | 
						|
  gtk_widget_class_set_accessible_role (widget_class, ATK_ROLE_MENU_BAR);
 | 
						|
  gtk_widget_class_set_css_name (widget_class, "menubar");
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_menu_bar_init (GtkMenuBar *menu_bar)
 | 
						|
{
 | 
						|
  GtkMenuBarPrivate *priv;
 | 
						|
  GtkWidget *widget;
 | 
						|
  GtkCssNode *widget_node;
 | 
						|
 | 
						|
  priv = menu_bar->priv = gtk_menu_bar_get_instance_private (menu_bar);
 | 
						|
 | 
						|
  widget = GTK_WIDGET (menu_bar);
 | 
						|
  widget_node = gtk_widget_get_css_node (widget);
 | 
						|
  priv->gadget = gtk_css_custom_gadget_new_for_node (widget_node,
 | 
						|
                                                     widget,
 | 
						|
                                                     gtk_menu_bar_measure,
 | 
						|
                                                     gtk_menu_bar_allocate,
 | 
						|
                                                     gtk_menu_bar_render,
 | 
						|
                                                     NULL, NULL);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_menu_bar_new:
 | 
						|
 *
 | 
						|
 * Creates a new #GtkMenuBar
 | 
						|
 *
 | 
						|
 * Returns: the new menu bar, as a #GtkWidget
 | 
						|
 */
 | 
						|
GtkWidget*
 | 
						|
gtk_menu_bar_new (void)
 | 
						|
{
 | 
						|
  return g_object_new (GTK_TYPE_MENU_BAR, NULL);
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_menu_bar_finalize (GObject *object)
 | 
						|
{
 | 
						|
  GtkMenuBar *menu_bar = GTK_MENU_BAR (object);
 | 
						|
 | 
						|
  g_clear_object (&menu_bar->priv->gadget);
 | 
						|
 | 
						|
  G_OBJECT_CLASS (gtk_menu_bar_parent_class)->finalize (object);
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_menu_bar_set_property (GObject      *object,
 | 
						|
			   guint         prop_id,
 | 
						|
			   const GValue *value,
 | 
						|
			   GParamSpec   *pspec)
 | 
						|
{
 | 
						|
  GtkMenuBar *menubar = GTK_MENU_BAR (object);
 | 
						|
  
 | 
						|
  switch (prop_id)
 | 
						|
    {
 | 
						|
    case PROP_PACK_DIRECTION:
 | 
						|
      gtk_menu_bar_set_pack_direction (menubar, g_value_get_enum (value));
 | 
						|
      break;
 | 
						|
    case PROP_CHILD_PACK_DIRECTION:
 | 
						|
      gtk_menu_bar_set_child_pack_direction (menubar, g_value_get_enum (value));
 | 
						|
      break;
 | 
						|
    default:
 | 
						|
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
 | 
						|
      break;
 | 
						|
    }
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_menu_bar_get_property (GObject    *object,
 | 
						|
			   guint       prop_id,
 | 
						|
			   GValue     *value,
 | 
						|
			   GParamSpec *pspec)
 | 
						|
{
 | 
						|
  GtkMenuBar *menubar = GTK_MENU_BAR (object);
 | 
						|
  
 | 
						|
  switch (prop_id)
 | 
						|
    {
 | 
						|
    case PROP_PACK_DIRECTION:
 | 
						|
      g_value_set_enum (value, gtk_menu_bar_get_pack_direction (menubar));
 | 
						|
      break;
 | 
						|
    case PROP_CHILD_PACK_DIRECTION:
 | 
						|
      g_value_set_enum (value, gtk_menu_bar_get_child_pack_direction (menubar));
 | 
						|
      break;
 | 
						|
    default:
 | 
						|
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
 | 
						|
      break;
 | 
						|
    }
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_menu_bar_measure (GtkCssGadget   *gadget,
 | 
						|
                      GtkOrientation  orientation,
 | 
						|
                      int             size,
 | 
						|
                      int            *minimum,
 | 
						|
                      int            *natural,
 | 
						|
                      int            *minimum_baseline,
 | 
						|
                      int            *natural_baseline,
 | 
						|
                      gpointer        data)
 | 
						|
{
 | 
						|
  GtkWidget *widget = gtk_css_gadget_get_owner (gadget);
 | 
						|
  GtkMenuBar *menu_bar;
 | 
						|
  GtkMenuBarPrivate *priv;
 | 
						|
  GtkMenuShell *menu_shell;
 | 
						|
  GtkWidget *child;
 | 
						|
  GList *children;
 | 
						|
  gboolean use_toggle_size, use_maximize;
 | 
						|
  gint child_minimum, child_natural;
 | 
						|
 | 
						|
  *minimum = 0;
 | 
						|
  *natural = 0;
 | 
						|
 | 
						|
  menu_bar = GTK_MENU_BAR (widget);
 | 
						|
  menu_shell = GTK_MENU_SHELL (widget);
 | 
						|
  priv = menu_bar->priv;
 | 
						|
 | 
						|
  children = menu_shell->priv->children;
 | 
						|
 | 
						|
  if (priv->child_pack_direction == GTK_PACK_DIRECTION_LTR ||
 | 
						|
      priv->child_pack_direction == GTK_PACK_DIRECTION_RTL)
 | 
						|
    use_toggle_size = (orientation == GTK_ORIENTATION_HORIZONTAL);
 | 
						|
  else
 | 
						|
    use_toggle_size = (orientation == GTK_ORIENTATION_VERTICAL);
 | 
						|
 | 
						|
  if (priv->pack_direction == GTK_PACK_DIRECTION_LTR ||
 | 
						|
      priv->pack_direction == GTK_PACK_DIRECTION_RTL)
 | 
						|
    use_maximize = (orientation == GTK_ORIENTATION_VERTICAL);
 | 
						|
  else
 | 
						|
    use_maximize = (orientation == GTK_ORIENTATION_HORIZONTAL);
 | 
						|
 | 
						|
  while (children)
 | 
						|
    {
 | 
						|
      child = children->data;
 | 
						|
      children = children->next;
 | 
						|
 | 
						|
      if (gtk_widget_get_visible (child))
 | 
						|
        {
 | 
						|
          _gtk_widget_get_preferred_size_for_size (child, orientation, size, &child_minimum, &child_natural, NULL, NULL);
 | 
						|
 | 
						|
          if (use_toggle_size)
 | 
						|
            {
 | 
						|
              gint toggle_size;
 | 
						|
 | 
						|
              gtk_menu_item_toggle_size_request (GTK_MENU_ITEM (child),
 | 
						|
                                                 &toggle_size);
 | 
						|
 | 
						|
              child_minimum += toggle_size;
 | 
						|
              child_natural += toggle_size;
 | 
						|
            }
 | 
						|
 | 
						|
          if (use_maximize)
 | 
						|
            {
 | 
						|
              *minimum = MAX (*minimum, child_minimum);
 | 
						|
              *natural = MAX (*natural, child_natural);
 | 
						|
            }
 | 
						|
          else
 | 
						|
            {
 | 
						|
              *minimum += child_minimum;
 | 
						|
              *natural += child_natural;
 | 
						|
            }
 | 
						|
        }
 | 
						|
    }
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_menu_bar_get_preferred_width (GtkWidget *widget,
 | 
						|
				  gint      *minimum,
 | 
						|
				  gint      *natural)
 | 
						|
{
 | 
						|
  gtk_css_gadget_get_preferred_size (GTK_MENU_BAR (widget)->priv->gadget,
 | 
						|
                                     GTK_ORIENTATION_HORIZONTAL,
 | 
						|
                                     -1,
 | 
						|
                                     minimum, natural,
 | 
						|
                                     NULL, NULL);
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_menu_bar_get_preferred_height (GtkWidget *widget,
 | 
						|
				   gint      *minimum,
 | 
						|
				   gint      *natural)
 | 
						|
{
 | 
						|
  gtk_css_gadget_get_preferred_size (GTK_MENU_BAR (widget)->priv->gadget,
 | 
						|
                                     GTK_ORIENTATION_VERTICAL,
 | 
						|
                                     -1,
 | 
						|
                                     minimum, natural,
 | 
						|
                                     NULL, NULL);
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_menu_bar_get_preferred_width_for_height (GtkWidget *widget,
 | 
						|
                                             gint       height,
 | 
						|
                                             gint      *minimum,
 | 
						|
                                             gint      *natural)
 | 
						|
{
 | 
						|
  gtk_css_gadget_get_preferred_size (GTK_MENU_BAR (widget)->priv->gadget,
 | 
						|
                                     GTK_ORIENTATION_HORIZONTAL,
 | 
						|
                                     height,
 | 
						|
                                     minimum, natural,
 | 
						|
                                     NULL, NULL);
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_menu_bar_get_preferred_height_for_width (GtkWidget *widget,
 | 
						|
                                             gint       width,
 | 
						|
                                             gint      *minimum,
 | 
						|
                                             gint      *natural)
 | 
						|
{
 | 
						|
  gtk_css_gadget_get_preferred_size (GTK_MENU_BAR (widget)->priv->gadget,
 | 
						|
                                     GTK_ORIENTATION_VERTICAL,
 | 
						|
                                     width,
 | 
						|
                                     minimum, natural,
 | 
						|
                                     NULL, NULL);
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_menu_bar_allocate (GtkCssGadget        *gadget,
 | 
						|
                       const GtkAllocation *allocation,
 | 
						|
                       int                  baseline,
 | 
						|
                       GtkAllocation       *out_clip,
 | 
						|
                       gpointer             data)
 | 
						|
{
 | 
						|
  GtkWidget *widget = gtk_css_gadget_get_owner (gadget);
 | 
						|
  GtkMenuBar *menu_bar;
 | 
						|
  GtkMenuShell *menu_shell;
 | 
						|
  GtkMenuBarPrivate *priv;
 | 
						|
  GtkWidget *child;
 | 
						|
  GList *children;
 | 
						|
  GtkAllocation remaining_space;
 | 
						|
  GArray *requested_sizes;
 | 
						|
  gint toggle_size;
 | 
						|
  guint i;
 | 
						|
 | 
						|
  menu_bar = GTK_MENU_BAR (widget);
 | 
						|
  menu_shell = GTK_MENU_SHELL (widget);
 | 
						|
  priv = menu_bar->priv;
 | 
						|
 | 
						|
  if (!menu_shell->priv->children)
 | 
						|
    return;
 | 
						|
 | 
						|
  remaining_space = *allocation;
 | 
						|
  requested_sizes = g_array_new (FALSE, FALSE, sizeof (GtkRequestedSize));
 | 
						|
 | 
						|
  if (priv->pack_direction == GTK_PACK_DIRECTION_LTR ||
 | 
						|
      priv->pack_direction == GTK_PACK_DIRECTION_RTL)
 | 
						|
    {
 | 
						|
      int size = remaining_space.width;
 | 
						|
      gboolean ltr = (gtk_widget_get_direction (widget) == GTK_TEXT_DIR_LTR) == (priv->pack_direction == GTK_PACK_DIRECTION_LTR);
 | 
						|
 | 
						|
      for (children = menu_shell->priv->children; children; children = children->next)
 | 
						|
        {
 | 
						|
          GtkRequestedSize request;
 | 
						|
          child = children->data;
 | 
						|
 | 
						|
          if (!gtk_widget_get_visible (child))
 | 
						|
            continue;
 | 
						|
 | 
						|
          request.data = child;
 | 
						|
          gtk_widget_get_preferred_width_for_height (child, 
 | 
						|
                                                     remaining_space.height,
 | 
						|
                                                     &request.minimum_size, 
 | 
						|
                                                     &request.natural_size);
 | 
						|
          gtk_menu_item_toggle_size_request (GTK_MENU_ITEM (child),
 | 
						|
                                             &toggle_size);
 | 
						|
          request.minimum_size += toggle_size;
 | 
						|
          request.natural_size += toggle_size;
 | 
						|
 | 
						|
          gtk_menu_item_toggle_size_allocate (GTK_MENU_ITEM (child), toggle_size);
 | 
						|
 | 
						|
          g_array_append_val (requested_sizes, request);
 | 
						|
 | 
						|
          size -= request.minimum_size;
 | 
						|
        }
 | 
						|
 | 
						|
      size = gtk_distribute_natural_allocation (size,
 | 
						|
                                                requested_sizes->len,
 | 
						|
                                                (GtkRequestedSize *) requested_sizes->data);
 | 
						|
 | 
						|
      for (i = 0; i < requested_sizes->len; i++)
 | 
						|
        {
 | 
						|
          GtkAllocation child_allocation = remaining_space;
 | 
						|
          GtkRequestedSize *request = &g_array_index (requested_sizes, GtkRequestedSize, i);
 | 
						|
 | 
						|
          child_allocation.width = request->minimum_size;
 | 
						|
          remaining_space.width -= request->minimum_size;
 | 
						|
 | 
						|
          if (i + 1 == requested_sizes->len && GTK_IS_MENU_ITEM (request->data) &&
 | 
						|
              GTK_MENU_ITEM (request->data)->priv->right_justify)
 | 
						|
            ltr = !ltr;
 | 
						|
 | 
						|
          if (ltr)
 | 
						|
            remaining_space.x += request->minimum_size;
 | 
						|
          else
 | 
						|
            child_allocation.x += remaining_space.width;
 | 
						|
 | 
						|
          gtk_widget_size_allocate (request->data, &child_allocation);
 | 
						|
        }
 | 
						|
    }
 | 
						|
  else
 | 
						|
    {
 | 
						|
      int size = remaining_space.height;
 | 
						|
      gboolean ttb = (priv->pack_direction == GTK_PACK_DIRECTION_TTB);
 | 
						|
 | 
						|
      for (children = menu_shell->priv->children; children; children = children->next)
 | 
						|
        {
 | 
						|
          GtkRequestedSize request;
 | 
						|
          child = children->data;
 | 
						|
 | 
						|
          if (!gtk_widget_get_visible (child))
 | 
						|
            continue;
 | 
						|
 | 
						|
          request.data = child;
 | 
						|
          gtk_widget_get_preferred_height_for_width (child, 
 | 
						|
                                                     remaining_space.width,
 | 
						|
                                                     &request.minimum_size, 
 | 
						|
                                                     &request.natural_size);
 | 
						|
          gtk_menu_item_toggle_size_request (GTK_MENU_ITEM (child),
 | 
						|
                                             &toggle_size);
 | 
						|
          request.minimum_size += toggle_size;
 | 
						|
          request.natural_size += toggle_size;
 | 
						|
 | 
						|
          gtk_menu_item_toggle_size_allocate (GTK_MENU_ITEM (child), toggle_size);
 | 
						|
 | 
						|
          g_array_append_val (requested_sizes, request);
 | 
						|
 | 
						|
          size -= request.minimum_size;
 | 
						|
        }
 | 
						|
 | 
						|
      size = gtk_distribute_natural_allocation (size,
 | 
						|
                                                requested_sizes->len,
 | 
						|
                                                (GtkRequestedSize *) requested_sizes->data);
 | 
						|
 | 
						|
      for (i = 0; i < requested_sizes->len; i++)
 | 
						|
        {
 | 
						|
          GtkAllocation child_allocation = remaining_space;
 | 
						|
          GtkRequestedSize *request = &g_array_index (requested_sizes, GtkRequestedSize, i);
 | 
						|
 | 
						|
          child_allocation.height = request->minimum_size;
 | 
						|
          remaining_space.height -= request->minimum_size;
 | 
						|
 | 
						|
          if (i + 1 == requested_sizes->len && GTK_IS_MENU_ITEM (request->data) &&
 | 
						|
              GTK_MENU_ITEM (request->data)->priv->right_justify)
 | 
						|
            ttb = !ttb;
 | 
						|
 | 
						|
          if (ttb)
 | 
						|
            remaining_space.y += request->minimum_size;
 | 
						|
          else
 | 
						|
            child_allocation.y += remaining_space.height;
 | 
						|
 | 
						|
          gtk_widget_size_allocate (request->data, &child_allocation);
 | 
						|
        }
 | 
						|
    }
 | 
						|
 | 
						|
  g_array_free (requested_sizes, TRUE);
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_menu_bar_size_allocate (GtkWidget     *widget,
 | 
						|
			    GtkAllocation *allocation)
 | 
						|
{
 | 
						|
  GtkMenuBar *menu_bar;
 | 
						|
  GtkAllocation clip, content_allocation;
 | 
						|
 | 
						|
  menu_bar = GTK_MENU_BAR (widget);
 | 
						|
  gtk_widget_set_allocation (widget, allocation);
 | 
						|
 | 
						|
  if (gtk_widget_get_realized (widget))
 | 
						|
    gdk_window_move_resize (gtk_widget_get_window (widget),
 | 
						|
                            allocation->x, allocation->y,
 | 
						|
                            allocation->width, allocation->height);
 | 
						|
 | 
						|
  content_allocation = *allocation;
 | 
						|
  content_allocation.x = content_allocation.y = 0;
 | 
						|
  gtk_css_gadget_allocate (menu_bar->priv->gadget,
 | 
						|
                           &content_allocation,
 | 
						|
                           gtk_widget_get_allocated_baseline (widget),
 | 
						|
                           &clip);
 | 
						|
 | 
						|
  clip.x += allocation->x;
 | 
						|
  clip.y += allocation->y;
 | 
						|
  gtk_widget_set_clip (widget, &clip);
 | 
						|
}
 | 
						|
 | 
						|
static gboolean
 | 
						|
gtk_menu_bar_render (GtkCssGadget *gadget,
 | 
						|
                     cairo_t      *cr,
 | 
						|
                     int           x,
 | 
						|
                     int           y,
 | 
						|
                     int           width,
 | 
						|
                     int           height,
 | 
						|
                     gpointer      data)
 | 
						|
{
 | 
						|
  GtkWidget *widget = gtk_css_gadget_get_owner (gadget);
 | 
						|
 | 
						|
  GTK_WIDGET_CLASS (gtk_menu_bar_parent_class)->draw (widget, cr);
 | 
						|
 | 
						|
  return FALSE;
 | 
						|
}
 | 
						|
 | 
						|
static gboolean
 | 
						|
gtk_menu_bar_draw (GtkWidget *widget,
 | 
						|
		   cairo_t   *cr)
 | 
						|
{
 | 
						|
  gtk_css_gadget_draw (GTK_MENU_BAR (widget)->priv->gadget, cr);
 | 
						|
 | 
						|
  return FALSE;
 | 
						|
}
 | 
						|
 | 
						|
static GList *
 | 
						|
get_menu_bars (GtkWindow *window)
 | 
						|
{
 | 
						|
  return g_object_get_data (G_OBJECT (window), "gtk-menu-bar-list");
 | 
						|
}
 | 
						|
 | 
						|
GList *
 | 
						|
_gtk_menu_bar_get_viewable_menu_bars (GtkWindow *window)
 | 
						|
{
 | 
						|
  GList *menu_bars;
 | 
						|
  GList *viewable_menu_bars = NULL;
 | 
						|
 | 
						|
  for (menu_bars = get_menu_bars (window);
 | 
						|
       menu_bars;
 | 
						|
       menu_bars = menu_bars->next)
 | 
						|
    {
 | 
						|
      GtkWidget *widget = menu_bars->data;
 | 
						|
      gboolean viewable = TRUE;
 | 
						|
      
 | 
						|
      while (widget)
 | 
						|
	{
 | 
						|
	  if (!gtk_widget_get_mapped (widget))
 | 
						|
	    viewable = FALSE;
 | 
						|
 | 
						|
          widget = gtk_widget_get_parent (widget);
 | 
						|
	}
 | 
						|
 | 
						|
      if (viewable)
 | 
						|
	viewable_menu_bars = g_list_prepend (viewable_menu_bars, menu_bars->data);
 | 
						|
    }
 | 
						|
 | 
						|
  return g_list_reverse (viewable_menu_bars);
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
set_menu_bars (GtkWindow *window,
 | 
						|
	       GList     *menubars)
 | 
						|
{
 | 
						|
  g_object_set_data (G_OBJECT (window), I_("gtk-menu-bar-list"), menubars);
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
add_to_window (GtkWindow  *window,
 | 
						|
               GtkMenuBar *menubar)
 | 
						|
{
 | 
						|
  GList *menubars = get_menu_bars (window);
 | 
						|
 | 
						|
  set_menu_bars (window, g_list_prepend (menubars, menubar));
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
remove_from_window (GtkWindow  *window,
 | 
						|
                    GtkMenuBar *menubar)
 | 
						|
{
 | 
						|
  GList *menubars = get_menu_bars (window);
 | 
						|
 | 
						|
  menubars = g_list_remove (menubars, menubar);
 | 
						|
  set_menu_bars (window, menubars);
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_menu_bar_hierarchy_changed (GtkWidget *widget,
 | 
						|
				GtkWidget *old_toplevel)
 | 
						|
{
 | 
						|
  GtkWidget *toplevel;  
 | 
						|
  GtkMenuBar *menubar;
 | 
						|
 | 
						|
  menubar = GTK_MENU_BAR (widget);
 | 
						|
 | 
						|
  toplevel = gtk_widget_get_toplevel (widget);
 | 
						|
 | 
						|
  if (old_toplevel)
 | 
						|
    remove_from_window (GTK_WINDOW (old_toplevel), menubar);
 | 
						|
  
 | 
						|
  if (gtk_widget_is_toplevel (toplevel))
 | 
						|
    add_to_window (GTK_WINDOW (toplevel), menubar);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * _gtk_menu_bar_cycle_focus:
 | 
						|
 * @menubar: a #GtkMenuBar
 | 
						|
 * @dir: direction in which to cycle the focus
 | 
						|
 * 
 | 
						|
 * Move the focus between menubars in the toplevel.
 | 
						|
 **/
 | 
						|
void
 | 
						|
_gtk_menu_bar_cycle_focus (GtkMenuBar       *menubar,
 | 
						|
			   GtkDirectionType  dir)
 | 
						|
{
 | 
						|
  GtkWidget *toplevel = gtk_widget_get_toplevel (GTK_WIDGET (menubar));
 | 
						|
  GtkMenuItem *to_activate = NULL;
 | 
						|
 | 
						|
  if (gtk_widget_is_toplevel (toplevel))
 | 
						|
    {
 | 
						|
      GList *tmp_menubars = _gtk_menu_bar_get_viewable_menu_bars (GTK_WINDOW (toplevel));
 | 
						|
      GList *menubars;
 | 
						|
      GList *current;
 | 
						|
 | 
						|
      menubars = _gtk_container_focus_sort (GTK_CONTAINER (toplevel), tmp_menubars,
 | 
						|
					    dir, GTK_WIDGET (menubar));
 | 
						|
      g_list_free (tmp_menubars);
 | 
						|
 | 
						|
      if (menubars)
 | 
						|
	{
 | 
						|
	  current = g_list_find (menubars, menubar);
 | 
						|
 | 
						|
	  if (current && current->next)
 | 
						|
	    {
 | 
						|
	      GtkMenuShell *new_menushell = GTK_MENU_SHELL (current->next->data);
 | 
						|
	      if (new_menushell->priv->children)
 | 
						|
		to_activate = new_menushell->priv->children->data;
 | 
						|
	    }
 | 
						|
	}
 | 
						|
	  
 | 
						|
      g_list_free (menubars);
 | 
						|
    }
 | 
						|
 | 
						|
  gtk_menu_shell_cancel (GTK_MENU_SHELL (menubar));
 | 
						|
 | 
						|
  if (to_activate)
 | 
						|
    g_signal_emit_by_name (to_activate, "activate_item");
 | 
						|
}
 | 
						|
 | 
						|
static gint
 | 
						|
gtk_menu_bar_get_popup_delay (GtkMenuShell *menu_shell)
 | 
						|
{
 | 
						|
  return MENU_BAR_POPUP_DELAY;
 | 
						|
}
 | 
						|
 | 
						|
static void
 | 
						|
gtk_menu_bar_move_current (GtkMenuShell         *menu_shell,
 | 
						|
			   GtkMenuDirectionType  direction)
 | 
						|
{
 | 
						|
  GtkMenuBar *menubar = GTK_MENU_BAR (menu_shell);
 | 
						|
  GtkTextDirection text_dir;
 | 
						|
  GtkPackDirection pack_dir;
 | 
						|
 | 
						|
  text_dir = gtk_widget_get_direction (GTK_WIDGET (menubar));
 | 
						|
  pack_dir = gtk_menu_bar_get_pack_direction (menubar);
 | 
						|
  
 | 
						|
  if (pack_dir == GTK_PACK_DIRECTION_LTR || pack_dir == GTK_PACK_DIRECTION_RTL)
 | 
						|
     {
 | 
						|
      if ((text_dir == GTK_TEXT_DIR_RTL) == (pack_dir == GTK_PACK_DIRECTION_LTR))
 | 
						|
	{
 | 
						|
	  switch (direction) 
 | 
						|
	    {      
 | 
						|
	    case GTK_MENU_DIR_PREV:
 | 
						|
	      direction = GTK_MENU_DIR_NEXT;
 | 
						|
	      break;
 | 
						|
	    case GTK_MENU_DIR_NEXT:
 | 
						|
	      direction = GTK_MENU_DIR_PREV;
 | 
						|
	      break;
 | 
						|
	    default: ;
 | 
						|
	    }
 | 
						|
	}
 | 
						|
    }
 | 
						|
  else
 | 
						|
    {
 | 
						|
      switch (direction) 
 | 
						|
	{
 | 
						|
	case GTK_MENU_DIR_PARENT:
 | 
						|
	  if ((text_dir == GTK_TEXT_DIR_LTR) == (pack_dir == GTK_PACK_DIRECTION_TTB))
 | 
						|
	    direction = GTK_MENU_DIR_PREV;
 | 
						|
	  else
 | 
						|
	    direction = GTK_MENU_DIR_NEXT;
 | 
						|
	  break;
 | 
						|
	case GTK_MENU_DIR_CHILD:
 | 
						|
	  if ((text_dir == GTK_TEXT_DIR_LTR) == (pack_dir == GTK_PACK_DIRECTION_TTB))
 | 
						|
	    direction = GTK_MENU_DIR_NEXT;
 | 
						|
	  else
 | 
						|
	    direction = GTK_MENU_DIR_PREV;
 | 
						|
	  break;
 | 
						|
	case GTK_MENU_DIR_PREV:
 | 
						|
	  if (text_dir == GTK_TEXT_DIR_RTL)	  
 | 
						|
	    direction = GTK_MENU_DIR_CHILD;
 | 
						|
	  else
 | 
						|
	    direction = GTK_MENU_DIR_PARENT;
 | 
						|
	  break;
 | 
						|
	case GTK_MENU_DIR_NEXT:
 | 
						|
	  if (text_dir == GTK_TEXT_DIR_RTL)	  
 | 
						|
	    direction = GTK_MENU_DIR_PARENT;
 | 
						|
	  else
 | 
						|
	    direction = GTK_MENU_DIR_CHILD;
 | 
						|
	  break;
 | 
						|
	default: ;
 | 
						|
	}
 | 
						|
    }
 | 
						|
  
 | 
						|
  GTK_MENU_SHELL_CLASS (gtk_menu_bar_parent_class)->move_current (menu_shell, direction);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_menu_bar_get_pack_direction:
 | 
						|
 * @menubar: a #GtkMenuBar
 | 
						|
 * 
 | 
						|
 * Retrieves the current pack direction of the menubar. 
 | 
						|
 * See gtk_menu_bar_set_pack_direction().
 | 
						|
 *
 | 
						|
 * Returns: the pack direction
 | 
						|
 *
 | 
						|
 * Since: 2.8
 | 
						|
 */
 | 
						|
GtkPackDirection
 | 
						|
gtk_menu_bar_get_pack_direction (GtkMenuBar *menubar)
 | 
						|
{
 | 
						|
  g_return_val_if_fail (GTK_IS_MENU_BAR (menubar), 
 | 
						|
			GTK_PACK_DIRECTION_LTR);
 | 
						|
 | 
						|
  return menubar->priv->pack_direction;
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_menu_bar_set_pack_direction:
 | 
						|
 * @menubar: a #GtkMenuBar
 | 
						|
 * @pack_dir: a new #GtkPackDirection
 | 
						|
 * 
 | 
						|
 * Sets how items should be packed inside a menubar.
 | 
						|
 * 
 | 
						|
 * Since: 2.8
 | 
						|
 */
 | 
						|
void
 | 
						|
gtk_menu_bar_set_pack_direction (GtkMenuBar       *menubar,
 | 
						|
                                 GtkPackDirection  pack_dir)
 | 
						|
{
 | 
						|
  GtkMenuBarPrivate *priv;
 | 
						|
  GList *l;
 | 
						|
 | 
						|
  g_return_if_fail (GTK_IS_MENU_BAR (menubar));
 | 
						|
 | 
						|
  priv = menubar->priv;
 | 
						|
 | 
						|
  if (priv->pack_direction != pack_dir)
 | 
						|
    {
 | 
						|
      priv->pack_direction = pack_dir;
 | 
						|
 | 
						|
      gtk_widget_queue_resize (GTK_WIDGET (menubar));
 | 
						|
 | 
						|
      for (l = GTK_MENU_SHELL (menubar)->priv->children; l; l = l->next)
 | 
						|
	gtk_widget_queue_resize (GTK_WIDGET (l->data));
 | 
						|
 | 
						|
      g_object_notify (G_OBJECT (menubar), "pack-direction");
 | 
						|
    }
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_menu_bar_get_child_pack_direction:
 | 
						|
 * @menubar: a #GtkMenuBar
 | 
						|
 * 
 | 
						|
 * Retrieves the current child pack direction of the menubar.
 | 
						|
 * See gtk_menu_bar_set_child_pack_direction().
 | 
						|
 *
 | 
						|
 * Returns: the child pack direction
 | 
						|
 *
 | 
						|
 * Since: 2.8
 | 
						|
 */
 | 
						|
GtkPackDirection
 | 
						|
gtk_menu_bar_get_child_pack_direction (GtkMenuBar *menubar)
 | 
						|
{
 | 
						|
  g_return_val_if_fail (GTK_IS_MENU_BAR (menubar), 
 | 
						|
			GTK_PACK_DIRECTION_LTR);
 | 
						|
 | 
						|
  return menubar->priv->child_pack_direction;
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_menu_bar_set_child_pack_direction:
 | 
						|
 * @menubar: a #GtkMenuBar
 | 
						|
 * @child_pack_dir: a new #GtkPackDirection
 | 
						|
 * 
 | 
						|
 * Sets how widgets should be packed inside the children of a menubar.
 | 
						|
 * 
 | 
						|
 * Since: 2.8
 | 
						|
 */
 | 
						|
void
 | 
						|
gtk_menu_bar_set_child_pack_direction (GtkMenuBar       *menubar,
 | 
						|
                                       GtkPackDirection  child_pack_dir)
 | 
						|
{
 | 
						|
  GtkMenuBarPrivate *priv;
 | 
						|
  GList *l;
 | 
						|
 | 
						|
  g_return_if_fail (GTK_IS_MENU_BAR (menubar));
 | 
						|
 | 
						|
  priv = menubar->priv;
 | 
						|
 | 
						|
  if (priv->child_pack_direction != child_pack_dir)
 | 
						|
    {
 | 
						|
      priv->child_pack_direction = child_pack_dir;
 | 
						|
 | 
						|
      gtk_widget_queue_resize (GTK_WIDGET (menubar));
 | 
						|
 | 
						|
      for (l = GTK_MENU_SHELL (menubar)->priv->children; l; l = l->next)
 | 
						|
	gtk_widget_queue_resize (GTK_WIDGET (l->data));
 | 
						|
 | 
						|
      g_object_notify (G_OBJECT (menubar), "child-pack-direction");
 | 
						|
    }
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * gtk_menu_bar_new_from_model:
 | 
						|
 * @model: a #GMenuModel
 | 
						|
 *
 | 
						|
 * Creates a new #GtkMenuBar and populates it with menu items
 | 
						|
 * and submenus according to @model.
 | 
						|
 *
 | 
						|
 * The created menu items are connected to actions found in the
 | 
						|
 * #GtkApplicationWindow to which the menu bar belongs - typically
 | 
						|
 * by means of being contained within the #GtkApplicationWindows
 | 
						|
 * widget hierarchy.
 | 
						|
 *
 | 
						|
 * Returns: a new #GtkMenuBar
 | 
						|
 *
 | 
						|
 * Since: 3.4
 | 
						|
 */
 | 
						|
GtkWidget *
 | 
						|
gtk_menu_bar_new_from_model (GMenuModel *model)
 | 
						|
{
 | 
						|
  GtkWidget *menubar;
 | 
						|
 | 
						|
  g_return_val_if_fail (G_IS_MENU_MODEL (model), NULL);
 | 
						|
 | 
						|
  menubar = gtk_menu_bar_new ();
 | 
						|
  gtk_menu_shell_bind_model (GTK_MENU_SHELL (menubar), model, NULL, FALSE);
 | 
						|
 | 
						|
  return menubar;
 | 
						|
}
 |