MacViews: Accessibility bridge

ui/accessibility/platform/ax_platform_node.h

 // Copyright 2014 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 UI_ACCESSIBILITY_PLATFORM_AX_PLATFORM_NODE_H_
 #define UI_ACCESSIBILITY_PLATFORM_AX_PLATFORM_NODE_H_
 
+#include "ui/accessibility/ax_enums.h"
 #include "ui/accessibility/ax_export.h"
-#include "ui/accessibility/ax_node_data.h"
+#include "ui/gfx/geometry/rect.h"
 #include "ui/gfx/native_widget_types.h"
 
 namespace ui {
 
 class AXPlatformNodeDelegate;
 
 class AX_EXPORT AXPlatformNode {
  public:
   static AXPlatformNode* Create(AXPlatformNodeDelegate* delegate);
   virtual ~AXPlatformNode();
   virtual void Detach();
 
-  virtual gfx::NativeViewAccessible GetNativeViewAccessible();
+  virtual gfx::NativeViewAccessible GetNativeViewAccessible() = 0;
 
-  AXPlatformNode* NextSibling();
-  AXPlatformNode* PreviousSibling();
+  AXRole GetRole() const;

[dmazzoni, 2014/07/29 06:35:14]

I don't want these to be part of the public interface that's possible to call
from outside of ui/accessibility/platform.

If this was all C++ code these could be protected or we could use friends - but
since you need to call these from the Cocoa object I think it's best to define
AXPlatformNodeBase and put the helpers there. That way AXPlatformNode is really
simple and only contains the public interface.

+  gfx::Rect GetBoundsInScreen() const;
+
+  // Get the parent of the node unless it's the root, then it returns NULL.
+  gfx::NativeViewAccessible GetParent();
+
+  // Get the number of children of this node.
+  int GetChildCount();
+
+  // Get the child of a node from [0...GetChildCount() - 1]
+  gfx::NativeViewAccessible ChildAtIndex(int index);
 
  protected:
   AXPlatformNode();
-
   virtual void Init(AXPlatformNodeDelegate* delegate);
 
-  bool IsAncestor
-
-  // 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
-  // in sparse arrays of <attribute id, attribute value> pairs, organized
-  // by type (bool, int, float, string, int list).
-  //
-  // There are three accessors for each type of attribute: one that returns
-  // true if the attribute is present and false if not, one that takes a
-  // pointer argument and returns true if the attribute is present (if you
-  // need to distinguish between the default value and a missing attribute),
-  // and another that returns the default value for that type if the
-  // attribute is not present. In addition, strings can be returned as
-  // either std::string or base::string16, for convenience.
-
-  bool HasBoolAttribute(ui::AXBoolAttribute attr) const;
-  bool GetBoolAttribute(ui::AXBoolAttribute attr) const;
-  bool GetBoolAttribute(ui::AXBoolAttribute attr, bool* value) const;
-
-  bool HasFloatAttribute(ui::AXFloatAttribute attr) const;
-  float GetFloatAttribute(ui::AXFloatAttribute attr) const;
-  bool GetFloatAttribute(ui::AXFloatAttribute attr, float* value) const;
-
-  bool HasIntAttribute(ui::AXIntAttribute attribute) const;
-  int GetIntAttribute(ui::AXIntAttribute attribute) const;
-  bool GetIntAttribute(ui::AXIntAttribute attribute, int* value) const;
-
-  bool HasStringAttribute(
-      ui::AXStringAttribute attribute) const;
-  const std::string& GetStringAttribute(ui::AXStringAttribute attribute) const;
-  bool GetStringAttribute(ui::AXStringAttribute attribute,
-                          std::string* value) const;
-
-  bool GetString16Attribute(ui::AXStringAttribute attribute,
-                            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;
-
-  // 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;
-
   AXPlatformNodeDelegate* delegate_;
 };
 
 }  // namespace ui
 
 #endif  // UI_ACCESSIBILITY_PLATFORM_AX_PLATFORM_NODE_H_