Accessible boundsForRange common impl

content/browser/accessibility/browser_accessibility.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_H_
 #define CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_H_
 
 #include <map>
 #include <utility>
 #include <vector>
@@ skipping 94 matching lines @@
   // of its parent.
   BrowserAccessibility* GetNextSibling();
 
   // Returns the bounds of this object in coordinates relative to the
   // top-left corner of the overall web area.
   gfx::Rect GetLocalBoundsRect() const;
 
   // Returns the bounds of this object in screen coordinates.
   gfx::Rect GetGlobalBoundsRect() const;
 
+  // Returns the bounds of the given range in coordinates relative to the
+  // top-left corner of the overall web area. Only valid when the

[David Tseng, 2013/10/17 21:32:02]

Are you thinking about supporting this for non-static (AXStaticText) nodes (as
we discussed, indexing could follow the same model that Selection/Range does
today in the DOM).

[dmazzoni, 2013/10/21 17:25:38]

Sounds good - but for now, this is strictly only supposed to work for static
text. I'm pretty sure that's sufficient for it to support the native
boundsForRange apis on both Mac and Windows.

+  // role is WebAXRoleStaticText.

[aboxhall, 2013/10/04 18:53:07]

There's no chance this could be called on an inline text box?

[dmazzoni, 2013/10/21 17:25:38]

No. The inline text boxes are not exposed to the platform at all, so there's no
way that call could hever happen. There's a DCHECK at the top also.

+  gfx::Rect GetLocalBoundsForRange(int start, int len) const;

[David Tseng, 2013/10/17 21:32:02]

If the above were true, then perhaps this should be startIndex/endIndex (to
generalize indexing into children and text)..

[dmazzoni, 2013/10/21 17:25:38]

I think we'd want a higher-level function that takes a start node and offset,
and an end node and offset, and computes the bounds from that. A single start
and end within the same node like this wouldn't really handle that case anyway.

Let's think of this as a special case (that's useful now); later when we add the
general case, this one just becomes a private helper function.

+
+  // Same as GetLocalBoundsForRange, in screen coordinates.
+  gfx::Rect GetGlobalBoundsForRange(int start, int len) const;

[David Tseng, 2013/10/17 21:32:02]

Is this also only available for static text?

[dmazzoni, 2013/10/21 17:25:38]

Yes. Updated the comment.

+
   // Returns the deepest descendant that contains the specified point
   // (in global screen coordinates).
   BrowserAccessibility* BrowserAccessibilityForPoint(const gfx::Point& point);
 
   // Marks this object for deletion, releases our reference to it, and
   // recursively calls Destroy() on its children.  May not delete
   // immediately due to reference counting.
   //
   // Reference counting is used on some platforms because the
   // operating system may hold onto a reference to a BrowserAccessibility
@@ skipping 171 matching lines @@
   // immediately return failure.
   bool instance_active_;
 
  private:
   DISALLOW_COPY_AND_ASSIGN(BrowserAccessibility);
 };
 
 }  // namespace content
 
 #endif  // CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_H_