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

Source/modules/accessibility/AXObject.h

 /*
  * Copyright (C) 2008, 2009, 2011 Apple Inc. All rights reserved.
  * Copyright (C) 2008 Nuanti Ltd.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  *
  * 1.  Redistributions of source code must retain the above copyright
  *     notice, this list of conditions and the following disclaimer.
@@ skipping 337 matching lines @@
     IgnoredReason(AXIgnoredReason r, const AXObject* obj)
         : reason(r)
         , relatedObject(obj)
     { }
 };
 
 class MODULES_EXPORT AXObject : public RefCounted<AXObject> {
 public:
     typedef Vector<RefPtr<AXObject>> AccessibilityChildrenVector;
 
-    struct PlainTextRange {
+    struct AXSelection {
+        // The ID of the deepest descendant in which the selection starts.
+        // (A value of 0 means the current object.)
+        AXID anchorId;
+        // The number of characters and child objects in the anchor object
+        // before the selection starts.
+        unsigned anchorOffset;
+        // The ID of the deepest descendant in which the selection ends.
+        // (A value of 0 means the current object.)
+        AXID focusId;
+        // The number of characters and child objects in the focus object
+        // before the selection ends.
+        unsigned focusOffset;
 
-        unsigned start;
-        unsigned length;
-
-        PlainTextRange()
-            : start(0)
-            , length(0)
+        AXSelection()
+            : anchorId(0)
+            , anchorOffset(0)
+            , focusId(0)
+            , focusOffset(0)
         { }
 
-        PlainTextRange(unsigned s, unsigned l)
-            : start(s)
-            , length(l)
+        AXSelection(unsigned startOffset, unsigned endOffset)
+            : anchorId(0)
+            , anchorOffset(startOffset)
+            , focusId(0)
+            , focusOffset(endOffset)
         { }
 
-        bool isNull() const { return !start && !length; }
+        AXSelection(AXID anchorId, unsigned anchorOffset, AXID focusId, unsigned focusOffset)
+            : anchorId(anchorId)
+            , anchorOffset(anchorOffset)
+            , focusId(focusId)
+            , focusOffset(focusOffset)
+        { }
+
+        bool isNull() const { return !anchorOffset && !focusOffset; }
+        bool hasAnchor() const { return !anchorId; }
+        bool hasFocus() const { return !focusId; }
     };
 
 protected:
     AXObject(AXObjectCacheImpl*);
 
 public:
     virtual ~AXObject();
 
     // After constructing an AXObject, it must be given a
     // unique ID, then added to AXObjectCacheImpl, and finally init() must
@@ skipping 192 matching lines @@
 
     // Walk the AXObjects on the same line. This is supported on any
     // object type but primarily intended to be used for inline text boxes.
     virtual AXObject* nextOnLine() const { return nullptr; }
     virtual AXObject* previousOnLine() const { return nullptr; }
 
     // For an inline text box.
     // The integer horizontal pixel offset of each character in the string; negative values for RTL.
     virtual void textCharacterOffsets(Vector<int>&) const { }
     // The start and end character offset of each word in the inline text box.
-    virtual void wordBoundaries(Vector<PlainTextRange>& words) const { }
+    virtual void wordBoundaries(Vector<AXSelection>& words) const { }
 
     // Properties of interactive elements.
     virtual String actionVerb() const;
     virtual AccessibilityButtonState checkboxOrRadioValue() const;
     virtual InvalidState invalidState() const { return InvalidStateUndefined; }
     // Only used when invalidState() returns InvalidStateOther.
     virtual String ariaInvalidValue() const { return String(); }
     virtual String valueDescription() const { return String(); }
     virtual float valueForRange() const { return 0.0f; }
     virtual float maxValueForRange() const { return 0.0f; }
@@ skipping 95 matching lines @@
     virtual Node* node() const { return 0; }
     virtual LayoutObject* layoutObject() const { return 0; }
     virtual Document* document() const;
     virtual FrameView* documentFrameView() const;
     virtual Element* anchorElement() const { return 0; }
     virtual Element* actionElement() const { return 0; }
     virtual Widget* widgetForAttachmentView() const { return 0; }
     String language() const;
     bool hasAttribute(const QualifiedName&) const;
     const AtomicString& getAttribute(const QualifiedName&) const;
-
-    // Selected text.
-    virtual PlainTextRange selectedTextRange() const { return PlainTextRange(); }
+    virtual AXSelection selection() const { return AXSelection(); }
+    virtual AXSelection selectionUnderObject() const { return AXSelection(); }
 
     // Scrollable containers.
     bool isScrollableContainer() const;
     IntPoint scrollOffset() const;
     IntPoint minimumScrollOffset() const;
     IntPoint maximumScrollOffset() const;
     void setScrollOffset(const IntPoint&) const;
 
     // If this object itself scrolls, return its ScrollableArea.
     virtual ScrollableArea* getScrollableAreaIfScrollable() const { return 0; }
 
     // Modify or take an action on an object.
     virtual void increment() { }
     virtual void decrement() { }
     bool performDefaultAction() const { return press(); }
     virtual bool press() const;
     // Make this object visible by scrolling as many nested scrollable views as needed.
     void scrollToMakeVisible() const;
     // Same, but if the whole object can't be made visible, try for this subrect, in local coordinates.
     void scrollToMakeVisibleWithSubFocus(const IntRect&) const;
     // Scroll this object to a given point in global coordinates of the top-level window.
     void scrollToGlobalPoint(const IntPoint&) const;
     virtual void setFocused(bool) { }
     virtual void setSelected(bool) { }
     void setSelectedText(const String&) { }
-    virtual void setSelectedTextRange(const PlainTextRange&) { }
+    virtual void setSelection(const AXSelection&) { }

[dmazzoni, 2015/06/16 17:24:04]

Why is setSelection implemented here but not exposed in WebAXObject?

     virtual void setValue(const String&) { }
     virtual void setValue(float) { }
 
     // Notifications that this object may have changed.
     virtual void childrenChanged() { }
     virtual void handleActiveDescendantChanged() { }
     virtual void handleAriaExpandedChanged() { }
     void notifyIfIgnoredValueChanged();
     virtual void selectionChanged();
     virtual void textChanged() { }
@@ skipping 55 matching lines @@
     static bool includesARIAWidgetRole(const String&);
     static bool hasInteractiveARIAAttribute(const Element&);
 };
 
 #define DEFINE_AX_OBJECT_TYPE_CASTS(thisType, predicate) \
     DEFINE_TYPE_CASTS(thisType, AXObject, object, object->predicate, object.predicate)
 
 } // namespace blink
 
 #endif // AXObject_h