From ef02aa431fea724c15133e7d6f422c153a063010 Mon Sep 17 00:00:00 2001 From: ryanlwlin Date: Mon, 2 Mar 2020 14:34:36 +0800 Subject: [PATCH] Revise the javadoc and rename the constant Bug: 147804256 Test: The API Builds, there is no executable code here. Change-Id: I452f8bcbedb7422878a1cfc7245c33f6e38b57e3 --- api/current.txt | 2 +- .../view/accessibility/AccessibilityNodeInfo.java | 15 +++++++++------ 2 files changed, 10 insertions(+), 7 deletions(-) diff --git a/api/current.txt b/api/current.txt index c8a7956075579..899766d15a124 100644 --- a/api/current.txt +++ b/api/current.txt @@ -56012,7 +56012,7 @@ package android.view.accessibility { field public static final String ACTION_ARGUMENT_MOVEMENT_GRANULARITY_INT = "ACTION_ARGUMENT_MOVEMENT_GRANULARITY_INT"; field public static final String ACTION_ARGUMENT_MOVE_WINDOW_X = "ACTION_ARGUMENT_MOVE_WINDOW_X"; field public static final String ACTION_ARGUMENT_MOVE_WINDOW_Y = "ACTION_ARGUMENT_MOVE_WINDOW_Y"; - field public static final String ACTION_ARGUMENT_PRESS_HOLD_DURATION_MILLIS_INT = "android.view.accessibility.action.ARGUMENT_PRESS_HOLD_DURATION_MILLIS_INT"; + field public static final String ACTION_ARGUMENT_PRESS_AND_HOLD_DURATION_MILLIS_INT = "android.view.accessibility.action.ARGUMENT_PRESS_AND_HOLD_DURATION_MILLIS_INT"; field public static final String ACTION_ARGUMENT_PROGRESS_VALUE = "android.view.accessibility.action.ARGUMENT_PROGRESS_VALUE"; field public static final String ACTION_ARGUMENT_ROW_INT = "android.view.accessibility.action.ARGUMENT_ROW_INT"; field public static final String ACTION_ARGUMENT_SELECTION_END_INT = "ACTION_ARGUMENT_SELECTION_END_INT"; diff --git a/core/java/android/view/accessibility/AccessibilityNodeInfo.java b/core/java/android/view/accessibility/AccessibilityNodeInfo.java index eb4f9db39e3e9..1b6ef4a96c59f 100644 --- a/core/java/android/view/accessibility/AccessibilityNodeInfo.java +++ b/core/java/android/view/accessibility/AccessibilityNodeInfo.java @@ -552,8 +552,8 @@ public class AccessibilityNodeInfo implements Parcelable { * * @see AccessibilityAction#ACTION_PRESS_AND_HOLD */ - public static final String ACTION_ARGUMENT_PRESS_HOLD_DURATION_MILLIS_INT = - "android.view.accessibility.action.ARGUMENT_PRESS_HOLD_DURATION_MILLIS_INT"; + public static final String ACTION_ARGUMENT_PRESS_AND_HOLD_DURATION_MILLIS_INT = + "android.view.accessibility.action.ARGUMENT_PRESS_AND_HOLD_DURATION_MILLIS_INT"; /** * Argument to represent the IME action Id to press the returning key on a node. @@ -4912,10 +4912,13 @@ public class AccessibilityNodeInfo implements Parcelable { * held. Nodes having a single action for long press should use {@link #ACTION_LONG_CLICK} * instead of this action, and nodes should not expose both actions. *

- * Use {@link #ACTION_ARGUMENT_PRESS_HOLD_DURATION_MILLIS_INT} to specify how long the - * node is pressed. To ensure reasonable behavior, the first value of this argument should - * be 0 and the others should greater than 0 and less than 10,000. UIs requested to hold for - * times outside of this range should ignore the action. + * When calling {@code performAction(ACTION_PRESS_AND_HOLD, bundle}, use + * {@link #ACTION_ARGUMENT_PRESS_AND_HOLD_DURATION_MILLIS_INT} to specify how long the + * node is pressed. The first time an accessibility service performs ACTION_PRES_AND_HOLD + * on a node, it must specify 0 as ACTION_ARGUMENT_PRESS_AND_HOLD, so the application is + * notified that the held state has started. To ensure reasonable behavior, the values + * must be increased incrementally and may not exceed 10,000. UIs requested + * to hold for times outside of this range should ignore the action. *

* The total time the element is held could be specified by an accessibility user up-front, * or may depend on what happens on the UI as the user continues to request the hold.