1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
// 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_
#define WEBKIT_GLUE_GLUE_ACCESSIBILITY_H_
#if defined(OS_WIN)
#include <oleacc.h>
#else
// TODO(port): need an equivalent of
// http://msdn.microsoft.com/en-us/library/accessibility.iaccessible.aspx
class IAccessible;
#endif
#include "base/hash_tables.h"
#include "base/ref_counted.h"
#include "chrome/common/accessibility.h"
class WebView;
template <typename T> class COMPtr;
typedef base::hash_map<int, scoped_refptr<IAccessible> > IntToIAccessibleMap;
typedef base::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 AccessibilityInParams& in_params,
AccessibilityOutParams* out_params);
// 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:
// 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);
// 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_
|