Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Update Javadoc" into rvc-dev

Browse Source
This commit is contained in:
Jackal Guo
2020-03-05 01:11:23 +00:00
committed by Android (Google) Code Review
parent 52a8fc73dc fd2eab0067
commit 2d627ec8f3
2 changed files with 41 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
core/java/android/accessibilityservice/AccessibilityService.java
View File

@@ -48,6 +48,7 @@ import android.util.Slog;
import android.util.SparseArray;
import android.view.Display;
import android.view.KeyEvent;
import android.view.SurfaceView;
import android.view.WindowManager;
import android.view.WindowManagerImpl;
import android.view.accessibility.AccessibilityEvent;
@@ -1832,6 +1833,14 @@ public abstract class AccessibilityService extends Service {
* setting the {@link AccessibilityServiceInfo#FLAG_RETRIEVE_INTERACTIVE_WINDOWS}
* flag. Otherwise, the search will be performed only in the active window.
* </p>
* <p>
* <strong>Note:</strong> If the view with {@link AccessibilityNodeInfo#FOCUS_INPUT}
* is on an embedded view hierarchy which is embedded in a {@link SurfaceView} via
* {@link SurfaceView#setChildSurfacePackage}, there is a limitation that this API
* won't be able to find the node for the view. It's because views don't know about
* the embedded hierarchies. Instead, you could traverse all the nodes to find the
* focus.
* </p>
*
* @param focus The focus to find. One of {@link AccessibilityNodeInfo#FOCUS_INPUT} or
* {@link AccessibilityNodeInfo#FOCUS_ACCESSIBILITY}.

32
core/java/android/view/accessibility/AccessibilityNodeInfo.java
View File

@@ -52,6 +52,7 @@ import android.util.LongArray;
import android.util.Pools.SynchronizedPool;
import android.util.Size;
import android.util.TypedValue;
import android.view.SurfaceView;
import android.view.TouchDelegate;
import android.view.View;
import android.view.ViewGroup;
@@ -916,6 +917,15 @@ public class AccessibilityNodeInfo implements Parcelable {
* Find the view that has the specified focus type. The search starts from
* the view represented by this node info.
*
* <p>
* <strong>Note:</strong> If this view hierarchy has a {@link SurfaceView} embedding another
* view hierarchy via {@link SurfaceView#setChildSurfacePackage}, there is a limitation that
* this API won't be able to find the node for the view on the embedded view hierarchy. It's
* because views don't know about the embedded hierarchies. Instead, you could traverse all
* the children to find the node. Or, use {@link AccessibilityService#findFocus(int)} for
* {@link #FOCUS_ACCESSIBILITY} only since it has no such limitation.
* </p>
*
* @param focus The focus to find. One of {@link #FOCUS_INPUT} or
* {@link #FOCUS_ACCESSIBILITY}.
* @return The node info of the focused view or null.
@@ -937,6 +947,14 @@ public class AccessibilityNodeInfo implements Parcelable {
* Searches for the nearest view in the specified direction that can take
* the input focus.
*
* <p>
* <strong>Note:</strong> If this view hierarchy has a {@link SurfaceView} embedding another
* view hierarchy via {@link SurfaceView#setChildSurfacePackage}, there is a limitation that
* this API won't be able to find the node for the view in the specified direction on the
* embedded view hierarchy. It's because views don't know about the embedded hierarchies.
* Instead, you could traverse all the children to find the node.
* </p>
*
* @param direction The direction. Can be one of:
* {@link View#FOCUS_DOWN},
* {@link View#FOCUS_UP},
@@ -1723,6 +1741,13 @@ public class AccessibilityNodeInfo implements Parcelable {
* received info by calling {@link AccessibilityNodeInfo#recycle()}
* to avoid creating of multiple instances.
* </p>
* <p>
* <strong>Note:</strong> If this view hierarchy has a {@link SurfaceView} embedding another
* view hierarchy via {@link SurfaceView#setChildSurfacePackage}, there is a limitation that
* this API won't be able to find the node for the view on the embedded view hierarchy. It's
* because views don't know about the embedded hierarchies. Instead, you could traverse all
* the children to find the node.
* </p>
*
* @param text The searched text.
* @return A list of node info.
@@ -1754,6 +1779,13 @@ public class AccessibilityNodeInfo implements Parcelable {
* the client has to set the {@link AccessibilityServiceInfo#FLAG_REPORT_VIEW_IDS}
* flag when configuring his {@link android.accessibilityservice.AccessibilityService}.
* </p>
* <p>
* <strong>Note:</strong> If this view hierarchy has a {@link SurfaceView} embedding another
* view hierarchy via {@link SurfaceView#setChildSurfacePackage}, there is a limitation that
* this API won't be able to find the node for the view on the embedded view hierarchy. It's
* because views don't know about the embedded hierarchies. Instead, you could traverse all
* the children to find the node.
* </p>
*
* @param viewId The fully qualified resource name of the view id to find.
* @return A list of node info.