blob: f77bca4dc034c82b3cd8380f84834ab139aa03e6 [file] [log] [blame]
// Copyright (c) 2011 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.
#include <string>
#include <vector>
#include "base/compiler_specific.h"
#include "base/component_export.h"
#include "base/macros.h"
#include "ui/base/accelerators/accelerator.h"
namespace ui {
// A model representing the rows of buttons that should be inserted in a button
// containing menu item.
class COMPONENT_EXPORT(UI_BASE) ButtonMenuItemModel {
// Types of buttons.
enum ButtonType {
class COMPONENT_EXPORT(UI_BASE) Delegate : public AcceleratorProvider {
// Some command ids have labels that change over time.
virtual bool IsItemForCommandIdDynamic(int command_id) const;
virtual std::u16string GetLabelForCommandId(int command_id) const;
// Performs the action associated with the specified command id.
virtual void ExecuteCommand(int command_id, int event_flags) = 0;
virtual bool IsCommandIdEnabled(int command_id) const;
virtual bool DoesCommandIdDismissMenu(int command_id) const;
// AcceleratorProvider overrides:
// By default, returns false for all commands. Can be further overridden.
bool GetAcceleratorForCommandId(
int command_id,
ui::Accelerator* accelerator) const override;
~Delegate() override {}
ButtonMenuItemModel(int string_id, ButtonMenuItemModel::Delegate* delegate);
// Adds a button that will emit |command_id|. All buttons created through
// this method will have the same size, based on the largest button.
void AddGroupItemWithStringId(int command_id, int string_id);
// Adds a button that has an icon instead of a label. Note that the image
// itself must be separately configured by platform-specific code; this method
// simply serves to add a blank item in the menu with a specified
// |command_id|.
void AddImageItem(int command_id);
// Adds a non-clickable button with a desensitized label that doesn't do
// anything. Usually combined with IsItemForCommandIdDynamic() to add
// information.
void AddButtonLabel(int command_id, int string_id);
// Adds a small horizontal space.
void AddSpace();
// Returns the number of items for iteration.
int GetItemCount() const;
// Returns what kind of item is at |index|.
ButtonType GetTypeAt(int index) const;
// Changes a position into a command ID.
int GetCommandIdAt(int index) const;
// Whether the label for item |index| changes.
bool IsItemDynamicAt(int index) const;
// Gets the accelerator information for the specified index, returning true if
// there is a shortcut accelerator for the item, false otherwise.
bool GetAcceleratorAt(int index, ui::Accelerator* accelerator) const;
// Returns the current label value for the button at |index|.
std::u16string GetLabelAt(int index) const;
// If the button at |index| should have its size equalized along with all
// other items that have their PartOfGroup bit set.
bool PartOfGroup(int index) const;
// Called when the item at the specified index has been activated.
void ActivatedAt(int index);
// Returns the enabled state of the button at |index|.
bool IsEnabledAt(int index) const;
// Returns whether clicking on the button at |index| dismisses the menu.
bool DismissesMenuAt(int index) const;
// Returns the enabled state of the command specified by |command_id|.
bool IsCommandIdEnabled(int command_id) const;
// Returns whether clicking on |command_id| dismisses the menu.
bool DoesCommandIdDismissMenu(int command_id) const;
const std::u16string& label() const { return item_label_; }
// The non-clickable label to the left of the buttons.
std::u16string item_label_;
struct Item;
std::vector<Item> items_;
Delegate* delegate_;
} // namespace ui