Reports the position of the caret and current selection in content editables.

content/browser/accessibility/browser_accessibility_win.h

 // Copyright (c) 2012 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 CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_WIN_H_
 #define CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_WIN_H_
 
 #include <atlbase.h>
 #include <atlcom.h>
 #include <oleacc.h>
@@ skipping 748 matching lines @@
   // If the bool attribute |attribute| is present, add its value as an
   // IAccessible2 attribute with the name |ia2_attr|.
   void BoolAttributeToIA2(ui::AXBoolAttribute attribute,
                           const char* ia2_attr);
 
   // If the int attribute |attribute| is present, add its value as an
   // IAccessible2 attribute with the name |ia2_attr|.
   void IntAttributeToIA2(ui::AXIntAttribute attribute,
                          const char* ia2_attr);
 
+  // Functions that help in retrieving hyperlinks. Return -1 in case of failure.
+  // (Hyperlink is an IA2 misnomer. It refers to objects embedded within other
+  // objects, such as a numbered list within a contenteditable div.)
+  int32 GetHyperlinkIndexFromChild(const BrowserAccessibilityWin& child) const;
+  int32 GetHypertextOffsetFromHyperlinkIndex(int32 hyperlink_index) const;
+  int32 GetHypertextOffsetFromChild(const BrowserAccessibilityWin& child) const;
+  int32 GetHypertextOffsetFromDescendant(
+      const BrowserAccessibilityWin& descendant) const;
+
+  // The following functions retrieve the endpoints of the current selection.
+  // First they checks for a local selection found on the current control, e.g.
+  // when querying the selection on a textarea.
+  // If not found they retrieve the global selection found on the current frame.
+  int GetSelectionAnchor() const;
+  int GetSelectionFocus() const;
+  // Retrieves the selection offsets in the way required by the IA2 APIs.
+  // (Selection_start is always <= selection_end and
+  // selection_end is one past the last character of the selection.)
+  void GetSelectionOffsets(int* selection_start, int* selection_end) const;
+
   // Append the accessible name from this node and its children.
   base::string16 GetNameRecursive() const;
 
   // Get the value text, which might come from the floating-point
   // value for some roles.
   base::string16 GetValueText();
 
   // Get the text of this node for the purposes of IAccessibleText - it may
   // be the name, it may be the value, etc. depending on the role.
   base::string16 TextForIAccessibleText();
@@ skipping 50 matching lines @@
     int32 ia2_state;
 
     // IAccessible2 attributes.
     std::vector<base::string16> ia2_attributes;
 
     // Hypertext.
     base::string16 hypertext;
 
     // Maps the |hypertext_| embedded character offset to an index in
     // |hyperlinks_|.
+    // TODO(nektar): Replace map with vector of offsets.
     std::map<int32, int32> hyperlink_offset_to_index;
 
     // The id of a BrowserAccessibilityWin for each hyperlink.
+    // TODO(nektar): Replace object IDs with child indices.
     std::vector<int32> hyperlinks;
   };
 
   scoped_ptr<WinAttributes> win_attributes_;
 
   // Only valid during the scope of a IA2_EVENT_TEXT_REMOVED or
   // IA2_EVENT_TEXT_INSERTED event.
   scoped_ptr<WinAttributes> old_win_attributes_;
 
   // Relationships between this node and other nodes.
   std::vector<BrowserAccessibilityRelation*> relations_;
 
   // The previous scroll position, so we can tell if this object scrolled.
   int previous_scroll_x_;
   int previous_scroll_y_;
 
   // The next unique id to use.
   static LONG next_unique_id_win_;
 
   // Give BrowserAccessibility::Create access to our constructor.
   friend class BrowserAccessibility;
   friend class BrowserAccessibilityRelation;
 
   DISALLOW_COPY_AND_ASSIGN(BrowserAccessibilityWin);
 };
 
 }  // namespace content
 
 #endif  // CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_WIN_H_