chrome/common/extensions/command.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CHROME_COMMON_EXTENSIONS_COMMAND_H_
   6 #define CHROME_COMMON_EXTENSIONS_COMMAND_H_
   7
   8 #include <map>
   9 #include <string>
  10
  11 #include "base/strings/string16.h"
  12 #include "ui/base/accelerators/accelerator.h"
  13
  14 namespace base {
  15 class DictionaryValue;
  16 }
  17
  18 namespace extensions {
  19 class Extension;
  20 }
  21
  22 namespace extensions {
  23
  24 class Command {
  25  public:
  26   Command();
  27   Command(const std::string& command_name,
  28           const base::string16& description,
  29           const std::string& accelerator,
  30           bool global);
  31   ~Command();
  32
  33   // The platform value for the Command.
  34   static std::string CommandPlatform();
  35
  36   // Parse a string as an accelerator. If the accelerator is unparsable then
  37   // a generic ui::Accelerator object will be returns (with key_code Unknown).
  38   static ui::Accelerator StringToAccelerator(const std::string& accelerator,
  39                                              const std::string& command_name);
  40
  41   // Returns the string representation of an accelerator without localizing the
  42   // shortcut text (like accelerator::GetShortcutText() does).
  43   static std::string AcceleratorToString(const ui::Accelerator& accelerator);
  44
  45   // Return true if the specified accelerator is one of the following multimedia
  46   // keys: Next Track key, Previous Track key, Stop Media key, Play/Pause Media
  47   // key, without any modifiers.
  48   static bool IsMediaKey(const ui::Accelerator& accelerator);
  49
  50   // Parse the command.
  51   bool Parse(const base::DictionaryValue* command,
  52              const std::string& command_name,
  53              int index,
  54              base::string16* error);
  55
  56   // Accessors:
  57   const std::string& command_name() const { return command_name_; }
  58   const ui::Accelerator& accelerator() const { return accelerator_; }
  59   const base::string16& description() const { return description_; }
  60   bool global() const { return global_; }
  61
  62   // Setter:
  63   void set_accelerator(ui::Accelerator accelerator) {
  64     accelerator_ = accelerator;
  65   }
  66   void set_global(bool global) {
  67     global_ = global;
  68   }
  69
  70  private:
  71   std::string command_name_;
  72   ui::Accelerator accelerator_;
  73   base::string16 description_;
  74   bool global_;
  75 };
  76
  77 // A mapping of command name (std::string) to a command object.
  78 typedef std::map<std::string, Command> CommandMap;
  79
  80 }  // namespace extensions
  81
  82 #endif  // CHROME_COMMON_EXTENSIONS_COMMAND_H_