Add a context field to the accessibility extension API.

chrome/browser/accessibility/accessibility_events.h

 // 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.
 
 #ifndef CHROME_BROWSER_ACCESSIBILITY_ACCESSIBILITY_EVENTS_H_
 #define CHROME_BROWSER_ACCESSIBILITY_ACCESSIBILITY_EVENTS_H_
 #pragma once
 
 #include <string>
 #include "base/compiler_specific.h"
@@ skipping 41 matching lines @@
   // Serialize this class as a DictionaryValue that can be converted to
   // a JavaScript object.
   virtual void SerializeToDict(base::DictionaryValue* dict) const OVERRIDE;
 
   // Return the specific type of this control, which will be one of the
   // string constants defined in extension_accessibility_api_constants.h.
   virtual const char* type() const = 0;
 
   const std::string& name() const { return name_; }
 
+  const std::string& context() const { return context_; }
+
  protected:
-  AccessibilityControlInfo(Profile* profile, const std::string& control_name);
+  AccessibilityControlInfo(Profile* profile,
+                           const std::string& name,
+                           const std::string& context);
 
   // The name of the control, like "OK" or "Password".
   std::string name_;
+
+  // A string describing the context of the control, such as the name of
+  // the group or toolbar it's contained in.
+  std::string context_;
 };
 
 // Accessibility information about a window passed to onWindowOpened
 // and onWindowClosed event listeners.
 class AccessibilityWindowInfo : public AccessibilityControlInfo {
  public:
   AccessibilityWindowInfo(Profile* profile, const std::string& window_name);
 
   virtual const char* type() const OVERRIDE;
 };
 
 // Accessibility information about a push button passed to onControlFocused
 // and onControlAction event listeners.
 class AccessibilityButtonInfo : public AccessibilityControlInfo {
  public:
-  AccessibilityButtonInfo(Profile* profile, const std::string& button_name);
+  AccessibilityButtonInfo(Profile* profile,
+                          const std::string& button_name,
+                          const std::string& context);
 
   virtual const char* type() const OVERRIDE;
 };
 
 // Accessibility information about a hyperlink passed to onControlFocused
 // and onControlAction event listeners.
 class AccessibilityLinkInfo : public AccessibilityControlInfo {
  public:
-  AccessibilityLinkInfo(Profile* profile, const std::string& link_name);
+  AccessibilityLinkInfo(Profile* profile,
+                        const std::string& link_name,
+                        const std::string& context);
 
   virtual const char* type() const OVERRIDE;
 };
 
 // Accessibility information about a radio button passed to onControlFocused
 // and onControlAction event listeners.
 class AccessibilityRadioButtonInfo : public AccessibilityControlInfo {
  public:
   AccessibilityRadioButtonInfo(Profile* profile,
                                const std::string& name,
+                               const std::string& context,
                                bool checked,
                                int item_index,
                                int item_count);
 
   virtual const char* type() const OVERRIDE;
 
   virtual void SerializeToDict(base::DictionaryValue* dict) const OVERRIDE;
 
   void SetChecked(bool checked) { checked_ = checked; }
 
   int item_index() const { return item_index_; }
   int item_count() const { return item_count_; }
   bool checked() const { return checked_; }
 
  private:
   bool checked_;
   // The 0-based index of this radio button and number of buttons in the group.
   int item_index_;
   int item_count_;
 };
 
 // Accessibility information about a checkbox passed to onControlFocused
 // and onControlAction event listeners.
 class AccessibilityCheckboxInfo : public AccessibilityControlInfo {
  public:
   AccessibilityCheckboxInfo(Profile* profile,
                             const std::string& name,
+                            const std::string& context,
                             bool checked);
 
   virtual const char* type() const OVERRIDE;
 
   virtual void SerializeToDict(base::DictionaryValue* dict) const OVERRIDE;
 
   void SetChecked(bool checked) { checked_ = checked; }
 
   bool checked() const { return checked_; }
 
  private:
   bool checked_;
 };
 
 // Accessibility information about a tab passed to onControlFocused
 // and onControlAction event listeners.
 class AccessibilityTabInfo : public AccessibilityControlInfo {
  public:
   AccessibilityTabInfo(Profile* profile,
                        const std::string& tab_name,
+                       const std::string& context,
                        int tab_index,
                        int tab_count);
 
   virtual const char* type() const OVERRIDE;
 
   virtual void SerializeToDict(base::DictionaryValue* dict) const OVERRIDE;
 
   void SetTab(int tab_index, std::string tab_name) {
     tab_index_ = tab_index;
     name_ = tab_name;
   }
 
   int tab_index() const { return tab_index_; }
   int tab_count() const { return tab_count_; }
 
  private:
   // The 0-based index of this tab and number of tabs in the group.
   int tab_index_;
   int tab_count_;
 };
 
 // Accessibility information about a combo box passed to onControlFocused
 // and onControlAction event listeners.
 class AccessibilityComboBoxInfo : public AccessibilityControlInfo {
  public:
   AccessibilityComboBoxInfo(Profile* profile,
                             const std::string& name,
+                            const std::string& context,
                             const std::string& value,
                             int item_index,
                             int item_count);
 
   virtual const char* type() const OVERRIDE;
 
   virtual void SerializeToDict(base::DictionaryValue* dict) const OVERRIDE;
 
   void SetValue(int item_index, const std::string& value) {
     item_index_ = item_index;
@@ skipping 12 matching lines @@
   int item_index_;
   int item_count_;
 };
 
 // Accessibility information about a text box, passed to onControlFocused,
 // onControlAction, and onTextChanged event listeners.
 class AccessibilityTextBoxInfo : public AccessibilityControlInfo {
  public:
   AccessibilityTextBoxInfo(Profile* profile,
                            const std::string& name,
+                           const std::string& context,
                            bool password);
 
   virtual const char* type() const OVERRIDE;
 
   virtual void SerializeToDict(base::DictionaryValue* dict) const OVERRIDE;
 
   void SetValue(
       const std::string& value, int selection_start, int selection_end) {
     value_ = value;
     selection_start_ = selection_start;
@@ skipping 11 matching lines @@
   int selection_start_;
   int selection_end_;
 };
 
 // Accessibility information about a combo box passed to onControlFocused
 // and onControlAction event listeners.
 class AccessibilityListBoxInfo : public AccessibilityControlInfo {
  public:
   AccessibilityListBoxInfo(Profile* profile,
                            const std::string& name,
+                           const std::string& context,
                            const std::string& value,
                            int item_index,
                            int item_count);
 
   virtual const char* type() const OVERRIDE;
 
   virtual void SerializeToDict(base::DictionaryValue* dict) const OVERRIDE;
 
   void SetValue(int item_index, std::string value) {
     item_index_ = item_index;
@@ skipping 49 matching lines @@
   explicit WokeUpEventInfo(Profile* profile);
   virtual void SerializeToDict(base::DictionaryValue* dict) const OVERRIDE;
 };
 
 // Accessibility information about a menu item; this class is used by
 // onControlFocused event listeners.
 class AccessibilityMenuItemInfo : public AccessibilityControlInfo {
  public:
   AccessibilityMenuItemInfo(Profile* profile,
                             const std::string& name,
+                            const std::string& context,
                             bool has_submenu,
                             int item_index,
                             int item_count);
 
   virtual const char* type() const OVERRIDE;
 
   virtual void SerializeToDict(base::DictionaryValue* dict) const OVERRIDE;
 
   int item_index() const { return item_index_; }
   int item_count() const { return item_count_; }
   bool has_submenu() const { return has_submenu_; }
 
  private:
   bool has_submenu_;
   // The 0-based index of the current item and the number of total items.
   int item_index_;
   int item_count_;
 };
 
 #endif  // CHROME_BROWSER_ACCESSIBILITY_ACCESSIBILITY_EVENTS_H_