Re-land: Send Windows accessibility events based on tree updates.

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 38 matching lines @@
 
   virtual ~BrowserAccessibility();
 
   // Called only once, immediately after construction. The constructor doesn't
   // take any arguments because in the Windows subclass we use a special
   // function to construct a COM object.
   virtual void Init(BrowserAccessibilityManager* manager, ui::AXNode* node);
 
   // Called after the object is first initialized and again every time
   // its data changes.
-  virtual void OnDataChanged();
+  virtual void OnDataChanged() {}
 
   // Called after an atomic update to the tree finished and this object
   // was created or changed in this update.
   virtual void OnUpdateFinished() {}
 
-  // Returns true if this is a native platform-specific object, vs a
-  // cross-platform generic object.
-  virtual bool IsNative() const;
+  virtual void OnSubtreeWillBeDeleted() {}
+
+  virtual void OnSubtreeCreationFinished() {}
 
   // Called when the location changed.
   virtual void OnLocationChanged() {}
 
   // Return true if this object is equal to or a descendant of |ancestor|.
   bool IsDescendantOf(BrowserAccessibility* ancestor);
 
   // Returns true if this is a leaf node on this platform, meaning any
   // children should not be exposed to this platform's native accessibility
   // layer. Each platform subclass should implement this itself.
   // The definition of a leaf may vary depending on the platform,
   // but a leaf node should never have children that are focusable or
   // that might send notifications.
   virtual bool PlatformIsLeaf() const;
 
   // Returns the number of children of this object, or 0 if PlatformIsLeaf()
   // returns true.
   uint32 PlatformChildCount() const;
 
   // Return a pointer to the child at the given index, or NULL for an
   // invalid index. Returns NULL if PlatformIsLeaf() returns true.
   BrowserAccessibility* PlatformGetChild(uint32 child_index) const;
 
+  // Returns true if an ancestor of this node (not including itself) is a
+  // leaf node, meaning that this node is not actually exposed to the
+  // platform.
+  bool PlatformIsChildOfLeaf() const;
+
   // Return the previous sibling of this object, or NULL if it's the first
   // child of its parent.
   BrowserAccessibility* GetPreviousSibling();
 
   // Return the next sibling of this object, or NULL if it's the last child
   // of its parent.
   BrowserAccessibility* GetNextSibling();
 
   // Returns the bounds of this object in coordinates relative to the
   // top-left corner of the overall web area.
@@ skipping 32 matching lines @@
   // Subclasses should override this to support platform reference counting.
   virtual void NativeReleaseReference();
 
   //
   // Accessors
   //
 
   BrowserAccessibilityManager* manager() const { return manager_; }
   bool instance_active() const { return node_ != NULL; }
   ui::AXNode* node() const { return node_; }
-  const std::string& name() const { return name_; }
-  const std::string& value() const { return value_; }
-  void set_name(const std::string& name) { name_ = name; }
-  void set_value(const std::string& value) { value_ = value; }
 
   // These access the internal accessibility tree, which doesn't necessarily
   // reflect the accessibility tree that should be exposed on each platform.
   // Use PlatformChildCount and PlatformGetChild to implement platform
   // accessibility APIs.
   uint32 InternalChildCount() const;
   BrowserAccessibility* InternalGetChild(uint32 child_index) const;
 
   BrowserAccessibility* GetParent() const;
   int32 GetIndexInParent() const;
 
   int32 GetId() const;
   const ui::AXNodeData& GetData() const;
   gfx::Rect GetLocation() const;
   int32 GetRole() const;
   int32 GetState() const;
 
   typedef base::StringPairs HtmlAttributes;
   const HtmlAttributes& GetHtmlAttributes() const;
 
+
+  // Returns true if this is a native platform-specific object, vs a
+  // cross-platform generic object. Don't call ToBrowserAccessibilityXXX if
+  // IsNative returns false.
+  virtual bool IsNative() const;
+
 #if defined(OS_MACOSX) && __OBJC__
   BrowserAccessibilityCocoa* ToBrowserAccessibilityCocoa();
 #elif defined(OS_WIN)
   BrowserAccessibilityWin* ToBrowserAccessibilityWin();
 #endif
 
   // Accessing accessibility attributes:
   //
   // There are dozens of possible attributes for an accessibility node,
   // but only a few tend to apply to any one object, so we store them
@@ skipping 30 matching lines @@
                             base::string16* value) const;
   base::string16 GetString16Attribute(
       ui::AXStringAttribute attribute) const;
 
   bool HasIntListAttribute(ui::AXIntListAttribute attribute) const;
   const std::vector<int32>& GetIntListAttribute(
       ui::AXIntListAttribute attribute) const;
   bool GetIntListAttribute(ui::AXIntListAttribute attribute,
                            std::vector<int32>* value) const;
 
-  void SetStringAttribute(ui::AXStringAttribute attribute,
-                          const std::string& value);
-
   // Retrieve the value of a html attribute from the attribute map and
   // returns true if found.
   bool GetHtmlAttribute(const char* attr, base::string16* value) const;
   bool GetHtmlAttribute(const char* attr, std::string* value) const;
 
   // Utility method to handle special cases for ARIA booleans, tristates and
   // booleans which have a "mixed" state.
   //
   // Warning: the term "Tristate" is used loosely by the spec and here,
   // as some attributes support a 4th state.
@@ skipping 13 matching lines @@
 
   // Returns true if this node is an cell or an table header.
   bool IsCellOrTableHeaderRole() const;
 
   // Returns true if this node is an editable text field of any kind.
   bool IsEditableText() const;
 
   // True if this is a web area, and its grandparent is a presentational iframe.
   bool IsWebAreaForPresentationalIframe() const;
 
-  // Append the text from this node and its children.
-  std::string GetTextRecursive() const;
-
  protected:
   BrowserAccessibility();
 
   // The manager of this tree of accessibility objects.
   BrowserAccessibilityManager* manager_;
 
   // The underlying node.
   ui::AXNode* node_;
 
  private:
   // Return the sum of the lengths of all static text descendants,
   // including this object if it's static text.
   int GetStaticTextLenRecursive() const;
 
   // Similar to GetParent(), but includes nodes that are the host of a
   // subtree rather than skipping over them - because they contain important
   // bounds offsets.
   BrowserAccessibility* GetParentForBoundsCalculation() const;
 
-  std::string name_;
-  std::string value_;
-
   DISALLOW_COPY_AND_ASSIGN(BrowserAccessibility);
 };
 
 }  // namespace content
 
 #endif  // CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_H_