Implements the ability to get and set the caret position and the current selection from anywhere in…

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 138 matching lines @@
     // 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;
     BLINK_EXPORT WebAXObject hitTest(const WebPoint&) const;
     BLINK_EXPORT WebString keyboardShortcut() const;
     BLINK_EXPORT WebString language() const;
     BLINK_EXPORT WebAXOrientation orientation() const;
     BLINK_EXPORT WebAXRole role() const;
-    BLINK_EXPORT unsigned selectionEnd() const;
-    BLINK_EXPORT unsigned selectionEndLineNumber() const;
-    BLINK_EXPORT unsigned selectionStart() const;
-    BLINK_EXPORT unsigned selectionStartLineNumber() const;
     BLINK_EXPORT WebString stringValue() const;
     BLINK_EXPORT WebAXTextDirection textDirection() const;
     BLINK_EXPORT WebAXTextStyle textStyle() const;
     BLINK_EXPORT WebURL url() const;
 
     // Deprecated text alternative calculation API. All of these will be replaced
     // with the new API, below (under "New text alternative calculation API".
     BLINK_EXPORT WebString deprecatedAccessibilityDescription() const;
     BLINK_EXPORT bool deprecatedAriaDescribedby(WebVector<WebAXObject>& describedbyElements) const;
     BLINK_EXPORT bool deprecatedAriaLabelledby(WebVector<WebAXObject>& labelledbyElements) const;
@@ skipping 20 matching lines @@
     // Takes the result of nameFrom from calling |name|, above, and retrieves the
     // accessible description of the object, which is secondary to |name|, an enum indicating
     // where the description was derived from, and a list of objects that were used to
     // derive the description, if any.
     BLINK_EXPORT WebString description(WebAXNameFrom, WebAXDescriptionFrom&, WebVector<WebAXObject>& descriptionObjects);
     // Takes the result of nameFrom and descriptionFrom from calling |name| and |description|,
     // above, and retrieves the placeholder of the object, if present and if it wasn't already
     // exposed by one of the two functions above.
     BLINK_EXPORT WebString placeholder(WebAXNameFrom, WebAXDescriptionFrom);
 
+    // The following selection functions get or set the global document
+    // selection and can be called on any object in the tree.
+    BLINK_EXPORT void selection(WebAXObject& anchorObject, int& anchorOffset,
+        WebAXObject& focusObject, int& focusOffset) const;
+    BLINK_EXPORT void setSelection(const WebAXObject& anchorObject, int anchorOffset,
+        const WebAXObject& focusObject, int focusOffset) const;
+
+    // The following selection functions return text offsets calculated starting
+    // the current object. They only report on a selection that is placed on
+    // the current object or on any of its descendants.
+    BLINK_EXPORT unsigned selectionEnd() const;
+    BLINK_EXPORT unsigned selectionEndLineNumber() const;
+    BLINK_EXPORT unsigned selectionStart() const;
+    BLINK_EXPORT unsigned selectionStartLineNumber() const;
+
     // 1-based position in set & Size of set.
     BLINK_EXPORT int posInSet() const;
     BLINK_EXPORT int setSize() const;
 
     // Live regions.
     BLINK_EXPORT bool isInLiveRegion() const;
     BLINK_EXPORT bool liveRegionAtomic() const;
     BLINK_EXPORT bool liveRegionBusy() const;
     BLINK_EXPORT WebString liveRegionRelevant() const;
     BLINK_EXPORT WebString liveRegionStatus() const;
@@ skipping 90 matching lines @@
     operator WTF::PassRefPtr<AXObject>() const;
 #endif
 
 private:
     WebPrivatePtr<AXObject> m_private;
 };
 
 } // namespace blink
 
 #endif