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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
// Copyright 2013 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_AX_NODE_DATA_H_
#define UI_ACCESSIBILITY_AX_NODE_DATA_H_
#include <stdint.h>
#include <map>
#include <string>
#include <vector>
#include "base/memory/scoped_ptr.h"
#include "base/strings/string16.h"
#include "base/strings/string_split.h"
#include "ui/accessibility/ax_enums.h"
#include "ui/accessibility/ax_export.h"
#include "ui/gfx/geometry/rect.h"
namespace gfx {
class Transform;
};
namespace ui {
// A compact representation of the accessibility information for a
// single accessible object, in a form that can be serialized and sent from
// one process to another.
struct AX_EXPORT AXNodeData {
AXNodeData();
virtual ~AXNodeData();
AXNodeData(const AXNodeData& other);
AXNodeData& operator=(AXNodeData other);
// 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(AXBoolAttribute attr) const;
bool GetBoolAttribute(AXBoolAttribute attr) const;
bool GetBoolAttribute(AXBoolAttribute attr, bool* value) const;
bool HasFloatAttribute(AXFloatAttribute attr) const;
float GetFloatAttribute(AXFloatAttribute attr) const;
bool GetFloatAttribute(AXFloatAttribute attr, float* value) const;
bool HasIntAttribute(AXIntAttribute attribute) const;
int GetIntAttribute(AXIntAttribute attribute) const;
bool GetIntAttribute(AXIntAttribute attribute, int* value) const;
bool HasStringAttribute(
AXStringAttribute attribute) const;
const std::string& GetStringAttribute(AXStringAttribute attribute) const;
bool GetStringAttribute(AXStringAttribute attribute,
std::string* value) const;
bool GetString16Attribute(AXStringAttribute attribute,
base::string16* value) const;
base::string16 GetString16Attribute(
AXStringAttribute attribute) const;
bool HasIntListAttribute(AXIntListAttribute attribute) const;
const std::vector<int32_t>& GetIntListAttribute(
AXIntListAttribute attribute) const;
bool GetIntListAttribute(AXIntListAttribute attribute,
std::vector<int32_t>* value) const;
bool GetHtmlAttribute(const char* attr, base::string16* value) const;
bool GetHtmlAttribute(const char* attr, std::string* value) const;
// Setting accessibility attributes.
void AddStringAttribute(AXStringAttribute attribute,
const std::string& value);
void AddIntAttribute(AXIntAttribute attribute, int value);
void AddFloatAttribute(AXFloatAttribute attribute, float value);
void AddBoolAttribute(AXBoolAttribute attribute, bool value);
void AddIntListAttribute(AXIntListAttribute attribute,
const std::vector<int32_t>& value);
// Convenience functions, mainly for writing unit tests.
// Equivalent to AddStringAttribute(ATTR_NAME, name).
void SetName(const std::string& name);
// Equivalent to AddStringAttribute(ATTR_VALUE, value).
void SetValue(const std::string& value);
// Return a string representation of this data, for debugging.
virtual std::string ToString() const;
bool IsRoot() const;
void SetRoot();
// As much as possible this should behave as a simple, serializable,
// copyable struct.
int32_t id;
AXRole role;
uint32_t state;
std::vector<std::pair<AXStringAttribute, std::string> > string_attributes;
std::vector<std::pair<AXIntAttribute, int32_t>> int_attributes;
std::vector<std::pair<AXFloatAttribute, float> > float_attributes;
std::vector<std::pair<AXBoolAttribute, bool> > bool_attributes;
std::vector<std::pair<AXIntListAttribute, std::vector<int32_t>>>
intlist_attributes;
base::StringPairs html_attributes;
std::vector<int32_t> child_ids;
// The object's location relative to its window or frame.
gfx::Rect location;
// An additional transform to apply to position this object and its subtree.
// NOTE: this member is a scoped_ptr because it's rare and gfx::Transform
// takes up a fair amount of space. The assignment operator and copy
// constructor both make a duplicate of the owned pointer, so it acts more
// like a member than a pointer.
scoped_ptr<gfx::Transform> transform;
};
} // namespace ui
#endif // UI_ACCESSIBILITY_AX_NODE_DATA_H_
|
