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
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
|
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=2 et sw=2 tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this file,
* You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef mozilla_a11y_uiaRawElmProvider_h__
#define mozilla_a11y_uiaRawElmProvider_h__
#include <objbase.h>
#include <stdint.h>
#include <uiautomation.h>
#include <initializer_list>
#include "nsString.h"
template <class T>
class nsTArray;
template <class T>
class RefPtr;
namespace mozilla {
namespace a11y {
class Accessible;
enum class RelationType;
/**
* IRawElementProviderSimple implementation (maintains IAccessibleEx approach).
*/
class uiaRawElmProvider : public IAccessibleEx,
public IRawElementProviderSimple,
public IRawElementProviderFragment,
public IInvokeProvider,
public IToggleProvider,
public IExpandCollapseProvider,
public IScrollItemProvider,
public IValueProvider,
public IRangeValueProvider,
public ISelectionProvider,
public ISelectionItemProvider {
public:
static constexpr enum ProviderOptions kProviderOptions =
static_cast<enum ProviderOptions>(ProviderOptions_ServerSideProvider |
ProviderOptions_UseComThreading |
ProviderOptions_HasNativeIAccessible);
static void RaiseUiaEventForGeckoEvent(Accessible* aAcc,
uint32_t aGeckoEvent);
static void RaiseUiaEventForStateChange(Accessible* aAcc, uint64_t aState,
bool aEnabled);
// IUnknown
STDMETHODIMP QueryInterface(REFIID aIid, void** aInterface);
// IAccessibleEx
virtual HRESULT STDMETHODCALLTYPE GetObjectForChild(
/* [in] */ long aIdChild,
/* [retval][out] */ __RPC__deref_out_opt IAccessibleEx** aAccEx);
virtual HRESULT STDMETHODCALLTYPE GetIAccessiblePair(
/* [out] */ __RPC__deref_out_opt IAccessible** aAcc,
/* [out] */ __RPC__out long* aIdChild);
virtual HRESULT STDMETHODCALLTYPE GetRuntimeId(
/* [retval][out] */ __RPC__deref_out_opt SAFEARRAY** aRuntimeIds);
virtual HRESULT STDMETHODCALLTYPE ConvertReturnedElement(
/* [in] */ __RPC__in_opt IRawElementProviderSimple* aRawElmProvider,
/* [out] */ __RPC__deref_out_opt IAccessibleEx** aAccEx);
// IRawElementProviderSimple
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_ProviderOptions(
/* [retval][out] */ __RPC__out enum ProviderOptions* aProviderOptions);
virtual HRESULT STDMETHODCALLTYPE GetPatternProvider(
/* [in] */ PATTERNID aPatternId,
/* [retval][out] */ __RPC__deref_out_opt IUnknown** aPatternProvider);
virtual HRESULT STDMETHODCALLTYPE GetPropertyValue(
/* [in] */ PROPERTYID aPropertyId,
/* [retval][out] */ __RPC__out VARIANT* aPropertyValue);
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_HostRawElementProvider(
/* [retval][out] */ __RPC__deref_out_opt IRawElementProviderSimple**
aRawElmProvider);
// IRawElementProviderFragment
virtual HRESULT STDMETHODCALLTYPE Navigate(
/* [in] */ enum NavigateDirection aDirection,
/* [retval][out] */ __RPC__deref_out_opt IRawElementProviderFragment**
aRetVal);
// GetRuntimeId is shared with IAccessibleEx.
virtual HRESULT STDMETHODCALLTYPE get_BoundingRectangle(
/* [retval][out] */ __RPC__out struct UiaRect* aRetVal);
virtual HRESULT STDMETHODCALLTYPE GetEmbeddedFragmentRoots(
/* [retval][out] */ __RPC__deref_out_opt SAFEARRAY** aRetVal);
virtual HRESULT STDMETHODCALLTYPE SetFocus(void);
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_FragmentRoot(
/* [retval][out] */ __RPC__deref_out_opt IRawElementProviderFragmentRoot**
aRetVal);
// IInvokeProvider
virtual HRESULT STDMETHODCALLTYPE Invoke(void);
// IToggleProvider
virtual HRESULT STDMETHODCALLTYPE Toggle(void);
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_ToggleState(
/* [retval][out] */ __RPC__out enum ToggleState* aRetVal);
// IExpandCollapseProvider
virtual HRESULT STDMETHODCALLTYPE Expand(void);
virtual HRESULT STDMETHODCALLTYPE Collapse(void);
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_ExpandCollapseState(
/* [retval][out] */ __RPC__out enum ExpandCollapseState* aRetVal);
// IScrollItemProvider
virtual HRESULT STDMETHODCALLTYPE ScrollIntoView(void);
// IValueProvider
virtual HRESULT STDMETHODCALLTYPE SetValue(
/* [in] */ __RPC__in LPCWSTR val);
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_Value(
/* [retval][out] */ __RPC__deref_out_opt BSTR* pRetVal);
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_IsReadOnly(
/* [retval][out] */ __RPC__out BOOL* pRetVal);
// IRangeValueProvider
virtual HRESULT STDMETHODCALLTYPE SetValue(
/* [in] */ double aVal);
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_Value(
/* [retval][out] */ __RPC__out double* aRetVal);
// get_IsReadOnly is shared with IValueProvider.
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_Maximum(
/* [retval][out] */ __RPC__out double* aRetVal);
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_Minimum(
/* [retval][out] */ __RPC__out double* aRetVal);
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_LargeChange(
/* [retval][out] */ __RPC__out double* aRetVal);
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_SmallChange(
/* [retval][out] */ __RPC__out double* aRetVal);
// ISelectionProvider
virtual HRESULT STDMETHODCALLTYPE GetSelection(
/* [retval][out] */ __RPC__deref_out_opt SAFEARRAY** aRetVal);
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_CanSelectMultiple(
/* [retval][out] */ __RPC__out BOOL* aRetVal);
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_IsSelectionRequired(
/* [retval][out] */ __RPC__out BOOL* aRetVal);
// ISelectionItemProvider methods
virtual HRESULT STDMETHODCALLTYPE Select(void);
virtual HRESULT STDMETHODCALLTYPE AddToSelection(void);
virtual HRESULT STDMETHODCALLTYPE RemoveFromSelection(void);
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_IsSelected(
/* [retval][out] */ __RPC__out BOOL* aRetVal);
virtual /* [propget] */ HRESULT STDMETHODCALLTYPE get_SelectionContainer(
/* [retval][out] */ __RPC__deref_out_opt IRawElementProviderSimple**
aRetVal);
private:
Accessible* Acc() const;
bool IsControl();
long GetControlType() const;
bool HasTogglePattern();
bool HasExpandCollapsePattern();
bool HasValuePattern() const;
template <class Derived, class Interface>
RefPtr<Interface> GetPatternFromDerived();
bool HasSelectionItemPattern();
SAFEARRAY* AccRelationsToUiaArray(
std::initializer_list<RelationType> aTypes) const;
Accessible* GetLabeledBy() const;
long GetLandmarkType() const;
void GetLocalizedLandmarkType(nsAString& aLocalized) const;
};
SAFEARRAY* AccessibleArrayToUiaArray(const nsTArray<Accessible*>& aAccs);
} // namespace a11y
} // namespace mozilla
#endif
|
