Add interface to get relative bounding box rect of AX objects.

third_party/WebKit/public/web/WebAXObject.h

 /*
  * Copyright (C) 2009 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 35 matching lines @@
 
 namespace blink {
 
 class AXObject;
 class ScopedAXObjectCache;
 class WebAXObject;
 class WebNode;
 class WebDocument;
 class WebString;
 class WebURL;
+struct WebFloatRect;
 struct WebPoint;
 struct WebRect;
 
 // An instance of this class, while kept alive, indicates that accessibility
 // should be temporarily enabled. If accessibility was enabled globally
 // (WebSettings::setAccessibilityEnabled), this will have no effect.
 class WebScopedAXContext {
 public:
     BLINK_EXPORT WebScopedAXContext(WebDocument& rootDocument);
     BLINK_EXPORT ~WebScopedAXContext();
@@ skipping 71 matching lines @@
     BLINK_EXPORT WebAXObject ariaActiveDescendant() const;
     BLINK_EXPORT WebString ariaAutoComplete() const;
     BLINK_EXPORT bool ariaControls(WebVector<WebAXObject>& controlsElements) const;
     BLINK_EXPORT WebAXAriaCurrentState ariaCurrentState() const;
     BLINK_EXPORT bool ariaFlowTo(WebVector<WebAXObject>& flowToElements) const;
     BLINK_EXPORT bool ariaHasPopup() const;
     BLINK_EXPORT bool isEditable() const;
     BLINK_EXPORT bool isMultiline() const;
     BLINK_EXPORT bool isRichlyEditable() const;
     BLINK_EXPORT bool ariaOwns(WebVector<WebAXObject>& ownsElements) const;
-    BLINK_EXPORT WebRect boundingBoxRect() const;
     BLINK_EXPORT WebString fontFamily() const;
     BLINK_EXPORT float fontSize() const;
     BLINK_EXPORT bool canvasHasFallbackContent() const;
     BLINK_EXPORT WebPoint clickPoint() const;
     BLINK_EXPORT WebAXInvalidState invalidState() const;
     // Only used when invalidState() returns WebAXInvalidStateOther.
     BLINK_EXPORT WebString ariaInvalidValue() const;
     BLINK_EXPORT double estimatedLoadingProgress() const;
     BLINK_EXPORT int headingLevel() const;
     BLINK_EXPORT int hierarchicalLevel() const;
@@ skipping 124 matching lines @@
     BLINK_EXPORT void characterOffsets(WebVector<int>&) const;
     BLINK_EXPORT void wordBoundaries(WebVector<int>& starts, WebVector<int>& ends) const;
 
     // Scrollable containers.
     BLINK_EXPORT bool isScrollableContainer() const;
     BLINK_EXPORT WebPoint scrollOffset() const;
     BLINK_EXPORT WebPoint minimumScrollOffset() const;
     BLINK_EXPORT WebPoint maximumScrollOffset() const;
     BLINK_EXPORT void setScrollOffset(const WebPoint&) const;
 
+    // Old bounds calculation interface. DEPRECATED, to be replaced with getRelativeBounds.
+    BLINK_EXPORT WebRect boundingBoxRect() const;
+
+    // NEW bounds calculation interface. Every object's bounding box is returned
+    // relative to a container object (which is guaranteed to be an ancestor) and
+    // optionally a transformation matrix that needs to be applied too.
+    // To compute the absolute bounding box of an element, start with its
+    // boundsInContainer and apply the transform. Then as long as its container is
+    // not null, walk up to its container and offset by the container's offset from
+    // origin, the container's scroll position if any, and apply the container's transform.
+    // Do this until you reach the root of the tree.
+    BLINK_EXPORT void getRelativeBounds(WebAXObject& offsetContainer, WebFloatRect& boundsInContainer, SkMatrix44& containerTransform) const;
+
     // Transformation relative to the parent frame, if local (otherwise returns identity).
+    // DEPRECATED, to be replaced with getRelativeBounds.
     BLINK_EXPORT SkMatrix44 transformFromLocalParentFrame() const;
 
     // Make this object visible by scrolling as many nested scrollable views as needed.
     BLINK_EXPORT void scrollToMakeVisible() const;
     // Same, but if the whole object can't be made visible, try for this subrect, in local coordinates.
     BLINK_EXPORT void scrollToMakeVisibleWithSubFocus(const WebRect&) const;
     // Scroll this object to a given point in global coordinates of the top-level window.
     BLINK_EXPORT void scrollToGlobalPoint(const WebPoint&) const;
 
 #if BLINK_IMPLEMENTATION
     WebAXObject(AXObject*);
     WebAXObject& operator=(AXObject*);
     operator AXObject*() const;
 #endif
 
 private:
     WebPrivatePtr<AXObject> m_private;
 };
 
 } // namespace blink
 
 #endif