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
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
// Copyright 2012 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef UI_ACCESSIBILITY_PLATFORM_INSPECT_AX_INSPECT_UTILS_WIN_H_
#define UI_ACCESSIBILITY_PLATFORM_INSPECT_AX_INSPECT_UTILS_WIN_H_
#include <stdint.h>
#include <wtypes.h>
#include <string>
#include <vector>
#include <oleacc.h>
#include <wrl/client.h>
#include "base/component_export.h"
#include "base/memory/raw_ptr.h"
#include "base/process/process_handle.h"
#include "base/win/scoped_variant.h"
#include "third_party/iaccessible2/ia2_api_all.h"
#include "third_party/isimpledom/ISimpleDOMNode.h"
#include "ui/gfx/win/hwnd_util.h"
namespace ui {
struct AXTreeSelector;
COMPONENT_EXPORT(AX_PLATFORM)
std::wstring IAccessibleRoleToString(int32_t ia_role);
COMPONENT_EXPORT(AX_PLATFORM)
std::wstring IAccessible2RoleToString(int32_t ia_role);
COMPONENT_EXPORT(AX_PLATFORM)
std::wstring IAccessibleStateToString(int32_t ia_state);
COMPONENT_EXPORT(AX_PLATFORM)
void IAccessibleStateToStringVector(int32_t ia_state,
std::vector<std::wstring>* result);
COMPONENT_EXPORT(AX_PLATFORM)
std::wstring IAccessible2StateToString(int32_t ia2_state);
COMPONENT_EXPORT(AX_PLATFORM)
void IAccessible2StateToStringVector(int32_t ia_state,
std::vector<std::wstring>* result);
// Handles both IAccessible/MSAA events and IAccessible2 events.
COMPONENT_EXPORT(AX_PLATFORM)
std::wstring AccessibilityEventToString(int32_t event_id);
COMPONENT_EXPORT(AX_PLATFORM)
std::wstring UiaIdentifierToString(int32_t identifier);
COMPONENT_EXPORT(AX_PLATFORM)
std::wstring UiaOrientationToString(int32_t identifier);
COMPONENT_EXPORT(AX_PLATFORM)
std::wstring UiaLiveSettingToString(int32_t identifier);
COMPONENT_EXPORT(AX_PLATFORM) std::string BstrToUTF8(BSTR bstr);
COMPONENT_EXPORT(AX_PLATFORM) std::string UiaIdentifierToStringUTF8(int32_t id);
COMPONENT_EXPORT(AX_PLATFORM) HWND GetHwndForProcess(base::ProcessId pid);
// Returns HWND of window matching a given tree selector.
COMPONENT_EXPORT(AX_PLATFORM)
HWND GetHWNDBySelector(const AXTreeSelector& selector);
COMPONENT_EXPORT(AX_PLATFORM)
std::u16string RoleVariantToU16String(const base::win::ScopedVariant& role);
COMPONENT_EXPORT(AX_PLATFORM)
std::string RoleVariantToString(const base::win::ScopedVariant& role);
COMPONENT_EXPORT(AX_PLATFORM)
std::optional<std::string> GetIAccessible2Attribute(
Microsoft::WRL::ComPtr<IAccessible2> element,
std::string attribute);
COMPONENT_EXPORT(AX_PLATFORM)
std::string GetDOMId(Microsoft::WRL::ComPtr<IAccessible> element);
COMPONENT_EXPORT(AX_PLATFORM)
std::vector<Microsoft::WRL::ComPtr<IAccessible>> IAccessibleChildrenOf(
Microsoft::WRL::ComPtr<IAccessible> parent);
// Returns IA2 Interfaces
template <typename ServiceType>
HRESULT IA2QueryInterface(IUnknown* accessible, ServiceType** out_accessible) {
// IA2 Spec dictates that IServiceProvider should be used instead of
// QueryInterface when retrieving IAccessible2.
Microsoft::WRL::ComPtr<IServiceProvider> service_provider;
HRESULT hr = accessible->QueryInterface(IID_PPV_ARGS(&service_provider));
if (FAILED(hr))
return hr;
return service_provider->QueryService(__uuidof(ServiceType), out_accessible);
}
// Represent MSAA child, either as IAccessible object or as VARIANT.
class COMPONENT_EXPORT(AX_PLATFORM) MSAAChild final {
public:
MSAAChild();
MSAAChild(IAccessible* parent, VARIANT&& child);
MSAAChild(MSAAChild&&);
~MSAAChild();
MSAAChild& operator=(MSAAChild&& rhs) = default;
IAccessible* AsIAccessible() const { return child_.Get(); }
const base::win::ScopedVariant& AsVariant() const { return child_variant_; }
IAccessible* Parent() const { return parent_.Get(); }
private:
Microsoft::WRL::ComPtr<IAccessible> parent_;
Microsoft::WRL::ComPtr<IAccessible> child_;
base::win::ScopedVariant child_variant_;
};
// Represents MSAA children of an IAccessible object.
class COMPONENT_EXPORT(AX_PLATFORM) MSAAChildren final {
public:
MSAAChildren(IAccessible* parent);
MSAAChildren(const Microsoft::WRL::ComPtr<IAccessible>& parent);
~MSAAChildren();
const MSAAChild& ChildAt(LONG index) const { return children_[index]; }
IAccessible* Parent() const { return parent_.Get(); }
class COMPONENT_EXPORT(AX_PLATFORM) Iterator final {
public:
using iterator_category = std::input_iterator_tag;
using value_type = MSAAChild;
using difference_type = std::ptrdiff_t;
using pointer = MSAAChild*;
using reference = MSAAChild&;
Iterator(MSAAChildren*);
Iterator(MSAAChildren*, LONG);
Iterator(const Iterator&);
~Iterator();
Iterator& operator++() {
++index_;
return *this;
}
Iterator operator++(int) {
Iterator tmp(*this);
operator++();
return tmp;
}
friend bool operator==(const Iterator&, const Iterator&) = default;
const MSAAChild& operator*() { return children_->ChildAt(index_); }
private:
LONG index_{0};
raw_ptr<MSAAChildren> children_{nullptr};
};
Iterator begin() { return {this}; }
Iterator end() { return {this, count_}; }
private:
LONG count_{-1};
Microsoft::WRL::ComPtr<IAccessible> parent_{nullptr};
std::vector<MSAAChild> children_;
};
} // namespace ui
#endif // UI_ACCESSIBILITY_PLATFORM_INSPECT_AX_INSPECT_UTILS_WIN_H_
|
