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
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
|
/*
* Copyright (C) 2011 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package android.support.v4.view.accessibility;
import android.os.Build;
import android.view.accessibility.AccessibilityEvent;
/**
* Helper for accessing features in {@link AccessibilityEvent}
* introduced after API level 4 in a backwards compatible fashion.
*/
public class AccessibilityEventCompat {
static interface AccessibilityEventVersionImpl {
public int getRecordCount(AccessibilityEvent event);
public void appendRecord(AccessibilityEvent event, Object record);
public Object getRecord(AccessibilityEvent event, int index);
}
static class AccessibilityEventStubImpl implements AccessibilityEventVersionImpl {
@Override
public void appendRecord(AccessibilityEvent event, Object record) {
return;
}
@Override
public Object getRecord(AccessibilityEvent event, int index) {
return null;
}
@Override
public int getRecordCount(AccessibilityEvent event) {
return 0;
}
}
static class AccessibilityEventIcsImpl extends AccessibilityEventStubImpl {
@Override
public void appendRecord(AccessibilityEvent event, Object record) {
AccessibilityEventCompatIcs.appendRecord(event, record);
}
@Override
public Object getRecord(AccessibilityEvent event, int index) {
return AccessibilityEventCompatIcs.getRecord(event, index);
}
@Override
public int getRecordCount(AccessibilityEvent event) {
return AccessibilityEventCompatIcs.getRecordCount(event);
}
}
private final static AccessibilityEventVersionImpl IMPL;
static {
if (Build.VERSION.SDK_INT >= 14) { // ICS
IMPL = new AccessibilityEventIcsImpl();
} else {
IMPL = new AccessibilityEventStubImpl();
}
}
/**
* Represents the event of a hover enter over a {@link android.view.View}.
*/
public static final int TYPE_VIEW_HOVER_ENTER = 0x00000080;
/**
* Represents the event of a hover exit over a {@link android.view.View}.
*/
public static final int TYPE_VIEW_HOVER_EXIT = 0x00000100;
/**
* Represents the event of starting a touch exploration gesture.
*/
public static final int TYPE_TOUCH_EXPLORATION_GESTURE_START = 0x00000200;
/**
* Represents the event of ending a touch exploration gesture.
*/
public static final int TYPE_TOUCH_EXPLORATION_GESTURE_END = 0x00000400;
/**
* Represents the event of changing the content of a window.
*/
public static final int TYPE_WINDOW_CONTENT_CHANGED = 0x00000800;
/**
* Represents the event of scrolling a view.
*/
public static final int TYPE_VIEW_SCROLLED = 0x00001000;
/**
* Represents the event of changing the selection in an {@link android.widget.EditText}.
*/
public static final int TYPE_VIEW_TEXT_SELECTION_CHANGED = 0x00002000;
/**
* Represents the event of an application making an announcement.
*/
public static final int TYPE_ANNOUNCEMENT = 0x00004000;
/**
* Represents the event of gaining accessibility focus.
*/
public static final int TYPE_VIEW_ACCESSIBILITY_FOCUSED = 0x00008000;
/**
* Represents the event of clearing accessibility focus.
*/
public static final int TYPE_VIEW_ACCESSIBILITY_FOCUS_CLEARED = 0x00010000;
/**
* Represents the event of traversing the text of a view at a given movement granularity.
*/
public static final int TYPE_VIEW_TEXT_TRAVERSED_AT_MOVEMENT_GRANULARITY = 0x00020000;
/**
* Represents the event of beginning gesture detection.
*/
public static final int TYPE_GESTURE_DETECTION_START = 0x00040000;
/**
* Represents the event of ending gesture detection.
*/
public static final int TYPE_GESTURE_DETECTION_END = 0x00080000;
/**
* Represents the event of the user starting to touch the screen.
*/
public static final int TYPE_TOUCH_INTERACTION_START = 0x00100000;
/**
* Represents the event of the user ending to touch the screen.
*/
public static final int TYPE_TOUCH_INTERACTION_END = 0x00200000;
/**
* Mask for {@link AccessibilityEvent} all types.
*
* @see AccessibilityEvent#TYPE_VIEW_CLICKED
* @see AccessibilityEvent#TYPE_VIEW_LONG_CLICKED
* @see AccessibilityEvent#TYPE_VIEW_SELECTED
* @see AccessibilityEvent#TYPE_VIEW_FOCUSED
* @see AccessibilityEvent#TYPE_VIEW_TEXT_CHANGED
* @see AccessibilityEvent#TYPE_WINDOW_STATE_CHANGED
* @see AccessibilityEvent#TYPE_NOTIFICATION_STATE_CHANGED
* @see #TYPE_VIEW_HOVER_ENTER
* @see #TYPE_VIEW_HOVER_EXIT
* @see #TYPE_TOUCH_EXPLORATION_GESTURE_START
* @see #TYPE_TOUCH_EXPLORATION_GESTURE_END
* @see #TYPE_WINDOW_CONTENT_CHANGED
* @see #TYPE_VIEW_SCROLLED
* @see #TYPE_VIEW_TEXT_SELECTION_CHANGED
* @see #TYPE_ANNOUNCEMENT
* @see #TYPE_VIEW_TEXT_TRAVERSED_AT_MOVEMENT_GRANULARITY
* @see #TYPE_GESTURE_DETECTION_START
* @see #TYPE_GESTURE_DETECTION_END
* @see #TYPE_TOUCH_INTERACTION_START
* @see #TYPE_TOUCH_INTERACTION_END
*/
public static final int TYPES_ALL_MASK = 0xFFFFFFFF;
/*
* Hide constructor from clients.
*/
private AccessibilityEventCompat() {
}
/**
* Gets the number of records contained in the event.
*
* @return The number of records.
*/
public static int getRecordCount(AccessibilityEvent event) {
return IMPL.getRecordCount(event);
}
/**
* Appends an {@link android.view.accessibility.AccessibilityRecord} to the end of
* event records.
*
* @param record The record to append.
*
* @throws IllegalStateException If called from an AccessibilityService.
*/
@SuppressWarnings("deprecation")
public static void appendRecord(AccessibilityEvent event, AccessibilityRecordCompat record) {
IMPL.appendRecord(event, record.getImpl());
}
/**
* Gets the record at a given index.
*
* @param index The index.
* @return The record at the specified index.
*/
@SuppressWarnings("deprecation")
public static AccessibilityRecordCompat getRecord(AccessibilityEvent event, int index) {
return new AccessibilityRecordCompat(IMPL.getRecord(event, index));
}
/**
* Creates an {@link AccessibilityRecordCompat} from an {@link AccessibilityEvent}
* that can be used to manipulate the event properties defined in
* {@link android.view.accessibility.AccessibilityRecord}.
* <p>
* <strong>Note:</strong> Do not call {@link AccessibilityRecordCompat#recycle()} on the
* returned {@link AccessibilityRecordCompat}. Call {@link AccessibilityEvent#recycle()}
* in case you want to recycle the event.
* </p>
*
* @param event The from which to create a record.
* @return An {@link AccessibilityRecordCompat}.
*/
@SuppressWarnings("deprecation")
public static AccessibilityRecordCompat asRecord(AccessibilityEvent event) {
return new AccessibilityRecordCompat(event);
}
}
|
