Adds MSAA/IAccessible exposure of web content.

webkit/glue/glue_accessibility.h

+// Copyright (c) 2006-2008 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 WEBKIT_GLUE_GLUE_ACCESSIBILITY_H_

[pink (ping after 24hrs), 2008/09/30 13:10:10]

drive-by comment....

how about naming this glue_accessibility_win, since it's very windows specific?
Or is the intent to refactor/ifdef this header when we figure our our mac/linux
story? 

+#define WEBKIT_GLUE_GLUE_ACCESSIBILITY_H_
+
+#include <oleacc.h>
+#include <hash_map>
+
+#include "chrome/common/render_messages.h"
+
+class WebView;
+
+typedef stdext::hash_map<int, IAccessible*> IntToIAccessibleMap;
+typedef stdext::hash_map<IAccessible*, int> IAccessibleToIntMap;
+
+////////////////////////////////////////////////////////////////////////////////
+//
+// GlueAccessibility
+//
+// Operations that access the underlying WebKit DOM directly, exposing
+// accessibility information.
+////////////////////////////////////////////////////////////////////////////////
+class GlueAccessibility {
+ public:
+  GlueAccessibility();
+  ~GlueAccessibility();
+
+  // Retrieves the IAccessible information as requested in in_params, by calling
+  // into WebKit's implementation of IAccessible. Maintains a hashmap of the
+  // currently active (browser ref count not zero) IAccessibles. Returns true if
+  // successful, false otherwise.
+  bool GetAccessibilityInfo(WebView* view,
+                            const ViewMsg_Accessibility_In_Params& in_params,
+                            ViewHostMsg_Accessibility_Out_Params* out_params);
+
+  // Retrieves the RenderObject associated with this WebView, and uses it to
+  // initialize the root of the render-side MSAA tree with the associated
+  // accessibility information. Returns true if successful, false otherwise.
+  bool InitAccessibilityRoot(WebView* view);
+
+  // Erases the entry identified by the |iaccessible_id| from the hash map. If
+  // |clear_all| is true, all entries are erased. Returns true if successful,
+  // false otherwise.
+  bool ClearIAccessibleMap(int iaccessible_id, bool clear_all);
+
+ private:
+  // Wrapper around the COM pointer that holds the root of the MSAA tree, to
+  // ensure that we are not requiring WebKit includes outside of glue.
+  struct GlueAccessibilityRoot;
+  GlueAccessibilityRoot* root_;
+
+  // Hashmap for cashing of elements in use by the AT, mapping id (int) to an
+  // IAccessible pointer.
+  IntToIAccessibleMap int_to_iaccessible_map_;
+  // Hashmap for cashing of elements in use by the AT, mapping an IAccessible
+  // pointer to its id (int). Needed for reverse lookup, to ensure unnecessary
+  // duplicate entries are not created in the IntToIAccessibleMap (above).
+  IAccessibleToIntMap iaccessible_to_int_map_;
+
+  // Unique identifier for retrieving an IAccessible from the page's hashmap.
+  int iaccessible_id_;
+
+  DISALLOW_COPY_AND_ASSIGN(GlueAccessibility);
+};
+
+#endif  // WEBKIT_GLUE_GLUE_ACCESSIBILITY_H_