summaryrefslogtreecommitdiffstats
path: root/app/menus/menu_model.h
diff options
context:
space:
mode:
Diffstat (limited to 'app/menus/menu_model.h')
-rw-r--r--app/menus/menu_model.h103
1 files changed, 103 insertions, 0 deletions
diff --git a/app/menus/menu_model.h b/app/menus/menu_model.h
new file mode 100644
index 0000000..718f3b1
--- /dev/null
+++ b/app/menus/menu_model.h
@@ -0,0 +1,103 @@
+// Copyright (c) 2009 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 APP_MENUS_MENU_MODEL_H_
+#define APP_MENUS_MENU_MODEL_H_
+
+#include "app/gfx/native_widget_types.h"
+#include "base/scoped_ptr.h"
+#include "base/string16.h"
+
+class SkBitmap;
+
+namespace menus {
+
+class Accelerator;
+
+// An interface implemented by an object that provides the content of a menu.
+class MenuModel {
+ public:
+ virtual ~MenuModel() {}
+
+ // The type of item.
+ enum ItemType {
+ TYPE_COMMAND,
+ TYPE_CHECK,
+ TYPE_RADIO,
+ TYPE_SEPARATOR,
+ TYPE_SUBMENU
+ };
+
+ // Returns true if any of the items within the model have icons. Not all
+ // platforms support icons in menus natively and so this is a hint for
+ // triggering a custom rendering mode.
+ virtual bool HasIcons() const = 0;
+
+ // Returns the index of the first item. This is 0 for most menus except the
+ // system menu on Windows. |native_menu| is the menu to locate the start index
+ // within. It is guaranteed to be reset to a clean default state.
+ // IMPORTANT: If the model implementation returns something _other_ than 0
+ // here, it must offset the values for |index| it passes to the
+ // methods below by this number - this is NOT done automatically!
+ virtual int GetFirstItemIndex(gfx::NativeMenu native_menu) const { return 0; }
+
+ // Returns the number of items in the menu.
+ virtual int GetItemCount() const = 0;
+
+ // Returns the type of item at the specified index.
+ virtual ItemType GetTypeAt(int index) const = 0;
+
+ // Returns the command id of the item at the specified index.
+ virtual int GetCommandIdAt(int index) const = 0;
+
+ // Returns the label of the item at the specified index.
+ virtual string16 GetLabelAt(int index) const = 0;
+
+ // Returns true if the label at the specified index can change over the course
+ // of the menu's lifetime. If this function returns true, the label of the
+ // menu item will be updated each time the menu is shown.
+ virtual bool IsLabelDynamicAt(int index) const = 0;
+
+ // Gets the acclerator information for the specified index, returning true if
+ // there is a shortcut accelerator for the item, false otherwise.
+ virtual bool GetAcceleratorAt(int index,
+ menus::Accelerator* accelerator) const = 0;
+
+ // Returns the checked state of the item at the specified index.
+ virtual bool IsItemCheckedAt(int index) const = 0;
+
+ // Returns the id of the group of radio items that the item at the specified
+ // index belongs to.
+ virtual int GetGroupIdAt(int index) const = 0;
+
+ // Gets the icon for the item at the specified index, returning true if there
+ // is an icon, false otherwise.
+ virtual bool GetIconAt(int index, SkBitmap* icon) const = 0;
+
+ // Returns the enabled state of the item at the specified index.
+ virtual bool IsEnabledAt(int index) const = 0;
+
+ // Returns the model for the submenu at the specified index.
+ virtual MenuModel* GetSubmenuModelAt(int index) const = 0;
+
+ // Called when the highlighted menu item changes to the item at the specified
+ // index.
+ virtual void HighlightChangedTo(int index) = 0;
+
+ // Called when the item at the specified index has been activated.
+ virtual void ActivatedAt(int index) = 0;
+
+ // Called when the menu is about to be shown.
+ virtual void MenuWillShow() {}
+
+ // Retrieves the model and index that contains a specific command id. Returns
+ // true if an item with the specified command id is found. |model| is inout,
+ // and specifies the model to start searching from.
+ static bool GetModelAndIndexForCommandId(int command_id, MenuModel** model,
+ int* index);
+};
+
+} // namespace
+
+#endif // APP_MENUS_MENU_MODEL_H_