Index: chrome/browser/ui/gtk/menu_gtk.h |
diff --git a/chrome/browser/ui/gtk/menu_gtk.h b/chrome/browser/ui/gtk/menu_gtk.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..4604d3763e900418e127c9632dba229d01a4ff2f |
--- /dev/null |
+++ b/chrome/browser/ui/gtk/menu_gtk.h |
@@ -0,0 +1,199 @@ |
+// Copyright (c) 2010 The Chromium Authors. All rights reserved. |
+// Use of this source code is governed by a BSD-style license that can be |
+// found in the LICENSE file. |
+ |
+#ifndef CHROME_BROWSER_UI_GTK_MENU_GTK_H_ |
+#define CHROME_BROWSER_UI_GTK_MENU_GTK_H_ |
+#pragma once |
+ |
+#include <gtk/gtk.h> |
+ |
+#include <string> |
+#include <vector> |
+ |
+#include "app/gtk_signal.h" |
+#include "base/task.h" |
+#include "gfx/point.h" |
+ |
+class SkBitmap; |
+ |
+namespace menus { |
+class ButtonMenuItemModel; |
+class MenuModel; |
+} |
+ |
+class MenuGtk { |
+ public: |
+ // Delegate class that lets another class control the status of the menu. |
+ class Delegate { |
+ public: |
+ virtual ~Delegate() { } |
+ |
+ // Called before a command is executed. This exists for the case where a |
+ // model is handling the actual execution of commands, but the delegate |
+ // still needs to know that some command got executed. This is called before |
+ // and not after the command is executed because its execution may delete |
+ // the menu and/or the delegate. |
+ virtual void CommandWillBeExecuted() {} |
+ |
+ // Called when the menu stops showing. This will be called before |
+ // ExecuteCommand if the user clicks an item, but will also be called when |
+ // the user clicks away from the menu. |
+ virtual void StoppedShowing() {} |
+ |
+ // Return true if we should override the "gtk-menu-images" system setting |
+ // when showing image menu items for this menu. |
+ virtual bool AlwaysShowIconForCmd(int command_id) const { return false; } |
+ |
+ // Returns a tinted image used in button in a menu. |
+ virtual GtkIconSet* GetIconSetForId(int idr) { return NULL; } |
+ |
+ // Returns an icon for the menu item, if available. |
+ virtual GtkWidget* GetImageForCommandId(int command_id) const; |
+ |
+ static GtkWidget* GetDefaultImageForCommandId(int command_id); |
+ }; |
+ |
+ MenuGtk(MenuGtk::Delegate* delegate, menus::MenuModel* model); |
+ ~MenuGtk(); |
+ |
+ // Initialize GTK signal handlers. |
+ void ConnectSignalHandlers(); |
+ |
+ // These methods are used to build the menu dynamically. The return value |
+ // is the new menu item. |
+ GtkWidget* AppendMenuItemWithLabel(int command_id, const std::string& label); |
+ GtkWidget* AppendMenuItemWithIcon(int command_id, const std::string& label, |
+ const SkBitmap& icon); |
+ GtkWidget* AppendCheckMenuItemWithLabel(int command_id, |
+ const std::string& label); |
+ GtkWidget* AppendSeparator(); |
+ GtkWidget* AppendMenuItem(int command_id, GtkWidget* menu_item); |
+ GtkWidget* AppendMenuItemToMenu(int index, |
+ menus::MenuModel* model, |
+ GtkWidget* menu_item, |
+ GtkWidget* menu, |
+ bool connect_to_activate); |
+ |
+ // Displays the menu. |timestamp| is the time of activation. The popup is |
+ // statically positioned at |widget|. |
+ void Popup(GtkWidget* widget, gint button_type, guint32 timestamp); |
+ |
+ // Displays the menu using the button type and timestamp of |event|. The popup |
+ // is statically positioned at |widget|. |
+ void Popup(GtkWidget* widget, GdkEvent* event); |
+ |
+ // Displays the menu as a context menu, i.e. at the current cursor location. |
+ // |event_time| is the time of the event that triggered the menu's display. |
+ void PopupAsContext(guint32 event_time); |
+ |
+ // Displays the menu at the given coords. |point| is intentionally not const. |
+ void PopupAsContextAt(guint32 event_time, gfx::Point point); |
+ |
+ // Displays the menu as a context menu for the passed status icon. |
+ void PopupAsContextForStatusIcon(guint32 event_time, guint32 button, |
+ GtkStatusIcon* icon); |
+ |
+ // Displays the menu following a keyboard event (such as selecting |widget| |
+ // and pressing "enter"). |
+ void PopupAsFromKeyEvent(GtkWidget* widget); |
+ |
+ // Closes the menu. |
+ void Cancel(); |
+ |
+ // Repositions the menu to be right under the button. Alignment is set as |
+ // object data on |void_widget| with the tag "left_align". If "left_align" |
+ // is true, it aligns the left side of the menu with the left side of the |
+ // button. Otherwise it aligns the right side of the menu with the right side |
+ // of the button. Public since some menus have odd requirements that don't |
+ // belong in a public class. |
+ static void WidgetMenuPositionFunc(GtkMenu* menu, |
+ int* x, |
+ int* y, |
+ gboolean* push_in, |
+ void* void_widget); |
+ |
+ // Positions the menu to appear at the gfx::Point represented by |userdata|. |
+ static void PointMenuPositionFunc(GtkMenu* menu, |
+ int* x, |
+ int* y, |
+ gboolean* push_in, |
+ gpointer userdata); |
+ |
+ GtkWidget* widget() const { return menu_; } |
+ |
+ // Updates all the enabled/checked states and the dynamic labels. |
+ void UpdateMenu(); |
+ |
+ private: |
+ // Builds a GtkImageMenuItem. |
+ GtkWidget* BuildMenuItemWithImage(const std::string& label, |
+ const SkBitmap& icon); |
+ |
+ GtkWidget* BuildMenuItemWithImage(const std::string& label, |
+ GtkWidget* image); |
+ |
+ GtkWidget* BuildMenuItemWithLabel(const std::string& label, |
+ int command_id); |
+ |
+ // A function that creates a GtkMenu from |model_|. |
+ void BuildMenuFromModel(); |
+ // Implementation of the above; called recursively. |
+ void BuildSubmenuFromModel(menus::MenuModel* model, GtkWidget* menu); |
+ // Builds a menu item with buttons in it from the data in the model. |
+ GtkWidget* BuildButtomMenuItem(menus::ButtonMenuItemModel* model, |
+ GtkWidget* menu); |
+ |
+ void ExecuteCommand(menus::MenuModel* model, int id); |
+ |
+ // Callback for when a menu item is clicked. |
+ CHROMEGTK_CALLBACK_0(MenuGtk, void, OnMenuItemActivated); |
+ |
+ // Called when one of the buttons are pressed. |
+ CHROMEGTK_CALLBACK_1(MenuGtk, void, OnMenuButtonPressed, int); |
+ |
+ // Called to maybe activate a button if that button isn't supposed to dismiss |
+ // the menu. |
+ CHROMEGTK_CALLBACK_1(MenuGtk, gboolean, OnMenuTryButtonPressed, int); |
+ |
+ // Updates all the menu items' state. |
+ CHROMEGTK_CALLBACK_0(MenuGtk, void, OnMenuShow); |
+ |
+ // Sets the activating widget back to a normal appearance. |
+ CHROMEGTK_CALLBACK_0(MenuGtk, void, OnMenuHidden); |
+ |
+ // Sets the enable/disabled state and dynamic labels on our menu items. |
+ static void SetButtonItemInfo(GtkWidget* button, gpointer userdata); |
+ |
+ // Sets the check mark, enabled/disabled state and dynamic labels on our menu |
+ // items. |
+ static void SetMenuItemInfo(GtkWidget* widget, void* raw_menu); |
+ |
+ // Queries this object about the menu state. |
+ MenuGtk::Delegate* delegate_; |
+ |
+ // If non-NULL, the MenuModel that we use to populate and control the GTK |
+ // menu (overriding the delegate as a controller). |
+ menus::MenuModel* model_; |
+ |
+ // For some menu items, we want to show the accelerator, but not actually |
+ // explicitly handle it. To this end we connect those menu items' accelerators |
+ // to this group, but don't attach this group to any top level window. |
+ GtkAccelGroup* dummy_accel_group_; |
+ |
+ // gtk_menu_popup() does not appear to take ownership of popup menus, so |
+ // MenuGtk explicitly manages the lifetime of the menu. |
+ GtkWidget* menu_; |
+ |
+ // True when we should ignore "activate" signals. Used to prevent |
+ // menu items from getting activated when we are setting up the |
+ // menu. |
+ static bool block_activation_; |
+ |
+ // We must free these at shutdown. |
+ std::vector<MenuGtk*> submenus_we_own_; |
+ |
+ ScopedRunnableMethodFactory<MenuGtk> factory_; |
+}; |
+ |
+#endif // CHROME_BROWSER_UI_GTK_MENU_GTK_H_ |